Call this operation to remove the topological relationships of a device. If the specified device is a sub-device, the topological relationship between this device and the gateway device will be deleted. If the specified device is a gateway, all the topological relationships of this gateway device will be deleted.
Request parameters
Parameter | Type | Required | Description |
---|---|---|---|
Action | String | Yes | The operation that you want to perform. Set the value to RemoveThingTopo. |
IotId | String | No | A unique identifier of the device.
Note If you use this parameter,
ProductKey and
DeviceName are not required. As the unique identifier of a device,
IotId corresponds to a combination of
ProductKey and
DeviceName. If you specify both
IotId and the combination of
ProductKey and
DeviceName, the system follows
IotId.
|
ProductKey | String | No | The ProductKey of the device whose topological relationships you want to delete.
Note If you use this parameter,
DeviceName is required.
|
DeviceName | String | No | The name of the device whose topological relationships you want to delete.
Note If you use this parameter,
ProductKey is required.
|
Common Request Parameters | - | Yes | See Common parameters. |
Response parameters
Parameter | Type | Description |
---|---|---|
RequestId | String | The globally unique ID generated by Alibaba Cloud for the request. |
Success | Boolean | Indicates whether the call is successful. A value of true indicates that the call is successful. A value of false indicates that the call has failed. |
ErrorMessage | String | The error message returned when the call fails. |
Code | String | The error code returned when the call fails. For more information about error codes, see Error codes. |
Data | Boolean | The result of the action of removing topological relationship. A value of true indicates that the topological relationships of the device have been successfully deleted, and a value of false indicates that the topological relationships have not been deleted. |
Examples
Request example
https://iot.cn-shanghai.aliyuncs.com/?Action=RemoveThingTopo
&IotId=CqXL5h5ysRTA4NxjABjj0010fa****
&Public Request Parameters
Response example
-
JSON format
{ "Data": true, "RequestId": "098BEEF4-58F4-4181-A891-5D37DB6C4C3B", "Success": true }
-
XML format
<? xml version='1.0' encoding='UTF-8'? > <RemoveThingTopoResponse> <RequestId>098BEEF4-58F4-4181-A891-5D37DB6C4C</RequestId> <Success>true</Success> <Data>true</Data> </RemoveThingTopoResponse>