Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

将本地设备阴影与同步 Amazon IoT Core

通过影子管理器组件 Amazon IoT Greengrass ，可以将本地设备影子状态与同步 Amazon IoT Core。您必须修改影子管理器组件的配置以包含synchronization配置参数，并为您的设备指定 Amazon IoT 事物名称以及要同步的阴影。

当您将影子管理器配置为同步影子时，它会同步指定影子的所有状态更改，不管更改发生在本地影子文档还是云影子文档中。

您还可以指定影子管理器组件是实时同步影子，还是定期同步影子。默认情况下，影子管理器组件会实时同步阴影，因此每次更新发生 Amazon IoT Core 时，核心设备都会发送和接收影子更新。您可以配置定期间隔以减少带宽使用量和费用。

先决条件

要与本地阴影同步 Amazon IoT Core，必须将 Greengrass 核心设备的策略配置为允许以下影 Amazon IoT 子策略操作。 Amazon IoT Core

有关更多信息，请参阅下列内容：

配置影子管理器组件

影子管理器需要一个影子名称映射列表，以便将本地影子文档中的影子状态信息同步到 Amazon IoT Core中的云影子文档。

要同步影子状态，请创建一个包含 aws.greengrass.ShadowManager 组件的部署，并在部署的影子管理器配置中以 synchronize 配置参数指定要同步的影子。

以下示例配置更新指示影子管理器组件将以下阴影与 Amazon IoT Core同步：

此配置更新指定与阴影实时 Amazon IoT Core 同步。如果您使用影子管理器 v2.1.0 或更高版本，则可以将影子管理器组件配置为定期同步影子。要配置此功能，请将同步策略更改为 periodic，然后为间隔指定 delay（以秒为单位）。有关更多信息，请参阅影子管理器组件的策略配置参数。

此配置更新指定在 Amazon IoT Core 和核心设备之间双向同步影子。如果您使用影子管理器 v2.2.0 或更高版本，则可以将影子管理器组件配置为仅单向同步影子。要配置此功能，请将同步 direction 更改为 deviceToCloud 或 cloudToDevice。有关更多信息，请参阅影子管理器组件的方向配置参数。

{
  "strategy": {
    "type": "realTime"
  },
  "synchronize": {
    "coreThing": {
      "classic": true,
      "namedShadows": [
        "MyCoreShadow"
      ]
    },
    "shadowDocuments": [
      {
        "thingName": "MyDevice1",
        "classic": false,
        "namedShadows": [
          "MyShadowA",
          "MyShadowB"
        ]
      },
      {
        "thingName": "MyDevice2",
        "classic": true,
        "namedShadows": [ ]
      }
    ],
    "direction": "betweenDeviceAndCloud"
  }
}

同步本地影子

当 Greengrass 核心设备连接到 Amazon IoT 云端时，影子管理器会对您在组件配置中指定的阴影执行以下任务。行为取决于您指定的影子同步方向配置选项。默认情况下，影子管理器使用 betweenDeviceAndCloud 选项来双向同步影子。如果您使用影子管理器 v2.2.0 或更高版本，则可以将核心设备配置为仅单向（cloudToDevice 或 deviceToCloud）同步影子。

影子合并冲突行为

在某些情况下，例如当核心设备与互联网断开连接时，在影子管理器同步更改之前，本地影子服务和 Amazon IoT 云中的影子可能会发生变化。因此，本地影子服务和 Amazon IoT 云之间的期望状态和报告的状态会有所不同

当影子管理器同步影子时，它会根据以下行为合并更改：