调用该接口查询指定设备的详细信息。
QPS限制
单个阿里云账号调用该接口的每秒请求数(QPS)最大限制为50。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | QueryDeviceDetail |
系统规定参数。取值:QueryDeviceDetail。 |
IotInstanceId | String | 否 | iot-v64*** |
实例ID。您可在物联网平台控制台的实例概览页面,查看当前实例的ID。 注意
实例的更多信息,请参见实例概述。 |
ProductKey | String | 否 | a1BwAGV**** |
要查询的设备所隶属的产品Key。 说明 如果传入该参数,需同时传入DeviceName。
|
DeviceName | String | 否 | light |
指定要查询的设备的名称。 说明 如果传入该参数,需同时传入ProductKey。
|
IotId | String | 否 | Q7uOhVRdZRRlDnTLv****00100 |
要查询的设备ID。 说明 如果传入该参数,则无需传入ProductKey和DeviceName。IotId作为设备唯一标识符,和ProductKey与DeviceName组合是一一对应的关系。如果您同时传入IotId和ProductKey与DeviceName组合,则以IotId为准。
|
调用API时,除了本文介绍的该API的特有请求参数,还需传入公共请求参数。公共请求参数说明,请参见公共参数文档。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | iot.system.SystemException |
调用失败时,返回的错误码。更多信息,请参见错误码。 |
Data | Struct |
调用成功时,返回设备的详细信息。 |
|
DeviceName | String | light |
设备名称。 |
DeviceSecret | String | mz2Canp4GB7qRVf1OYPNtRqB2anu**** |
设备密钥。 |
FirmwareVersion | String | V1.0.0.0 |
设备默认(default)OTA模块的版本号。 如果需要查询设备上报过的其他OTA模块版本信息,请参见ListOTAModuleVersionsByDevice。 |
GmtActive | String | 2018-08-06 10:48:41 |
设备的激活时间,GMT格式。 |
GmtCreate | String | 2018-08-06 10:47:50 |
设备的创建时间,GMT格式。 |
GmtOnline | String | 2018-08-06 13:43:12 |
设备最近一次上线的时间,GMT格式。 |
IotId | String | Q7uOhVRdZRRlDnTLv****00100 |
物联网平台为该设备颁发的ID,作为该设备的唯一标识符。 |
IpAddress | String | 10.0.0.1 |
设备的IP地址。 |
Nickname | String | detectors_in_beijing |
设备的备注名称。 |
NodeType | Integer | 0 |
节点类型,取值:
|
Owner | Boolean | true |
API调用者是否是该设备的拥有者。 |
ProductKey | String | a1rYuVF**** |
设备所属产品的ProductKey。 |
ProductName | String | test |
设备所属产品的名称。 |
Region | String | cn-shanghai |
设备所在地区(与控制台上的物联网地平台服务地域对应)。 |
Status | String | ONLINE |
设备状态。取值:
|
UtcActive | String | 2018-08-06T02:48:41.000Z |
设备的激活时间,UTC格式。 |
UtcCreate | String | 2018-08-06T02:47:50.000Z |
设备的创建时间,UTC格式。 |
UtcOnline | String | 2018-08-06T05:43:12.000Z |
设备最近一次上线的时间,UTC格式。 |
ErrorMessage | String | 系统异常 |
调用失败时,返回的出错信息。 |
RequestId | String | E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565 |
阿里云为该请求生成的唯一标识符。 |
Success | Boolean | true |
表示是否调用成功。
|
示例
请求示例
https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceDetail
&ProductKey=a1rYuVF****
&DeviceName=device1
&<公共请求参数>
正常返回示例
XML
格式
<QueryDeviceDetailResponse>
<Data>
<Owner>true</Owner>
<GmtActive>2020-01-16 13:33:37</GmtActive>
<DeviceName>Humidity</DeviceName>
<ProductKey>a1ttsqu****</ProductKey>
<DeviceSecret>sLefbFmN9SYfnWLJTePG893XNuRV****</DeviceSecret>
<IpAddress>42.120.75.144</IpAddress>
<GmtCreate>2020-01-08 14:47:08</GmtCreate>
<UtcCreate>2020-01-08T06:47:08.000Z</UtcCreate>
<IotId>dwnS41bhNxjslDAIF****00100</IotId>
<Status>OFFLINE</Status>
<UtcOnline>2020-01-17T08:19:11.091Z</UtcOnline>
<Region>cn-shanghai</Region>
<UtcActive>2020-01-16T05:33:37.830Z</UtcActive>
<Nickname>温湿度</Nickname>
<NodeType>0</NodeType>
<GmtOnline>2020-01-17 16:19:11</GmtOnline>
<ProductName>光照温湿度传感器</ProductName>
</Data>
<RequestId>D2D2DE90-DD0F-44EA-9F56-63F07A59F65B</RequestId>
<Success>true</Success>
</QueryDeviceDetailResponse>
JSON
格式
{
"Data": {
"Owner": true,
"GmtActive": "2020-01-16 13:33:37",
"DeviceName": "Humidity",
"ProductKey": "a1ttsqu****",
"DeviceSecret": "sLefbFmN9SYfnWLJTePG893XNuRV****",
"IpAddress": "42.120.75.144",
"GmtCreate": "2020-01-08 14:47:08",
"UtcCreate": "2020-01-08T06:47:08.000Z",
"IotId": "dwnS41bhNxjslDAIF****00100",
"Status": "OFFLINE",
"UtcOnline": "2020-01-17T08:19:11.091Z",
"Region": "cn-shanghai",
"UtcActive": "2020-01-16T05:33:37.830Z",
"Nickname": "温湿度",
"NodeType": 0,
"GmtOnline": "2020-01-17 16:19:11",
"ProductName": "光照温湿度传感器"
},
"RequestId": "D2D2DE90-DD0F-44EA-9F56-63F07A59F65B",
"Success": true
}