支援終止通知：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 Core 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]
````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` 命令檢查重設政策的狀態。

```
aws greengrass get-deployment-status --deployment-id {{DeploymentId}} --group-id {{GroupId}}
````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`。當重設部署準備就緒，但 AWS IoT Greengrass 核心尚未取得重設部署時， `DeploymentStatus`為 `InProgress`。

如果重設操作失敗，在回應中會傳回錯誤資訊。

## 另請參閱
<a name="reset-deployments-see-also"></a>
+ [將 AWS IoT Greengrass 群組部署至 AWS IoT Greengrass 核心](deployments.md)
+ *AWS IoT Greengrass Version 1 API 參考*中的 [ResetDeployments ](https://docs.aws.amazon.com/greengrass/v1/apireference/resetdeployments-post.html) 
+ API *AWS IoT Greengrass Version 1 參考*中的 [GetDeploymentStatus ](https://docs.aws.amazon.com/greengrass/v1/apireference/getdeploymentstatus-get.html)