本文档介绍设备影子的JSON格式表达方法。

设备影子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
}

JSON属性描述,如下表表 1所示。

表 1. JSON属性说明
属性 描述
desired 设备的预期状态。仅当设备影子文档具有预期状态时,才包含desired部分。

应用程序向desired部分写入数据,更新事物的状态,而无需直接连接到该设备。

reported 设备的报告状态。设备可以在reported部分写入数据,报告其最新状态。

应用程序可以通过读取该参数值,获取设备的状态。

JSON文档中也可以不包含reported部分,没有reported部分的文档同样为有效影子JSON文档。

metadata 当用户更新设备状态文档后,设备影子服务会自动更新metadata的值。

设备状态的元数据的信息包含以 Epoch 时间表示的每个属性的时间戳,用来获取准确的更新时间。

timestamp 影子文档的最新更新时间。
version 用户主动更新版本号时,设备影子会检查请求中的version值是否大于当前版本号。

如果大于当前版本号,则更新设备影子,并将version值更新到请求的版本中,反之则会拒绝更新设备影子。

该参数更新后,版本号会递增,用于确保正在更新的文档为最新版本。

version参数为long型。为防止参数溢出,您可以手动传入-1将版本号重置为0

说明

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

更新数组数据示例:

  • 初始状态:
    {
        "reported" : { 
            "colors" : [
                "RED", 
                "GREEN",
                "BLUE" 
            ]
        }
    }
  • 更新:
    {
        "reported" : {
            "colors" : [
                "RED"
            ] 
        }
    }
  • 最终状态:
    {
        "reported" : {
            "colors" : [
                "RED"
            ] 
        }
    }