设备影子JSON文档示例

{
  "state": {
    "desired": {
      "color": "RED",
      "sequence": ["RED", "GREEN", "BLUE"]
    },
    "reported": {
      "color": "GREEN"
    }
  },
  "metadata": {
    "desired": {
      "color": {
        "timestamp": 1469564492
      },
      "sequence": {
        "timestamp": 1469564492
      }
    },
    "reported": {
      "color": {
        "timestamp": 1469564492
      }
    }
  },
  "timestamp": 1469564492,
  "version": 1
}

属性	描述
desired	设备的预期状态。仅当设备影子文档具有预期状态时，才包含 desired 部分。 应用程序向 desired 部分写入数据，更新事物的状态，而无需直接连接到该设备。
reported	设备的报告状态。设备可以在 reported 部分写入数据，报告其最新状态。 应用程序可以通过读取该参数值，获取设备的状态。 JSON文档中也可以不包含reported部分，没有reported部分的文档同样为有效影子JSON文档。
metadata	当用户更新设备状态文档后，设备影子服务会自动更新 metadata 的值。 设备状态的元数据的信息包含以 Epoch 时间表示的每个属性的时间戳，用来获取准确的更新时间。
timestamp	影子文档的最新更新时间。
version	用户主动更新版本号时，设备影子会检查请求中的 version 值是否大于当前版本号。 如果大于当前版本号，则更新设备影子，并将 version 值更新到请求的版本中，反之则会拒绝更新设备影子。 该参数更新后，版本号会递增，用于确保正在更新的文档为最新版本。 version 参数为 int 型。为防止参数溢出，您可以手动传入 -1 将版本号重置为 0。

表：JSON属性说明

相关信息

设备影子支持数组。更新数组时必须全量更新，不能只更新数组的某一部分。

更新数组数据示例

• 初始状态：

{
  "reported": {
    "colors": ["RED", "GREEN", "BLUE"]
  }
}

• 更新：

{
  "reported": {
    "colors": ["RED"]
  }
}

• 最终状态：

{
  "reported": {
    "colors": ["RED"]
  }
}

编辑此页

上一页设备影子概述