DISCLAIMER
Please note that all content presented on this page is provided by Tuya (HK) Limited. Alibaba Cloud makes no representations and warranties, explicit or implied, as to the authenticity or accuracy of any such content, nor makes any guarantee to the condition, quality, durability, performance, reliability, merchantability or fitness for a particular purpose, or non-infringement of any products and/or services made available by Tuya (HK) Limited.
Call this operation to remove the topology between a specified gateway and a sub-device, or to remove the topology between a specified sub-device and its associated gateway.
Instructions for use
If the incoming device information is a gateway device, remove the topology relationship between the Gateway and all its sub-devices.
If the incoming device information is a sub-device, remove the topological relationship between the sub-device and its associated gateway.
Request Parameters
Name | Type | Required | Sample Values | Description |
Action | String | Yes | RemoveThingTopo | System defined parameters. Value: RemoveThingTopo. |
ProductKey | String | No | A1BwAGV * * * * | The product to which the device whose topological relationship is to be deleted belongs ProductKey . |
DeviceName | String | No | Light | The name of the device whose topological relationship you want to delete. |
IoTID | String | No | **** 00100 | The ID of the device whose topological relationship you want to delete. The ID issued by IoT platform for the device. The unique identifier of the device. |
Note: When calling an API, in addition to the API-specific request parameters described in this topic, you must also pass in the common request parameters. For more information about common request parameters, see common Parameters Document.
Return data
Name | Type | Sample Values | Description |
Code | String | Iot.system.SystemException | The error code returned when the call fails. For more information, see error Code. |
Data | Boolean | True | The result of deleting a topological relationship. ●True : Deleted successfully. ●False : Delete failed. |
ErrorMessage | String | System exception | Error information returned when the call fails. |
JobID | String | 450407b * * * | The device Task ID, which is the globally unique identifier of the device task. |
RequestID | String | E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565 | The unique identifier generated for this request. |
Success | Boolean | True | Indicates whether the call succeeded. ●True : The call succeeded. ●False : The call failed. |
Example
Request Example
curl 'https://si-d6e8d812acb848958054.tuyacloud.com:8686/?Action=RemoveThingTopo&SignatureNonce=53f5e8c258fc4033893b416b1f750050&AccessKeyId=xMr9wgwXQLhv5AUa65o03mcD&SignatureMethod=HMAC-SHA1&Timestamp=2024-11-19T09%3A51%3A19Z&ProductKey=k1ymv5ZxdaN&DeviceName=subDevice&Signature=d2ROUAcxIz2BLmCVkl0N0kB4YDk%3D'Normal return example
{
"Data": true,
"RequestId": "098BEEF4-58F4-4181-A891-5D37DB6C4C3B",
"Success": true
}