Domain name for API request: iotcloud.tencentcloudapi.com.
This API is used to get the list of IoT Hub devices.
A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
Parameter Name | Required | Type | Description |
---|---|---|---|
Action | Yes | String | Common Params. The value used for this API: DescribeDevices. |
Version | Yes | String | Common Params. The value used for this API: 2021-04-08. |
Region | Yes | String | Common Params. For more information, please see the list of regions supported by the product. |
ProductId | Yes | String | ID of the product whose devices are queried |
Offset | Yes | Integer | Offset, which starts from 0 |
Limit | Yes | Integer | Page size. Value range: 10-250 |
FirmwareVersion | No | String | Device firmware version. If no value is passed in, devices of all firmware versions are returned. If None-FirmwareVersion is passed in, devices without version numbers are returned. |
DeviceName | No | String | Device name to query |
EnableState | No | Integer | Whether to query enabled or disabled devices. 0 : disabled devices; 1 : enabled devices. By default, both enabled and disabled devices are queried. |
Parameter Name | Type | Description |
---|---|---|
TotalCount | Integer | Total number of the devices returned |
Devices | Array of DeviceInfo | List of device details |
RequestId | String | The unique request ID, which is returned for each request. RequestId is required for locating a problem. |
https://iotcloud.tencentcloudapi.com/?Action=DescribeDevices
&ProductId=ABCDE12345
&Offset=0
&Limit=10
&FirmwareVersion=1.0.0
&<Common request parameters>
{
"Response": {
"TotalCount": 1,
"RequestId": "xx",
"Devices": [
{
"EnableState": 1,
"LastOfflineTime": 1,
"Version": "xx",
"CertState": 1,
"Online": 1,
"FirmwareUpdateTime": 1,
"DeviceName": "xx",
"Tags": [
{
"Tag": "xx",
"Type": 1,
"Name": "xx",
"Value": "xx"
},
{
"Tag": "xx",
"Type": 1,
"Name": "xx",
"Value": "xx"
}
],
"LogLevel": 1,
"FirstOnlineTime": 1,
"DeviceCert": "xx",
"Imei": "xx",
"ClientIP": "xx",
"DevicePsk": "xx",
"Isp": 1,
"NbiotDeviceID": "xx",
"LoraDevEui": "xx",
"DeviceType": 1,
"LoginTime": 1,
"ConnIP": 1,
"LastUpdateTime": 1,
"Labels": [
{
"Value": "xx",
"Key": "xx"
}
],
"CreateTime": 1,
"LoraMoteType": 1
}
]
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
Error Code | Description |
---|---|
InternalError | Internal error. |
InternalError.DBOperationError | An internal database error occurred. |
InvalidParameterValue | Invalid parameter value. |
ResourceNotFound.ProductNotExist | The product does not exist. |
Was this page helpful?