调用GetThingProperties获取指定设备的属性值_物联网边缘计算(IoT Edge)-阿里云帮助中心

使用该接口获取指定设备的属性值。

请求语法

GET /2020-04-30/things/ProductKey/DeviceName/properties?identifiers=Identifier1&identifiers=Identifier2&... HTTP/1.1
Cookie: Cookie

重要其中，2020-04-30是边缘端OpenAPI的版本号，请勿修改。

请求参数

参数名称	类型	是否必选	描述
ProductKey	String	是	设备所属产品的唯一标识符。可从物联网平台控制台获取。
DeviceName	String	是	设备的名称。可从物联网平台控制台获取。
Identifiers	String	是	设备的属性标识符列表。最多可检索100条属性值。
Cookie	String	是	调用CreateAuthCookie接口创建的认证Cookie。

返回语法

HTTP/1.1 StatusCode
Content-Type: application/json

Payload

返回参数

参数名称	类型	描述
StatusCode	Number	HTTP状态码。返回200表示成功，返回其它状态码表示失败。状态码详情，请参见状态码。
Payload	JSON	已获取的设备属性。

返回Payload格式如下所示。

{  
  "Data": {      
      "Properties": {
        "Identifier1": value1,
        "Identifier2": value2,
        "Identifier3": value3,
            ...
      },
      "Timestamp": 1568262117344
    }
}

完整示例

$ curl -i -b token.cookie -k https://127.0.0.1:9999/2020-04-30/things/a1W****CGHU/N0hB9tiVWWZF****KHgs/properties?identifiers=LightSwitch

HTTP/1.1 200 OK
Server: openresty/1.13.6.2
Date: Wed, 22 Apr 2020 17:01:50 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive

{"Data":{"Timestamp":1587574910136,"Properties":{"LightSwitch":1}}}