サポート終了通知: 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 Core ソフトウェア v1.0.0 では使用できません。v1.0.0 を使用してデプロイされたグループを削除することはできません。

デプロイのリセットオペレーションは、まず、特定のグループのクラウドに保存されているすべてのデプロイ情報をクリーンアップします。そして、グループのコアデバイスにデプロイ関連のすべての情報を消去するよう指示します (ユーザー定義の `config.json` や Greengrass コア証明書を除く、Lambda 関数、ユーザーログ、シャドウデータベース、サーバー証明書)。グループに現在 `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. **[Deployments]** (デプロイ) タブから、**[Reset deployments]** (デプロイのリセット) を選択します。

1. **[Reset deployments for this Greengrass Group]** (この Greengrass グループのデプロイをリセットする) ダイアログボックスで、**confirm** と入力して同意し、**[Reset deployment]** (デプロイのリセット) を選択します。

## 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 コマンド `reset-deployments` の引数

`--group-id`  
グループ ID。この値を取得するには、`list-groups` コマンドを使用します。

`--force`  
オプション。グループのコアデバイスが紛失、盗難または破壊された場合には、このパラメータを使用します。このオプションでは、コアデバイスのレスポンスを待たずに、すべてのデプロイ情報がクラウドから消去された後でデプロイリセットプロセスから成功の報告を行います。ただし、コアデバイスがアクティブであるか、アクティブになった場合は、クリーンアップオペレーションも実行します。

CLI コマンド `reset-deployments` の出力は次のようになります。

```
{
    "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"
}
```

デプロイのリセット状態は、CLI コマンド `get-deployment-status` で確認できます。

```
aws greengrass get-deployment-status --deployment-id DeploymentId --group-id GroupId
```CLI コマンド `get-deployment-status` の引数

`--deployment-id`  
デプロイ ID。

`--group-id`  
グループ ID。

CLI コマンド `get-deployment-status` の出力は次のようになります。

```
{
    "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)」
+ 「AWS IoT Greengrass Version 1 API リファレンス」の「[GetDeploymentStatus](https://docs.aws.amazon.com/greengrass/v1/apireference/getdeploymentstatus-get.html)」