调用该接口通知网关设备增加拓扑关系。

限制说明

返回的成功结果只表示添加拓扑关系的指令成功下发给网关,但并不表示网关成功添加拓扑关系。

请求参数

名称 类型 是否必需 描述
Action String 要执行的操作,取值:NotifyAddThingTopo
GwIotId String

要通知的网关设备ID,即网关类型设备的IotId。

说明 如果传入该参数,则无需传入 GwProductKeyGwDeviceNameGwIotId作为设备唯一标识符,与 GwProductKey和 GwDeviceName组合是一一对应的关系。如果您同时传入 GwIotIdGwProductKeyGwDeviceName组合,则以 GwIotId为准。
GwProductKey String

要通知的网关设备所隶属的产品Key,即网关类型产品的ProductKey。

说明 如果传入该参数,需同时传入 GwDeviceName
GwDeviceName String

要通知的网关设备的名称,即网关类型设备的DeviceName。

说明 如果传入该参数,需同时传入 GwProductKey
DeviceListStr List 要挂载在目标网关设备上的子设备数组,为JSON字符串形式。具体结构参见下表DeviceList。
公共请求参数 - 请参见公共参数
表 1. DeviceList
名称 类型 是否必需 描述
ProductKey String

子设备所隶属的产品Key。

说明 如果传入该参数,需同时传入 DeviceName
DeviceName String

子设备名称。

说明 如果传入该参数,需同时传入 ProductKey
IotId String

子设备ID,物联网平台颁发给设备的唯一标识。

说明 如果传入该参数,则无需传入 ProductKeyDeviceNameIotId作为设备唯一标识符,与 ProductKey & DeviceName组合是一一对应的关系。如果您同时传入 IotIdProductKeyDeviceName组合,则以 IotId为准。

返回参数

名称 类型 描述
RequestId String 阿里云为该请求生成的唯一标识符。
Success Boolean 表示是否调用成功。true表示调用成功,false表示调用失败。
ErrorMessage String 调用失败时,返回的出错信息。
Code String 调用失败时,返回的错误码。错误码详情,请参见错误码
Data Data 调用成功时,返回的数据。详情请见下表Data。
表 2. Data
名称 类型 描述
MessageId String 云端向网关设备下发增加拓扑关系的消息ID。

示例

请求示例

https://iot.cn-shanghai.aliyuncs.com/?Action=NotifyAddThingTopo
&GwProductKey=aldnfald7a
&GwDeviceName=gateway
&DeviceListStr=[{"productKey":"alabcabcab","deviceName":"device1"},{"IotId":"edAjkIeBSsdfadjjllja***"}]
&公共请求参数

返回示例

  • JSON格式

    {
      "RequestId":"419A3FC1-B517-4958-9414-5546765FA51F",
      "Success": true,
      "Data":{
    	 "MessageId": "abcabc123"
      }
    }
  • XML格式

    <?xml version='1.0' encoding='UTF-8'?>
    <NotifyAddThingTopoResponse>
        <RequestId>419A3FC1-B517-4958-9414-5546765FA51F</RequestId>
        <Success>true</Success>
        <Data>
    	<MessageId>abcabc123</MessageId>
        </Data>
    </NotifyAddThingTopoResponse>