翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Image Builder における Amazon EventBridge の統合

Amazon EventBridge はサーバーレスのイベントバスサービスで、Image Builder アプリケーションと他の AWS のサービスからの関連データを接続するために使用できます。EventBridge では、ルールが受信イベントをマッチングし、処理のためにターゲットに送信します。1 つのルールで複数のターゲットにイベントを送信でき、これらのイベントは並行して実行されます。

EventBridge を使用すると、 を自動化 AWS のサービス し、アプリケーションの可用性の問題やリソースの変更などのシステムイベントに自動的に対応できます。 はイベントを EventBridge にほぼリアルタイムで AWS のサービス 配信します。受信イベントに反応してアクションを開始するルールを設定できます。例えば、EC2 インスタンスが保留から実行に変わったときに、イベントを Lambda 関数に送信します。EventBridge は、これらの一致する定義イベントパターンを呼び出します。イベントパターンに基づいてルールを作成するには、Amazon EventBridge User Guide の Creating Amazon EventBridge rules that react to events を参照してください。

Image Builder は、2 つの独立した方向で EventBridge と連携します。目標に一致するものを選択します。

両方向のstep-by-stepの手順については、「」を参照してくださいImage Builder パイプラインで EventBridge を使用する。イベントカタログについては、「」を参照してくださいImage Builder が送信するイベントメッセージ。

自動的に開始されるアクションには以下のようなものがありまれます。

また、Image Builder パイプラインを実行して四半期ごとにイメージを更新するなど、デフォルトのイベントバスに定期的にアクションを実行するスケジューリングルールを設定することもできます。スケジュール表現には次の 2 種類があります。

EventBridge ルールが Image Builder のイメージパイプラインとどのように統合されるかの詳細については、「Image Builder パイプラインで EventBridge を使用する」を参照してください。

Image Builder が送信するイベントメッセージ

Image Builder は、Image Builder リソースがライフサイクルの重要なポイントに達したときに、デフォルトの EventBridge イベントバスにイベントを送信します。たとえば、イメージの状態が変わったとき、スキャンが完了したとき、ワークフローステップが入力のために一時停止したとき、パイプラインが自動的に無効になったときなどです。すべてのイベントはソース を使用しますaws.imagebuilder。

以下のセクションでは、各イベントについて説明します。Image Builder がイベントを送信するとき、イベント のフィールドdetail、およびresources配列ARNs。これらのイベントに対処するには、「」を参照してくださいImage Builder が送信するイベントへの対応。例のアカウント IDs、リージョン、ARNs、タイムスタンプはプレースホルダーであり、独自のものに置き換えます。

EC2 Image Builder Image State Change

イメージの作成中にイメージリソースの状態が変更されると、Image Builder からこのイベントが送信されます。ある状態から別の状態にイメージのステータスが変わる例には、次のようなものがあります。

{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "EC2 Image Builder Image State Change",
    "source": "aws.imagebuilder",
    "account": "111122223333",
    "time": "2024-01-18T17:50:56Z",
    "region": "us-west-2",
    "resources": ["arn:aws:imagebuilder:us-west-2:111122223333:image/cmkencryptedworkflowtest-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222/1.0.0/1"],
    "detail": {
        "previous-state": {
            "status": "TESTING"
        },
        "state": {
            "status": "AVAILABLE"
        }
    }
}

Image Builder は、上記のビルドトランジション全体で、イメージの作成中にイメージリソースの状態が変化するたびにこのイベントを送信します。

イベントには次のフィールドdetailが含まれます。

ビルド転送ステータス値は、BUILDING、、TESTING、DISTRIBUTING、INTEGRATING、AVAILABLECANCELLED、および ですFAILED。

resources 配列には、状態を変更したイメージリソースの ARN が含まれます。

EC2 Image Builder CVE Detected

イメージで CVE 検出が有効になっていると、イメージスキャンが完了するたびに Image Builder から結果を含むメッセージが送信されます。

{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "EC2 Image Builder CVE Detected",
    "source": "aws.imagebuilder",
    "account": "111122223333",
    "time": "2023-03-01T16:59:09Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:imagebuilder:us-east-1:111122223333:image/test-image/1.0.0/1",
        "arn:aws:imagebuilder:us-east-1:111122223333:image-pipeline/test-pipeline"
    ],
    "detail": {
        "resource-id": "i-1234567890abcdef0",
        "finding-severity-counts": {
            "all": 0,
            "critical": 0,
            "high": 0,
            "medium": 0
        }
    }
}

Image Builder は、イメージスキャンが完了したときに、イメージのイメージスキャン (Amazon Inspector) を有効にした場合にのみ、このイベントを送信します。スキャンがオフの場合、Image Builder はこのイベントを送信しません。スキャンを有効にするには、「」を参照してくださいで Image Builder イメージのセキュリティスキャンを設定する AWS マネジメントコンソール。

イベントには次のフィールドdetailが含まれます。

resources 配列には、イメージリソースの ARN、およびスキャンがパイプラインから実行されたときのイメージパイプラインの ARN が含まれます。

EC2 Image Builder Workflow Step Waiting

非同期アクションの完了を待機するために WaitForAction ワークフローステップが一時停止すると、Image Builder からこのメッセージが送信されます。

{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "EC2 Image Builder Workflow Step Waiting",
    "source": "aws.imagebuilder",
    "account": "111122223333",
    "time": "2024-01-18T16:54:44Z",
    "region": "us-west-2",
    "resources": ["arn:aws:imagebuilder:us-west-2:111122223333:image/workflowstepwaitforactionwithvalidsnstopictest-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222/1.0.0/1", "arn:aws:imagebuilder:us-west-2:111122223333:workflow/build/build-workflow-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333/1.0.0/1"],
    "detail": {
        "workflow-execution-id": "wf-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
        "workflow-step-execution-id": "step-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "workflow-step-name": "TestAutoSNSStop"
    }
}

Image Builder は、WaitForActionワークフローステップが一時停止してレスポンスを待機すると、このイベントを送信します。ワークフローは、応答するか、ステップがタイムアウトするまで一時停止されたままになります。

イベントには次のフィールドdetailが含まれます。

resources 配列には、イメージリソースの ARN とワークフローの ARN が含まれます。

応答するには、イベントworkflow-step-execution-idからの と action の SendWorkflowStepActionを使用して RESUME を呼び出して続行するか、ビルドをSTOP終了します。「WaitForAction」を参照してください。イベントからこれを自動的に処理するには、「」を参照してくださいImage Builder が送信するイベントへの対応。

EC2 Image Builder Image Pipeline の自動無効化

パイプラインautoDisablePolicyに を設定している場合、Image Builder はパイプラインを無効にし、連続するスケジュールされたパイプライン実行失敗の数がポリシーで許可されている最大数を超えたときに EventBridge にイベントメッセージを送信します。

{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "EC2 Image Builder Image Pipeline Automatically Disabled",
    "source": "aws.imagebuilder",
    "account": "111122223333",
    "time": "2025-09-18T16:54:44Z",
    "region": "us-west-2",
    "resources": ["arn:aws:imagebuilder:us-west-2:111122223333:image-pipeline/disabled-image-pipeline-name"],
    "detail": {
        "consecutive-failures": "5"
    }
}

パイプラインのスケジュールautoDisablePolicyで を設定すると、Image Builder はスケジュールされたビルドの連続した失敗をカウントします。カウントがポリシーの に達するとfailureCount、Image Builder はパイプラインを無効にし、このイベントを送信します。

イベントには次のフィールドdetailが含まれます。

resources 配列には、無効にされたパイプラインの ARN が含まれています。