V2.5 Remove Device from Device Group


将设备从设备组中移除。

操作权限


需授权的服务

所需操作权限

设备管理

Full Access

请求格式


POST https://{apigw-address}/connect-service/v2.5/deviceGroups?action=removeDeviceFromDeviceGroup

请求参数(URI)


名称

位置(Path/Query)

必需/可选

数据类型

描述

orgId

Query

必需

String

资产所属的组织ID。 如何获取orgId信息>>

请求参数(Body)


名称

必需/可选

数据类型

描述

groupId

必需

String

设备组ID。在 EnOS 管理控制台中前往 设备管理 > 设备组 获取设备组ID。

deviceIdentifier

必需

结构体

参见 DeviceIdentifier 结构体

DeviceIdentifier 结构体


名称

数据类型

描述

assetId

String

资产 ID。 如何获取Asset ID信息>>

productKey

String

Product Key。如何获取设备的 productKey 信息>>

deviceKey

String

Device Key。如何获取设备的 deviceKey 信息>>

响应参数


名称

数据类型

描述

code

Number

响应码

msg

String

对状态码的解释和说明。请求成功为 “OK”。

requestId

String

每次请求获取的ID,用于唯一标识一次API请求。

successSize

Integer

成功数。

totalSize

Integer

总数。

data

Device 结构体数组

有关 Device 结构体的定义,其结构参见 Device 结构体

Device 结构体


名称

数据类型

描述

code

number

更新成功或失败的指示码。

msg

String

成功时返回 OK;其他值则为失败。

data

String

创建设备组的信息。

示例

请求示例

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
}