RemoveThingTopo

更新时间:2024-09-14 07:22:18

调用该接口移除指定网关与子设备的拓扑关系,或指定子设备与其关联网关的拓扑关系。

使用说明

  • 如果传入的设备信息是网关设备,则移除该网关与其下所有子设备的拓扑关系。
  • 如果传入的设备信息是子设备,则移除该子设备与其关联网关的拓扑关系。

请求参数

名称 类型 是否必选 示例值 描述
Action String RemoveThingTopo 系统规定参数。取值:RemoveThingTopo。
IotInstanceId String iot_instc_pu****_c*-v64********* 实例ID。您可在物联网平台控制台的实例概览 页面,查看当前实例的ID注意 + 若有ID值,必须传入该ID值,否则调用会失败。 + 若无ID值,则无需传入。实例的更多信息,请参见实例概述。
ProductKey String a1BwAGV**** 要删除拓扑关系的设备所属的产品** ProductKey**。** 说明** 如果传入该参数,需同时传入** DeviceName**。
DeviceName String light 要删除拓扑关系的设备名称。** 说明** 如果传入该参数,需同时传入** ProductKey**。
IotId String Q7uOhVRdZRRlDnTLv****00100 要删除拓扑关系的设备ID。物联网平台为该设备颁发的ID,设备的唯一标识符。说明 如果传入该参数,则无需传入ProductKeyDeviceNameIotId作为设备唯一标识符,和ProductKeyDeviceName组合是一一对应的关系。如果您同时传入IotIdProductKeyDeviceName组合,则以IotId为准。

返回数据

名称 类型 示例值 描述
Code String iot.system.SystemException 调用失败时,返回的错误码。更多信息,请参见错误码。
Data Boolean true 删除拓扑关系的结果。 + true:删除成功。 + false:删除失败。
ErrorMessage String 系统异常 调用失败时,返回的出错信息。
JobId String 450407b*** 设备任务ID,设备任务的全局唯一标识符。
RequestId String E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565 涂鸦云为该请求生成的唯一标识符。
Success Boolean true 表示是否调用成功。 + ** true**:调用成功。 + ** false**:调用失败。

示例

请求示例

https://iot.****.tuya.com/?Action=RemoveThingTopo
&ProductKey=a1bPo9p****
&DeviceName=device1
&<公共请求参数>

正常返回示例

JSON格式

{
    "Data": true,
    "RequestId": "098BEEF4-58F4-4181-A891-5D37DB6C4C3B",
    "Success": true
}