POST /thing/device/property/query

功能描述

获取设备的实时属性值。调用该接口会直接把请求下发到设备上。

请求参数

参数名称 类型 是否必选 描述
productKey String 设备所属产品的唯一标识符。可从物联网平台控制台获取。
deviceName String 设备的名称。可从物联网平台控制台获取。
propertyIdentifier JSONArray 设备的属性标识符。格式如下:
[
    "cpu_core_number",
    "cpu_usage"
]

返回示例

  • 正常返回示例
    {
        "code": 200,
        "message": "success",
        "data": [
            {
                "iotId;": "",                       //注意,iotId 在边缘端为空。
                "batchId": "",                      
                "attribute;": "xxx",                
                "group;": "",                       //注意,group 在边缘端为空。
                "value": "xxxx",
                "gmtModified": 1237891329
            }
        ]
    }
  • 异常返回参数示例
    {
      "code": 401,
      "data": null,
      "message": "device not found"
    }

完整示例

# 输入
curl -b token.cookie -d '{"request":{"apiVer":"0.6"},"params":{"productKey":"a1acbea****","deviceName":"RijJCeD63B0DXKQs****","propertyIdentifier":["cpu_core_number","cpu_usage"]}}' -k -X POST https://127.0.0.1:9999/thing/device/property/query
# 输出
{
    "code":200,
    "message":"success",
    "data":[
        {
            "iotId":"",
            "value":"8",
            "gmtModified":"1552035452",
            "attribute":"cpu_core_number",
            "groud":"",
            "batchId":""
        },
        {
            "iotId":"",
            "value":"16.730524",
            "gmtModified":"1552035452",
            "attribute":"cpu_usage",
            "groud":"",
            "batchId":""
        }
    ]
}