QueryDevicePropertyStatus

Last Updated on : 2025-10-10 06:53:46Copy for LLMView as MarkdownDownload PDF

You can call this operation to query all attribute snapshots of a specified device.

Request Parameters

Name	Type	Required	Sample Values	Description
Action	String	Yes	QueryDevicePropertyStatus	System defined parameters. Value: QueryDevicePropertyStatus.
ProductKey	String	No	A1BwAGV * * * *	The ProductKey of the device to be queried.
DeviceName	String	No	Light	The name of the device to be queried.
IoTID	String	No	**** 00100	The device ID. The ID issued by IoT platform for the device. The unique identifier of the device.

Note: When calling an API, in addition to the API-specific request parameters described in this topic, you must also pass in the common request parameters. For more information about common request parameters, see Common parameters.

Return Data

Name	Type	Sample Values	Description
Code	String	Iot.system.SystemException	The error code returned when the call fails. For more information, see Error codes.
Data	Struct		The data returned when the call is successful. For more information, see List the included parameters.
List	Array of PropertyStatusInfo		The returned property collection information ( PropertyStatusInfo ).
PropertyStatusInfo
DataType	String	Int	Attribute format type, value: - Int : Integer. - Float : Single-precision floating-point type. - Double : Double-precision floating-point type. - Enum : Enumeration type. - Bool : Boolean. - Text : Character type. - Date : Time type (UTC timestamp of the String type, in milliseconds). - Array : Array type. - Struct : Structure type.
Identifier	String	Temperature	The property identifier.
Name	String	Temperature	The property name.
Time	String	1517553572362	Property modification time, in milliseconds.
Unit	String	&Deg; C	The unit of the property value.
Value	String	25	Property value.
ErrorMessage	String	System Exception	Error information returned when the call fails.
RequestID	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	The unique identifier generated for this request.
Success	Boolean	True	Indicates whether the call succeeded. - True : The call succeeded. - False : The call failed.

Example

Request Example

curl 'https://si-d6e******48958054.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'

Normal Return Example

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

Prev DocUse of Thing Model

Next DocQueryDeviceDesiredProperty