BatchAddThingTopo
调用该接口批量添加设备拓扑关系
服务地址：
华东2（上海）
输入参数
只看必填
IotInstanceId实例ID
GwProductKey网关设备所属的产品的ProductKey
GwDeviceName网关设备的名称
TopoAddItem添加的的设备拓扑关系列表
0
ProductKey要接入网关的子设备所属的产品Produ...
DeviceName要接入网关的子设备名称
Sign添加拓扑关系的签名
TimestampUTC时间戳
SignMethod签名方法
ClientId设备端ID
添加
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

使用说明

  • 单次调用最多可为一个网关添加 10 个子设备。

  • 接口调用者必须是网关的所有者（Owner）。

  • 单个阿里云账号调用该接口的 QPS 限流为 5。

  • 如果传入的子设备已存在拓扑关系，则会将子设备原有的网关替换为当前网关。

  • 任意一个子设备与网关的拓扑关系建立失败时，系统回滚，传入的所有子设备与当前网关建立拓扑关系失败。

QPS 限制

单个阿里云账号调用该接口的每秒请求数（QPS）最大限制为 10。

说明 RAM 用户共享阿里云账号配额。

请求参数

字段名称字段详情
IotInstanceIdstring

实例 ID。您可在物联网平台控制台的实例概览页面，查看当前实例的 ID。展开详情

示例值:iot_instc_pu****_c*-v64********
GwProductKeystring

网关设备所属的产品的 ProductKey。

示例值:a1vL7cp****
GwDeviceNamestring

网关设备的名称。

示例值:gateway
TopoAddItemarray<object>

添加的的设备拓扑关系列表。

子级条数 <= 50

请求说明

调用 API 时，除了本文介绍的该 API 的特有请求参数，还需传入公共请求参数。公共请求参数说明，请参见公共参数文档。

返回参数

字段名称字段详情
Codestring

调用失败时，返回的错误码。更多信息，请参见错误码。

示例值:iot.system.SystemException
ErrorMessagestring

调用失败时，返回的出错信息。

示例值:系统异常
RequestIdstring

阿里云为该请求生成的唯一标识符。

示例值:E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565
Successboolean

表示是否调用成功。展开详情

示例值:true
变更历史
暂无变更历史