Call this operation to delete a specified device.

Description

If a device is no longer needed, you can delete it. After a device is deleted, the device ID (IotId) will be invalid, and any information associated with the device will be deleted. You cannot perform any action on the device.

Request parameters

Parameter Type Required Description
Action String Yes The operation that you want to perform. Set the value to DeleteDevice.
IotId String No

The unique identifier of the device that you want to delete.

Note If you use this parameter, ProductKey and DeviceName are not required. IotId is a globally unique identifier (GUID) of a device, and corresponds to the 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 product key of the device that you want to delete.

Note If you use this parameter, DeviceName is required.
DeviceName String No

The name of the device that you want to delete.

Note If you use this parameter, ProductKey is required.
Common Request Parameters - Yes For more information about common request parameters, 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.

Examples

Request example

https://iot.cn-shanghai.aliyuncs.com/?Action=DeleteDevice
 &IotId=MpEKNuEUJzIORNANAWJX0010929900*****
 &Public Request Parameters

Response example

  • JSON format

    {
      "RequestId":"57b144cf-09fc-4916-a272-a62902d5b207",
      "Success": true
    }
  • XML format

    <? xml version="1.0" encoding="UTF-8"? >
     <DeleteDeviceResponse>
          <RequestId>57b144cf-09fc-4916-a272-a62902d5b207</RequestId>
          <Success>true</Success>
      </DeleteDeviceResponse>