# queryDeviceDesiredProperty

调用该接口查询指定设备的期望属性值。

# 限制说明

  • 只读属性不支持设置期望属性值。
  • 一次调用最多可设置10个期望属性值。
  • 仅支持查询读写模式的属性,如果您指定了只读模式的属性,该属性将被忽略。

# 请求参数

参数类型是否是必选示例值说明
product_keystringANOWAGVC**设备所属的产品ProductKey
device_namestringAP0DNAP**设备名称
identifiersarray["test:Level"]要查询期望值的属性的标识符(identifier)列表。最多可输入10个期望属性值。
  • 单次调用,最多能传入10个标识符
  • 不可输入重复的属性标识符
  • 若不传入此参数,将返回该设备所有属性的期望值
  • # 返回数据

    参数类型说明
    codeint错误码,0表示成功
    messagestring调用失败时的错误描述
    datastruct调用成功时返回的数据

    # 示例

    请求示例

    curl host:8082/device-thing-service/v0/thingModel/setDeviceDesiredProperty -X POST \
    -d '{"product_key": "KS9ZBEOR","device_name": "tddemoemost","properties_json": "{\"test:Level\":\"HIGH\"}","versions_json": "{\"test:Level\":0}"}' \
    -H "Content-Type: application/json" \
    -H "Cookie: FABRIC_TOKEN=fabric.1.4b84b15bff6ee5796152495a230e45e3d7e947d9.d5527e81265b78e47b7891e3ad18d4cdddd3fda2.1629086990.c24c2f07" 
    
    1
    2
    3
    4

    返回数据

    {
        "code": 0,
        "message": "",
        "data": {
          "desired_property_datas":[
            {
              "identifier": "test:Level",
              "version": 1,
              "value": "{\"HIGH\"}",
              "data_type": "text",
              "time": 1629100828173
            }
          ]
        }
    }
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    desired_property_datas 数组类型,返回指定属性的期望值