Amazon ECS イベント

Amazon ECS は、各タスクとサービスの状態を追跡します。タスクまたはサービスの状態が変更されると、イベントが生成され、Amazon に送信されます EventBridge。これらのイベントは、タスク状態変更イベントおよびサービスアクションイベントとして分類されます。各イベントとその考えられる原因については、以下のセクションで詳しく説明します。

Amazon ECS は、 EventBridgeコンテナインスタンス状態変更イベント、タスク状態変更イベント、サービスアクション、サービスデプロイ状態変更イベントといったタイプのイベントを生成して に送信します。

• コンテナインスタンスの状態変更

• タスクの状態変更

• デプロイの状態変更

• サービスアクション

注記

今後、Amazon ECS には他の種類のイベント、ソース、詳細が追加される場合があります。コード内のイベント JSON データを逆シリアル化する場合は、不明なプロパティが追加された場合や追加された場合に問題が発生しないように、アプリケーションが不明なプロパティを処理する準備ができていることを確認してください。

同じアクティビティに対して複数のイベントが生成される場合もあります。例えば、コンテナインスタンスでタスクが開始されると、この新しいタスクに対してタスク状態変更イベントが生成されます。コンテナインスタンスの使用可能なリソース (CPU、メモリ、使用可能なポートなど) の変更に対応するため、コンテナインスタンス状態変更イベントがアカウントに生成されます。同様に、コンテナインスタンスが終了すると、コンテナインスタンス、コンテナエージェント接続ステータス、およびコンテナインスタンスで実行されている各タスクに対してイベントが生成されます。

コンテナ状態変更イベントとタスク状態変更イベントには 2 つの version フィールドがあります。1 つはイベントの本体で、もう 1 つはイベントの detail オブジェクトです。次に、これら 2 つのフィールドの違いについて説明します。

• イベントの本文の version フィールドは、すべてのイベントで 0 に設定されています。 EventBridge パラメータの詳細については、「Amazon EventBridge ユーザーガイド」の「イベントとイベントパターン」を参照してください。

• イベントの detail オブジェクトの version フィールドは、関連付けられているリソースのバージョンについて説明します。リソースの状態が変わるたびに、このバージョンはインクリメントされます。イベントは複数回送信できるため、このフィールドで重複するイベントを識別できます。重複するイベントには、detail オブジェクト内で同じバージョンがあります。Amazon ECS コンテナインスタンスとタスク状態を でレプリケートする場合は EventBridge、Amazon ECS APIs によって報告されたリソースのバージョンと、リソース EventBridge の で報告されたバージョン ( detail オブジェクト内) を比較して、イベントストリームのバージョンが最新であることを確認できます。

サービスアクションイベントには、本体の version フィールドのみが含まれます。

Amazon ECS と を統合する方法の詳細については EventBridge、「Amazon EventBridge と Amazon ECS の統合」を参照してください。