V2.5 Remove Device from Device Group¶
将设备从设备组中移除。
请求格式¶
POST https://{apigw-address}/connect-service/v2.5/deviceGroups?action=removeDeviceFromDeviceGroup
请求参数(URI)¶
名称 | 位置(Path/Query) | 必需/可选 | 数据类型 | 描述 |
---|---|---|---|---|
orgId | Query | 必需 | String | 资产所属的组织ID。 如何获取orgId信息>> |
请求参数(Body)¶
名称 | 必需/可选 | 数据类型 | 描述 |
---|---|---|---|
groupId | 必需 | String | 设备组ID |
deviceIdentifier | 必需 | 结构体 | 参见 DeviceIdentifier 结构体。 |
DeviceIdentifier 结构体 ¶
名称 | 数据类型 | 描述 |
---|---|---|
assetId | String | 资产 ID。 如何获取Asset ID信息>> |
productKey | String | Product Key。 |
deviceKey | String | Device Key。 |
响应参数¶
名称 | 数据类型 | 描述 |
---|---|---|
code | Number | 响应码 |
msg | String | 对状态码的解释和说明。请求成功为 “OK”。 |
requestId | String | 每次请求获取的ID,用于唯一标识一次API请求。 |
successSize | Integer | 成功数。 |
totalSize | Integer | 总数。 |
data | Device 结构体数组 | 有关 Device 结构体的定义,其结构参见 Device 结构体。 |
示例¶
请求示例¶
url: https://{apigw-address}/connect-service/v2.5/deviceGroups?action=removeDeviceFromDeviceGroup&orgId=yourOrgId&groupId=yourGroupId
method: POST
返回示例¶
{
"code": 0,
"msg": "OK",
"requestId": "requestId",
"data": [
{
"code": 0,
"msg": "OK",
"data": "DeviceIdentifier(assetId=null, productKey=productKey, deviceKey=deviceKey)"
}
],
"successSize": 1,
"totalSize": 1
}