Get 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 | Mandatory/Optional | Description |
---|---|---|---|
code | Integer | Mandatory | The return code. “200” indicates that the request operation is executed successfully. |
data | Struct | Mandatory | The returned information of the attributes. |
Return Code¶
Return Code | Error Message | Explanation |
---|---|---|
1208 | Attribute query data format error | Invalid request format. |