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.