V2.1 Remove Sub-Device¶

将子设备从网关下移除（解除拓扑关系）。

该 API 支持在 EnOS 2.1.0 及以上环境中使用。

操作权限¶

使用此 API 前，确保服务账号已被授予包含下列服务和操作权限的策略。有关授权服务账号的更多信息，参见管理服务账号。

需授权的服务	所需操作权限
设备管理服务	Full Access

请求格式¶

POST https://{apigw-address}/connect-service/v2.1/device-topos?action=removeSubDevice

请求参数（URI）¶

名称	位置（Path/Query）	必需/可选	数据类型	描述
orgId	Query	必需	String	资产所属的组织ID。如何获取orgId信息>>

请求参数（Body）¶

名称	必需/可选	数据类型	描述
gateway	必需	DeviceIdentfier结构体	需要移除子设备的网关信息，见 DeviceIdentfier结构体>>
subDevices	必需	DeviceIdentfier结构体数组	需要从指定网关移除的子设备列表信息，见 DeviceIdentfier结构体>>

DeviceIdentifier结构体¶

备注

以下非必需字段中，必须提供 assetId 或 productKey + deviceKey 的组合，用于指定设备。

名称	数据类型	描述
assetId	String	资产ID。如何获取Asset ID信息>>
productKey	String	Product Key。如何获取 productKey 信息>>
deviceKey	String	Device Key.`如何获取设备的 deviceKey 信息>> </docs/device-connection/zh_CN/dev/howto/device/managing_devices.html#triple>`_

错误码¶

代码	数据类型	描述
11738	Not Gateway	参数gateway不是网关设备。
99400	Invalid arguments	参数错误。

示例¶

请求示例¶

url:https://{apigw-address}/connect-service/v2.1/device-topos?action=removeSubDevice&orgId=yourOrgId
method: POST
requestBody:
{
    "subDevices":[
        {
            "assetId":"yourAssetId"
        }
    ],
    "gateway":{
        "assetId":"yourAssetId2"
    }
}

返回示例¶

{
    "code":0,
    "msg":"OK",
    "requestId":"ea6608bb-b8cb-46f3-a836-ee24ea9a028c",
    "data":null
}

SDK 示例¶

你可以在 Github 上获取接入服务的 SDK 示例：

Java
Python