通过QueryDevice查询指定产品下的设备列表_云市场(Marketplace)-阿里云帮助中心

QueryDevice

调用该接口查询指定产品下的设备列表。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	QueryDevice	系统规定参数。取值：QueryDevice。
ProductKey	String	是	a1BwAGV****	要查询的设备所属产品的ProductKey。
PageSize	Integer	否	10	指定返回结果中每页显示的记录数量，最大值是50。默认值是10。
CurrentPage	Integer	否	1	指定显示返回结果中的第几页的内容。默认值是 1。
NextToken	String	否	TGlzdFJlc291cm***	下一页标识，首次查询无需传入。后续查询需使用的NextToken，要从上一次查询的返回结果中获取。当PageSize×CurrentPage值大于10,000时，必须传入NextToken。否则，无法返回数据。

重要

‼️ 注意：调用API时，除了本文介绍的该API的特有请求参数，还需传入公共请求参数。公共请求参数说明，请参见公共参数。

返回数据

名称	类型	示例值	描述
Code	String	iot.system.SystemException	调用失败时，返回的错误码。更多信息，请参见错误码。
Data	Array of DeviceInfo		调用成功时，返回设备信息列表（DeviceInfo）。
DeviceInfo
DeviceName	String	light	设备名称。
DeviceSecret	String	sLefbFmN9SYfnWLJTePG893XNuRV****	设备密钥。
DeviceStatus	String	ONLINE	设备状态。取值： ONLINE：设备在线。 OFFLINE：设备离线。 UNACTIVE：设备未激活。 DISABLE：设备已禁用。
DeviceType	String	Lighting	设备所属产品的品类。
GmtCreate	String	Wed, 20-Feb-2019 02:16:09 GMT	设备创建时间，GMT格式。
GmtModified	String	Wed, 20-Feb-2019 02:16:09 GMT	设备信息最后一次更新时的时间，GMT格式。
IotId	String	Q7uOhVRdZRRlDnTLv****00100	设备ID。物联网平台为该设备颁发的ID，设备的唯一标识符。
Nickname	String	智能灯设备	设备的备注名称。
ProductKey	String	a1BwAGV****	设备所隶属的产品ProductKey。
UtcCreate	String	2019-02-20T02:16:09.000Z	设备创建时间，UTC格式。
UtcModified	String	2019-02-20T02:16:09.000Z	设备信息最后一次更新时的时间，UTC格式。
ErrorMessage	String	系统异常	调用失败时，返回的出错信息。
NextToken	String	TGlzdFJlc291cm***	下一页标识。可在下次请求时传入，来获取下一页数据。如果NextToken值为空，表示没有下一页数据。
Page	Integer	1	当前页面号。
PageCount	Integer	1	总页数。
PageSize	Integer	10	每页显示的设备数。
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	为该请求生成的唯一标识符。
Success	Boolean	true	是否调用成功。 true：调用成功。 false：调用失败。
Total	Integer	2	设备总数。

示例

请求示例

curl 'https://si-d6e8d812acb848958054.tuyacloud.com:8686/?Action=QueryDevice&SignatureNonce=32e7a9cdcb744116a594040fff3bdf42&AccessKeyId=xMr9wgwXQLhv5AUa65o03mcD&SignatureMethod=HMAC-SHA1&Timestamp=2024-11-19T08%3A35%3A11Z&ProductKey=k1ymv1DuLfE&Signature=Om8wdBXCHymhxBOhNQPThcmj3Vg%3D'

正常返回示例

{
  "PageCount": 1,
  "NextToken":"TGlzdFJlc291cm***", 
  "Data": {
    "DeviceInfo": [
      {
        "DeviceId": "Av8NGHGtwPrH9BYG****", 
        "DeviceName": "Av8NGHGtwPrH9BYGLMBi", 
        "ProductKey": "a1dafDE****", 
        "DeviceSecret": "d7GYhf5hfcPHDe1bXSd3n9MjO1G3****", 
        "UtcModified": "2019-02-20T02:16:09.000Z", 
        "GmtCreate": "Wed, 20-Feb-2019 02:16:09 GMT", 
        "UtcCreate": "2019-02-20T02:16:09.000Z", 
        "GmtModified": "Wed, 20-Feb-2019 02:16:09 GMT", 
        "IotId": "Av8NGHGtwPrH9BYGLMBi00****", 
        "DeviceStatus": "UNACTIVE", 
        "Nickname": "SensorInShanghai"
      }, 
      {
        "DeviceId": "zNIcSmWQ9BPJlmkj****", 
        "DeviceName": "zNIcSmWQ9BPJlmkjn3H1", 
        "ProductKey": "a1dafDE****", 
        "DeviceSecret": "C27XXmC18yLIEDXvUj6FSlvgO7ag****", 
        "UtcModified": "2019-02-20T02:16:09.000Z", 
        "GmtCreate": "Wed, 20-Feb-2019 02:16:09 GMT", 
        "UtcCreate": "2019-02-20T02:16:09.000Z", 
        "GmtModified": "Wed, 20-Feb-2019 02:16:09 GMT", 
        "IotId": "zNIcSmWQ9BPJlmkjn3H100****", 
        "DeviceStatus": "UNACTIVE", 
        "Nickname": "DriverInShanghai"
      }
    ]
  }, 
  "Page": 1, 
  "PageSize": 10, 
  "RequestId": "CD9E5F99-A095-4A05-9256-D924EA3075E8", 
  "Success": true, 
  "Total": 2
}