Amazon IoT Greengrass Version 1在 2023 年 6 月 30 日之前，将不再接收功能更新，并且将仅收到安全补丁和错误修复。有关更多信息，请参阅Amazon IoT Greengrass V1维护时段。我们强烈建议您迁移到Amazon IoT Greengrass Version 2，这增加了重要的新功能并支持其他平台。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
重置部署
此功能适用于以下项Amazon IoT Greengrass核心 v1.1 及更高版本。
您可能希望重置组的部署以执行以下操作：
-
删除该组，例如当您要将组的核心移至另一个组，或者该组的核心已重新映像时。在删除组之前，您必须重置该组的部署，以便将该核心与另一个 Greengrass 组一起使用。
-
将组的核心移到不同的组。
-
将组恢复到任何部署之前的状态。
-
从核心设备删除部署配置。
-
从核心设备或云中删除敏感数据。
-
将新的组配置部署到一个核心而不必将该核心替换成当前组中的另一个核心。
Amazon IoT Greengrass 核心软件 v1.0.0 中不支持重置部署功能。您不能删除已使用 v1.0.0 部署的组。
重置部署操作首先会清除存储在云中的指定组的所有部署信息。然后，它将指示该组的核心设备也清理其所有部署相关信息 (Lambda 函数、用户日志、影子数据库和服务器证书，但不包括用户定义的config.json或格林格拉斯核心证书）。如果一个组目前的部署状态为 In Progress 或 Building，则无法为其启动部署重置。
从 中重置部署Amazon IoT控制台
您可以在中的组配置页面中重置组部署Amazon IoT控制台。
使用 Amazon IoT Greengrass API 重置部署
您可以使用 Amazon CLI、Amazon IoT Greengrass API 或 Amazon 开发工具包中的 ResetDeployments 操作来重置部署。本主题中的示例使用 CLI。
aws greengrass reset-deployments --group-idGroupId[--force]
reset-deployments CLI 命令的参数：
--group-id-
组 ID。使用
list-groups命令以获取此值。 --force-
可选。如果组的核心设备丢失、被盗或损毁，则使用此参数。该选项可使重置部署过程在云中的所有部署信息都清理完后即报告成功，而不必等待核心设备响应。但是，如果核心设备处于或变为活动状态，它还会执行清理操作。
reset-deployments CLI 命令的输出如下所示：
{ "DeploymentId": "4db95ef8-9309-4774-95a4-eea580b6ceef", "DeploymentArn": "arn:aws:greengrass:us-west-2:106511594199:/greengrass/groups/b744ed45-a7df-4227-860a-8d4492caa412/deployments/4db95ef8-9309-4774-95a4-eea580b6ceef" }
可以使用 get-deployment-status CLI 命令查看重置部署的状态：
aws greengrass get-deployment-status --deployment-idDeploymentId--group-idGroupId
get-deployment-status CLI 命令的参数：
--deployment-id-
部署 ID。
--group-id-
组 ID。
get-deployment-status CLI 命令的输出如下所示：
{ "DeploymentStatus": "Success", "UpdatedAt": "2017-04-04T00:00:00.000Z" }
当重置部署正在准备时，DeploymentStatus 设置为 Building。当重置部署已准备就绪，但Amazon IoT Greengrasscore 未选择重置部署，DeploymentStatus是InProgress.
如果重置操作失败，将在响应中返回错误信息。
另请参阅
-
ResetDeployments 中的Amazon IoT Greengrass Version 1API 参考
-
GetDeploymentStatus 中的Amazon IoT Greengrass Version 1API 参考