调用QueryDevicePropertyStatus查询指定设备的所有属性快照-云市场-阿里云

QueryDevicePropertyStatus

调用该接口查询指定设备的所有属性快照。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	QueryDevicePropertyStatus	系统规定参数。取值：QueryDevicePropertyStatus。
ProductKey	String	否	a1BwAGV****	要查询的设备所属的产品ProductKey。
DeviceName	String	否	light	要查询的设备名称。
IotId	String	否	Q7uOhVRdZRRlDnTLv****00100	设备ID。物联网平台为该设备颁发的ID，设备的唯一标识符。

重要

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

返回数据

名称	类型	示例值	描述
Code	String	iot.system.SystemException	调用失败时，返回的错误码。更多信息，请参见错误码。
Data	Struct		调用成功时，返回的数据，详情请参见List包含的参数。
List	Array of PropertyStatusInfo		返回的属性集合信息（PropertyStatusInfo）。
PropertyStatusInfo
DataType	String	int	属性格式类型，取值： int：整型。 float：单精度浮点型。 double：双精度浮点型。 enum：枚举型。 bool：布尔型。 text：字符型。 date：时间型（String类型的UTC时间戳，单位是毫秒）。 array：数组型。 struct：结构体类型。
Identifier	String	Temperature	属性标识符。
Name	String	temperature	属性名称。
Time	String	1517553572362	属性修改的时间，单位是毫秒。
Unit	String	°C	属性值的单位。
Value	String	25	属性值。
ErrorMessage	String	系统异常	调用失败时，返回的出错信息。
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	为该请求生成的唯一标识符。
Success	Boolean	true	表示是否调用成功。 true：调用成功。 false：调用失败。

示例

请求示例

curl 'https://si-d6e8d812acb848958054.tuyacloud.com:8686/?Action=QueryDevicePropertyStatus&SignatureNonce=ae853b23a70443f787fb1219cbf95d7c&AccessKeyId=xMr9wgwXQLhv5AUa65o03mcD&SignatureMethod=HMAC-SHA1&Timestamp=2024-11-19T09%3A53%3A09Z&ProductKey=k1ymv5ZxdaN&DeviceName=subDevice&Signature=tOUkRwL90ORD2IrYSw%2BG1l%2FBpb8%3D'

正常返回示例

{
	"Data": {
		"List": {
			"PropertyStatusInfo": [
				{
					"Name": "湿度",
					"Value": "48",
					"Time": "1579249151178",
					"DataType": "int",
					"Identifier": "Humidity",
					"Unit": "%"
				},
				{
					"Name": "温度",
					"Value": "32.46",
					"Time": "1579249151178",
					"DataType": "float",
					"Identifier": "Temperature",
					"Unit": "°C"
				}
			]
		}
	},
	"RequestId": "84BAD25B-9879-4BA1-9213-F576C6558D77",
	"Success": true
}