终止支持通知：2026 年 10 月 7 日， AWS 将停止对的支持。 AWS IoT Greengrass Version 1 2026 年 10 月 7 日之后，您将无法再访问这些 AWS IoT Greengrass V1 资源。如需了解更多信息，请访问[迁移自 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)。

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

# 重置部署
<a name="reset-deployments-scenario"></a>

此功能适用于 AWS IoT Greengrass 酷睿 v1.1 及更高版本。

您可能希望重置组的部署以执行以下操作：
+ 删除组，例如当您要将组的核心移至另一个组时，或者组的核心已重新制作了映像时。在删除组之前，您必须重置该组的部署，以便将核心与另一个 Greengrass 组结合使用。
+ 将组的核心移到不同的组。
+ 将组恢复到任何部署之前的状态。
+ 从核心设备删除部署配置。
+ 从核心设备或云中删除敏感数据。
+ 将新的组配置部署到一个核心而不必将该核心替换成当前组中的另一个核心。

**注意**  
 AWS IoT Greengrass 核心软件 v1.0.0 中不支持重置部署功能。您不能删除已使用 v1.0.0 部署的组。

重置部署操作首先会清除存储在云中的指定组的所有部署信息。然后，它将指示该组的核心设备也清理其所有部署相关部署信息（Lambda 函数、用户日志、影子数据库和服务器证书，但不包括用户定义的 `config.json` 或 Greengrass 核心证书。） 如果一个组目前的部署状态为 `In Progress` 或 `Building`，则无法为其启动部署重置。

## 从重置部署 AWS IoT 控制台
<a name="reset-deployments-console"></a>

您可以从 AWS IoT 控制台的群组配置页面重置群组部署。

1. <a name="console-gg-groups"></a>**在 AWS IoT 控制台导航窗格的**管理**下，展开 **Greengrass** 设备，然后选择群组 (V1)。**

1. 选择目标组。

1. 在 **部署** 选项卡中，选择 **重置部署**。

1. 在**重置此 Greengrass 组的部署**对话框中，键入 **confirm** 以表示同意，然后选择**重置部署**。

## 使用重置部署 AWS IoT Greengrass API
<a name="reset-deployments-api"></a>

您可以使用 AWS CLI、 AWS IoT Greengrass API 或 AWS SDK 中的`ResetDeployments`操作来重置部署。本主题中的示例使用 CLI。

```
aws greengrass reset-deployments --group-id {{GroupId}} [--force]
````重置部署 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-id {{DeploymentId}} --group-id {{GroupId}}
```获取部署`状态 CLI 命令的参数`：

`--deployment-id`  
部署 ID。

`--group-id`  
组 ID。

`get-deployment-status` CLI 命令的输出如下所示：

```
{
    "DeploymentStatus": "Success",
    "UpdatedAt": "2017-04-04T00:00:00.000Z"
}
```

当重置部署正在准备时，`DeploymentStatus` 设置为 `Building`。当重置部署准备就绪但 AWS IoT Greengrass 核心尚未启动重置部署时，则`DeploymentStatus`为`InProgress`。

如果重置操作失败，将在响应中返回错误信息。

## 另请参阅
<a name="reset-deployments-see-also"></a>
+ [部署 AWS IoT Greengrass 分组到 AWS IoT Greengrass core](deployments.md)
+ [ResetDeployments ](https://docs.aws.amazon.com/greengrass/v1/apireference/resetdeployments-post.html)在 *AWS IoT Greengrass Version 1 API 参考*中
+ [GetDeploymentStatus](https://docs.aws.amazon.com/greengrass/v1/apireference/getdeploymentstatus-get.html)在 *AWS IoT Greengrass Version 1 API 参考*中