IOT物联网-设备影子(联通用户专用):业务流程

时间:2025-02-28 09:24:38

业务流程

修改设备属性值

修改desired属性值,如果设备在线,则设备影子直接同步设备属性值到设备,否则等待设备上线或上报数据时,再同步设备属性值到设备。

  1. 用户通过控制台或应用服务器修改设备属性值。消息样例如下:
    Method: PUT
    request:
    https://server:port/iocm/app/shadow/v1.5.0/devices/devices/{deviceId}?appId={appId}
    Header:
    app_key: ******
    Authorization: Bearer ******
    Content-Type: application/json
    Body: 
    {
      "serviceDesireds": [
        {
          "serviceId": "Temperature",
          "desired": {
            "targetTemperature": 35
          }
        }
      ]
    }
  2. 物联网平台 修改desired属性值。
  3. 物联网平台返回响应消息。
  4. 物联网平台判断设备上线或上报数据。
  5. 物联网平台将设备属性同步到设备。
  6. 设备返回响应消息。
  7. 当设备上报数据时,物联网平台修改report属性值为设备上报的设备属性值。

查询设备属性值

设备影子保存的是设备最新的设备属性值,一旦设备属性值产生变化,设备会将设备属性值同步到设备影子。用户便可以及时获取查询结果,无需关注设备是否在线。

  1. 用户通过控制台或应用服务器查询设备属性值。消息样例如下:
    Method: GET
    request:
    https://server:port/iocm/app/shadow/v1.5.0/devices/{deviceId}
    Header:
    app_key: ******
    Authorization: Bearer ******
    Content-Type: application/json
  2. 物联网平台返回desired属性值和report属性值,即期望值和上报值。消息样例如下:
    response:
    Status Code: 200 OK
    Content-Type: application/json
    Body:
    {
      "deviceId": "******",
      "gatewayId": "******",
      "nodeType": "******",
      "createTime": "******",
      "lastModifiedTime": "******",
      "deviceInfo": "******""services": [
        {
          "serviceId": "******",
          "reportedProps": "******",
          "desiredProps": "******",
          "eventTime": "******",
          "serviceType": "******"
        },
      ]
    }
support.huaweicloud.com/usermanual-IoT/iot_01_0049.html