サポート終了通知: 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)」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# デプロイ通知の取得
Amazon EventBridge イベントルールを使用して、Greengrass グループのデプロイの状態変更に関する通知を受け取ることができます。EventBridge は、 AWS リソースの変更を説明するシステムイベントのほぼリアルタイムのストリームを配信します。 は、これらのイベントを少なくとも *1 回* EventBridge AWS IoT Greengrass に送信します。つまり、 は、配信を確実にするために、特定のイベントの複数のコピーを送信する AWS IoT Greengrass 可能性があります。さらに、イベントリスナーは、イベントが発生した順序でイベントを受信しない場合があります。
**注記**
Amazon EventBridge は、アプリケーションを [Greengrass Core デバイス](telemetry.md)やデプロイ通知などのさまざまなソースのデータに接続するために使用できるイベントバスサービスです。詳細については、「*Amazon EventBridge ユーザーガイド*」の「[Amazon EventBridge とは](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html)」を参照してください。
AWS IoT Greengrass グループデプロイの状態が変わると、 はイベントを発行します。すべての状態遷移または指定した状態への移行に対して実行される EventBridge ルールを作成できます。デプロイがルールを開始する状態になると、EventBridge はルールで定義されたターゲットアクションを呼び出します。これにより、通知を送信したり、イベント情報をキャプチャしたり、修正アクションを実行したり、状態の変更に応じて他のイベントを開始したりできます。例えば、次のユースケースのルールを作成できます。
+ アセットのダウンロードや担当者の通知など、デプロイ後のオペレーションを開始します。
+ デプロイの成功または失敗時に通知を送信します。
+ デプロイイベントに関するカスタムメトリクスを発行します。
AWS IoT Greengrass は、デプロイが `Building`、`InProgress`、、`Success`および の状態になるとイベントを発行します`Failure`。
**注記**
[一括デプロイ](bulk-deploy-cli.md) オペレーションのステータスのモニタリングは、現在サポートされていません。ただし、 は、一括デプロイの一部である個々のグループデプロイの状態変更イベント AWS IoT Greengrass を発行します。
## グループデプロイステータスの変更イベント
デプロイ状態変更の[イベント](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html)では、次の形式を使用します。
```
{
"version":"0",
"id":" cd4d811e-ab12-322b-8255-EXAMPLEb1bc8",
"detail-type":"Greengrass Deployment Status Change",
"source":"aws.greengrass",
"account":"123456789012",
"time":"2018-03-22T00:38:11Z",
"region":"us-west-2",
"resources":[],
"detail":{
"group-id": "284dcd4e-24bc-4c8c-a770-EXAMPLEf03b8",
"deployment-id": "4f38f1a7-3dd0-42a1-af48-EXAMPLE09681",
"deployment-type": "NewDeployment|Redeployment|ResetDeployment|ForceResetDeployment",
"status": "Building|InProgress|Success|Failure"
}
}
```
1 つ以上のグループに適用するルールを作成できます。次の 1 つ以上のデプロイタイプとデプロイの状態でルールをフィルタリングできます。
**デプロイタイプ**
+ `NewDeployment`。グループバージョンの最初のデプロイ。
+ `ReDeployment`。グループバージョンの再デプロイ。
+ `ResetDeployment`。 AWS クラウド および AWS IoT Greengrass コアに保存されているデプロイ情報を削除します。詳細については、「[デプロイのリセット](reset-deployments-scenario.md)」を参照してください。
+ `ForceResetDeployment`。 AWS クラウド に保存されているデプロイ情報を削除し、コアが応答するのを待たずに成功を報告します。また、コアが接続されている場合、または次に接続するときに、コアに保存されているデプロイ情報も削除します。
**デプロイの状態**
+ `Building`. AWS IoT Greengrass はグループ設定を検証し、デプロイアーティファクトを構築しています。
+ `InProgress`。 デプロイは AWS IoT Greengrass コアで進行中です。
+ `Success`。デプロイに成功しました。
+ `Failure`。デプロイに失敗しました。
イベントが重複したり、順序が順不同である可能性があります。イベントの順序を特定するには、`time` プロパティを使用します。
**注記**
AWS IoT Greengrass は `resources`プロパティを使用しないため、常に空です。
## EventBridge ルールを作成するための前提条件
の EventBridge ルールを作成する前に AWS IoT Greengrass、次の操作を行います。
+ EventBridge のイベント、ルール、ターゲットに精通しておいてください。
+ EventBridge ルールによって呼び出されるターゲットを作成して設定します。ルールは、以下のようなさまざまなタイプのターゲットを呼び出すことができます。
+ Amazon Simple Notification Service (Amazon SNS)
+ AWS Lambda 関数
+ Amazon Kinesis Video Streams
+ Amazon Simple Queue Service (Amazon SQS) キュー
詳細については、「*Amazon EventBridge ユーザーガイド*」の「[Amazon EventBridge とは](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html)」および「[Amazon EventBridge の開始方法](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-getting-set-up.html)」を参照してください。
## デプロイ通知の設定 (コンソール)
グループのデプロイ状態が変更されたときに Amazon SNS トピックを発行する EventBridge ルールを作成するには、次のステップを使用します。これにより、ウェブサーバー、E メールアドレス、その他のトピック受信者がイベントに応答できるようになります。詳細については、「Amazon [ EventBridge ユーザーガイド」の「Creating a EventBridge rule that triggers on an event from an AWS resource](https://docs.aws.amazon.com/eventbridge/latest/userguide/create-eventbridge-rule.html)」を参照してください。 * EventBridge *
1. [Amazon EventBridge コンソール](https://console.aws.amazon.com/events/)を開きます。
1. ナビゲーションペインで **[ルール]** を選択します。
1. **[ルールの作成]** を選択します。
1. ルールの名前と説明を入力します。
ルールには同じリージョン内および同じイベントバス上の別のルールと同じ名前を付けることはできません。
1. **[イベントバス]** で、このルールに関連付けるイベントバスを選択します。このルールをアカウントからのイベントと一致させるには、**AWS のデフォルトのイベントバス**を選択します。アカウントの AWS サービスがイベントを発行すると、常にアカウントのデフォルトのイベントバスに送られます。
1. **[ルールタイプ]** で、**[イベントパターンを持つルール]** を選択してください。
1. [**次へ**] を選択します。
1. **[イベントソース]** で、**[AWS のサービス]** を選択します。
1. **[イベントパターン]** で、**[AWS のサービス]** を選択します。
1. **[AWS のサービス]** で、[Greengrass] を選択します。
1. **[イベントタイプ]** で、**[Greengrass デプロイステータスの変更]** を選択します。
**注記**
**AWS CloudTrail イベントタイプを介した API コール**は、 と AWS IoT Greengrass の統合に基づいています AWS CloudTrail。このオプションを使用して、 AWS IoT Greengrass API への読み取りまたは書き込み呼び出しによって開始されるルールを作成できます。詳細については、「[を使用した AWS IoT Greengrass API コールのログ記録 AWS CloudTrail](logging-using-cloudtrail.md)」を参照してください。
1. 通知を開始するデプロイ状態を選択します。
+ すべての状態変更イベントの通知を受信するには、[**Any state (すべての状態)**] を選択します。
+ 一部の状態変更イベントの通知のみを受信するには、**[特定の状態]** を選択してから、対象とする状態を選択します。
1. 通知を開始するデプロイタイプを選択します。
+ すべてのデプロイタイプの通知を受信するには、**[すべての状態]** を選択します。
+ 一部のデプロイタイプの通知のみを受信するには、**[特定の状態]** を選択してから、対象とするデプロイタイプを選択します。
1. [**次へ**] を選択します。
1. **[ターゲットタイプ]** で、**[AWS のサービス]** を選択します。
1. **[ターゲットの選択]** で、ターゲットを設定します。この例では Amazon SNS トピックを使用していますが、通知を送信するターゲットタイプには他のトピックも設定できます。
1. [**Target (ターゲット)**] で [**SNS topic (SNS トピック)**] を選択します。
1. **[トピック]** で、ターゲットトピックを選択します。
1. [**次へ**] を選択します。
1. **[Tags]** (タグ) で、ルールのタグを定義するか、フィールドを空のままにします。
1. **[次へ]** を選択します。
1. ルールの詳細を確認し、**ルールの作成** を選択します。
## デプロイ通知の設定 (CLI)
グループのデプロイ状態が変更されたときに Amazon SNS トピックを発行する EventBridge ルールを作成するには、次のステップを使用します。これにより、ウェブサーバー、E メールアドレス、その他のトピック受信者がイベントに応答できるようになります。
1. ルールを作成します。
+ *group-id* を AWS IoT Greengrass グループの ID に置き換えます。
```
aws events put-rule \
--name TestRule \
--event-pattern "{\"source\": [\"aws.greengrass\"], \"detail\": {\"group-id\": [\"group-id\"]}}"
```
パターンで省略されたプロパティは無視されます。
1. トピックをルールターゲットとして追加します。
+ *topic-arn* を Amazon SNS トピックの ARN に置き換えます。
```
aws events put-targets \
--rule TestRule \
--targets "Id"="1","Arn"="topic-arn"
```
**注記**
Amazon EventBridge にターゲットトピックの呼び出しを許可するには、トピックにリソースベースのポリシーを追加する必要があります。詳細については、*Amazon EventBridge ユーザーガイド*の「[Amazon SNS のアクセス許可](https://docs.aws.amazon.com/eventbridge/latest/userguide/resource-based-policies-eventbridge.html#sns-permissions)」を参照してください。
詳細については、「*Amazon EventBridge ユーザーガイド*」の「[EventBridge のイベントとイベントパターン](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html)」を参照してください。
## デプロイ通知の設定 (CloudFormation)
CloudFormation テンプレートを使用して、Greengrass グループデプロイの状態変更に関する通知を送信する EventBridge ルールを作成します。詳細については、「*AWS CloudFormation ユーザーガイド*」の「[Amazon EventBridge resource type reference](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_Events.html)」を参照してください。
## 関連情報
+ [AWS IoT Greengrass コアに AWS IoT Greengrass グループをデプロイする](deployments.md)
+ 「*Amazon EventBridge ユーザーガイド*」の「[What is Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html)」