Getting Attributes¶

A device can publish a message to this topic to retrieve the attributes from the cloud.

Upstream

Request TOPIC: /sys/{productKey}/{deviceKey}/thing/attribute/query
Reply TOPIC: /sys/{productKey}/{deviceKey}/thing/attribute/query_reply

Sample Request Format¶

{
 "id": "123",
 "version": "1.0",
 "params": {
   "attributes": ["attr1", "attr2", "attr3"]
 },
 "method": "thing.attribute.query"
}

Sample Response Format¶

{
 "id": "123",
 "code": 200,
 "data": {
   "attr1": {
       "value": 1.0,
       "value2": "9"
     },
   "attr2": 1.02,
   "attr3": [1.02, 2.02, 7.93]
 }
}

Request Parameter Description¶

Parameter	Type	Mandatory/Optional	Description
id	String	Optional	The message ID. It is a reserved parameter that is reserved for future use.
version	String	Mandatory	The version of the protocol. The current version is 1.0.
params	List	Mandatory	The parameters used for getting the attributes.
attributes	Array	Mandatory	The list of the device’s attributes’ identifiers. A request can carry a maximum of 200 items. When not specified, the system will retrieve all the attributes.
method	String	Mandatory	The request method.

Response Parameter Description¶

Parameter	Type	Description
code	Integer	The return code. “200” indicates that the request operation is executed successfully.
data	Struct	The returned information of the attributes.
attr1	String	The attribute ID.
value	Struct	The details of the attribute.

Return Code¶

Return Code	Error Message	Explanation
1208	Attribute query data format error	Invalid request format.