EventBridge

【VPC外リージョンサービス】

EventBridge は、サーバーレスの Event Bus（イベントバス） サービスです。

AWS Service Events（AWSサービスイベント）、Partner Events（パートナーイベント）、および Custom Events（カスタムイベント） を統合的に受け取ることができます。また、アプリケーションから PutEvents API を使用して独自の Event を送信することも可能です。

受信したEvent（イベント） は、Event Pattern（イベントパターン） を定義した Rule（ルール） に基づいて評価され、指定された Target（ターゲット） へルーティングされます。 Target には、Lambda、Step Functions、SNS、SQS、ECS、EKS、Kinesis Data Streams／Firehose、および外部API連携を行う API Destination などを指定することができます。

EventBridge は、Schema Registry（スキーマレジストリ） によりイベント構造をスキーマとして自動検出・管理し、型定義に基づいた開発を支援します。さらに、Event Archive（イベントアーカイブ） によって過去のイベントを保存し、Event Replay（イベント再送信） を利用して再処理やテストに活用することができます。また、イベント処理に失敗した場合には DLQ（Dead Letter Queue） に退避し、再試行や原因分析を行うことが可能です。

EventBridge は疎結合でスケーラブルなイベント駆動アーキテクチャを容易に実現し、監査・再処理・SaaS統合など多様なユースケースに柔軟に対応します。

重要用語

ユースケース

ベストプラクティス

高可用性・バックアップ・リトライ

セキュリティ

EventBridge が実行ロールを引き受ける典型的な連携パターン

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "events.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

リソースベースポリシーによる補完

実行ロールで不足する権限をEventBridge のリソースベースポリシーで補うパターン

ログ・監視

標準メトリクス

制限値（固定値／ハードリミット／ソフトリミット）

AWS CLIのサンプルコード

パターン1: EC2状態変更 → Lambda

実行ロールを作成する（信頼ポリシーのファイル名 指定）

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "events.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

aws iam create-role \
    --role-name EventBridgeToLambdaRole \
    --assume-role-policy-document file://eventbridge-trust-policy.json

実行ロールを表示する

aws iam list-roles

実行ロールを削除する（実行ロール名 指定）

aws iam list-attached-role-policies \
  --role-name EventBridgeToLambdaRole

実行ロールにAWS管理ポリシーをアタッチする（実行ロール名、ポリシーのARN 指定）

aws iam attach-role-policy \
    --role-name EventBridgeToLambdaRole \
    --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole

実行ロールからAWS管理ポリシーをデタッチする（実行ロール名、ポリシーのARN 指定）

aws iam detach-role-policy \
    --role-name EventBridgeToLambdaRole \
    --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole

イベントルールを作成する（イベントパターンファイル名 指定）

{
  "source": ["aws.ec2"],
  "detail-type": ["EC2 Instance State-change Notification"],
  "detail": {
    "state": ["running", "stopped", "terminated"]
  }
}

aws events put-rule \
    --name ec2-state-change-rule \
    --event-pattern file://event-patterns/ec2-state-change.json

イベントルールを表示する

aws events list-rules

イベントルールを削除する（ルール名 指定）

aws events delete-rule \
  --name ec2-state-change-rule

EventBridge がLambda関数を呼び出すことを許可するリソースベースポリシーを作成する
（Lambda関数名、EventBridgeのARN 指定）

aws lambda add-permission \
    --function-name my-ec2-handler \
    --statement-id AllowEventBridgeInvoke \
    --action lambda:InvokeFunction \
    --principal events.amazonaws.com \
    --source-arn arn:aws:events:ap-northeast-1:123456789012:rule/ec2-state-change-rule

リソースベースポリシーを表示する（Lambda関数名 指定）

aws lambda get-policy \
  --function-name my-ec2-handler

リソースベースポリシーを削除する
（Lambda関数名、ステートメントID 指定）

aws lambda remove-permission \
    --function-name my-ec2-handler \
    --statement-id AllowEventBridgeInvoke

ターゲットを追加する（ルール名、ターゲットファイル名 指定）

[
  {
    "Id": "1",
    "Arn": "arn:aws:lambda:ap-northeast-1:123456789012:function:my-ec2-handler",
    "Input": "{\"notification_type\": \"ec2_state_change\"}"
  }
]

aws events put-targets \
    --rule ec2-state-change-rule \
    --targets file://targets/lambda-target.json

ターゲットを表示する（ルール名 指定）

aws events list-targets-by-rule \
  --rule ec2-state-change-rule

ターゲットを削除する（ルール名 ターゲットID 指定）

aws events remove-targets \
    --rule ec2-state-change-rule \
    --ids "1"

パターン2: ECSタスク状態変更 → SNS

SNSトピックを作成する

aws sns create-topic \
  --name ecs-task-notifications

EventBridge がSNSを呼び出すことを許可するリソースベースポリシーを作成する
（SNSトピックのARN、ポリシーファイル名 指定）

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowEventBridgeToPublish",
      "Effect": "Allow",
      "Principal": {
        "Service": "events.amazonaws.com"
      },
      "Action": "SNS:Publish",
      "Resource": "arn:aws:sns:ap-northeast-1:123456789012:ecs-task-notifications"
    }
  ]
}

aws sns set-topic-attributes \
    --topic-arn arn:aws:sns:ap-northeast-1:123456789012:ecs-task-notifications \
    --attribute-name Policy \
    --attribute-value file://sns-policy.json

イベントルールを作成する（イベントパターンファイル名 指定）

{
  "source": ["aws.ecs"],
  "detail-type": ["ECS Task State Change"],
  "detail": {
    "lastStatus": ["STOPPED"],
    "stoppedReason": ["Essential container in task exited"]
  }
}

aws events put-rule \
    --name ecs-task-state-change-rule \
    --event-pattern file://event-patterns/ecs-task-state-change.json

ターゲットを追加する（ルール名、ターゲットファイル名 指定）

[
  {
    "Id": "1",
    "Arn": "arn:aws:sns:ap-northeast-1:123456789012:ecs-task-notifications",
    "InputTransformer": {
      "InputPathsMap": {
        "taskArn": "$.detail.taskArn",
        "stoppedReason": "$.detail.stoppedReason",
        "clusterArn": "$.detail.clusterArn"
      },
      "InputTemplate": "\"ECSタスクが停止しました。\\nタスクARN: <taskArn>\\n理由: <stoppedReason>\\nクラスター: <clusterArn>\""
    }
  }
]

aws events put-targets \
    --rule ecs-task-state-change-rule \
    --targets file://targets/sns-target.json

パターン3: S3オブジェクト作成 → SQS

SQSキューを作成する

aws sqs create-queue \
  --queue-name s3-event-queue

EventBridge がSQSを呼び出すことを許可するリソースベースポリシーを作成する
（SQSキューのURL、ポリシーファイル名 指定）

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowEventBridgeToSendMessage",
      "Effect": "Allow",
      "Principal": {
        "Service": "events.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "arn:aws:sqs:ap-northeast-1:123456789012:s3-event-queue",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:events:ap-northeast-1:123456789012:rule/s3-object-created-rule"
        }
      }
    }
  ]
}

aws sqs set-queue-attributes \
    --queue-url https://sqs.ap-northeast-1.amazonaws.com/123456789012/s3-event-queue \
    --attributes file://sqs-policy.json

S3バケットでEventBridge通知を有効化する
（S3バケット名、S3通知設定ファイル 指定）

{
  "EventBridgeConfiguration": {}
}

aws s3api put-bucket-notification-configuration \
    --bucket my-source-bucket \
    --notification-configuration file://s3-notification-config.json

イベントルールを作成する（イベントパターンファイル名）

{
  "source": ["aws.s3"],
  "detail-type": ["Object Created"],
  "detail": {
    "bucket": {
      "name": ["my-source-bucket"]
    },
    "object": {
      "key": [{
        "prefix": "uploads/"
      }]
    }
  }
}

aws events put-rule \
    --name s3-object-created-rule \
    --event-pattern file://event-patterns/s3-object-created.json

ターゲットを追加する（ルール名、ターゲットファイル名 指定）

[
  {
    "Id": "1",
    "Arn": "arn:aws:sqs:ap-northeast-1:123456789012:s3-event-queue"
  }
]

aws events put-targets \
    --rule s3-object-created-rule \
    --targets file://targets/sqs-target.json

パターン4: CloudTrail (API呼び出し) → Lambda

CloudTrailの設定を確認する

CloudTrailが有効で、EventBridgeと統合されていることを確認する

実行ロールを作成する（信頼ポリシーのファイル名 指定）

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "events.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

aws iam create-role \
    --role-name EventBridgeToLambdaRole \
    --assume-role-policy-document file://eventbridge-trust-policy.json

イベントルールを作成する（イベントパターンファイル名 指定）

{
  "source": ["aws.s3"],
  "detail-type": ["AWS API Call via CloudTrail"],
  "detail": {
    "eventSource": ["s3.amazonaws.com"],
    "eventName": ["DeleteBucket", "DeleteBucketPolicy"]
  }
}

aws events put-rule \
    --name cloudtrail-s3-delete-rule \
    --event-pattern file://event-patterns/cloudtrail-s3-delete.json

EventBridge がLambda関数を呼び出すことを許可するリソースベースポリシーを作成する
（Lambda関数名、EventBridgeのARN 指定）

aws lambda add-permission \
    --function-name security-alert-handler \
    --statement-id AllowEventBridgeInvokeFromCloudTrail \
    --action lambda:InvokeFunction \
    --principal events.amazonaws.com \
    --source-arn arn:aws:events:ap-northeast-1:123456789012:rule/cloudtrail-s3-delete-rule

ターゲットを追加する（ターゲットファイル名 指定）

[
  {
    "Id": "1",
    "Arn": "arn:aws:lambda:ap-northeast-1:123456789012:function:security-alert-handler"
  }
]

aws events put-targets \
    --rule cloudtrail-s3-delete-rule \
    --targets file://targets/lambda-security-target.json

パターン5: CodePipeline状態変更 → Step Functions

実行ロールを作成する（信頼ポリシーのファイル名 指定）

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "events.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

aws iam create-role \
    --role-name EventBridgeToStepFunctionsRole \
    --assume-role-policy-document file://eventbridge-trust-policy.json

カスタム管理ポリシーを作成する（ポリシーファイル名 指定）

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:StartExecution"
      ],
      "Resource": "arn:aws:states:ap-northeast-1:123456789012:stateMachine:pipeline-notification-workflow"
    }
  ]
}

aws iam create-policy \
  --policy-name StepFunctionsExecutionPolicy \
  --policy-document file://stepfunctions-policy.json

実行ロールにカスタム管理ポリシーをアタッチする（実行ロール名、ポリシーのARN 指定）

aws iam attach-role-policy \
  --role-name EventBridgeToStepFunctionsRole \
  --policy-arn arn:aws:iam::123456789012:policy/StepFunctionsExecutionPolicy

イベントルールを作成する（イベントパターンファイル名 指定）

{
  "source": ["aws.codepipeline"],
  "detail-type": ["CodePipeline Pipeline Execution State Change"],
  "detail": {
    "state": ["SUCCEEDED", "FAILED"],
    "pipeline": ["my-application-pipeline"]
  }
}

aws events put-rule \
    --name codepipeline-state-change-rule \
    --event-pattern file://event-patterns/codepipeline-state-change.json

ターゲットを追加する（ターゲットファイル名 指定）

[
  {
    "Id": "1",
    "Arn": "arn:aws:states:ap-northeast-1:123456789012:stateMachine:pipeline-notification-workflow",
    "RoleArn": "arn:aws:iam::123456789012:role/EventBridgeToStepFunctionsRole",
    "Input": "{\"pipeline_name\": \"my-application-pipeline\", \"notification_enabled\": true}"
  }
]

aws events put-targets \
    --rule codepipeline-state-change-rule \
    --targets file://targets/stepfunctions-target.json

パターン6: S3オブジェクト作成 → ECSタスク起動

実行ロールを作成する（信頼ポリシーのファイル名 指定）

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "events.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

aws iam create-role \
    --role-name EventBridgeToECSRole \
    --assume-role-policy-document file://eventbridge-trust-policy.json

カスタム管理ポリシーを作成する（ポリシーファイル名 指定）

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ecs:RunTask"
      ],
      "Resource": "arn:aws:ecs:ap-northeast-1:123456789012:task-definition/data-processing-task:*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "iam:PassRole"
      ],
      "Resource": [
        "arn:aws:iam::123456789012:role/ecsTaskExecutionRole",
        "arn:aws:iam::123456789012:role/ecsTaskRole"
      ]
    }
  ]
}

aws iam create-policy \
  --policy-name ECSTaskExecutionPolicy \
  --policy-document file://ecs-execution-policy.json

実行ロールにカスタム管理ポリシーをアタッチする（実行ロール名、ポリシーのARN 指定）

aws iam attach-role-policy \
  --role-name EventBridgeToECSRole \
  --policy-arn arn:aws:iam::123456789012:policy/ECSTaskExecutionPolicy

S3バケットでEventBridge通知を有効化する
（S3バケット名、S3通知設定ファイル 指定）

{
  "EventBridgeConfiguration": {}
}

aws s3api put-bucket-notification-configuration \
    --bucket my-data-bucket \
    --notification-configuration file://s3-notification-config.json

イベントルールを作成する（イベントパターンファイル名 指定）

{
  "source": ["aws.s3"],
  "detail-type": ["Object Created"],
  "detail": {
    "bucket": {
      "name": ["my-data-bucket"]
    },
    "object": {
      "key": [{
        "suffix": ".csv"
      }]
    }
  }
}

aws events put-rule \
    --name s3-data-processing-rule \
    --event-pattern file://event-patterns/s3-data-upload.json

ターゲットを追加する（ターゲットファイル名）

[
  {
    "Id": "1",
    "Arn": "arn:aws:ecs:ap-northeast-1:123456789012:cluster/data-processing-cluster",
    "RoleArn": "arn:aws:iam::123456789012:role/EventBridgeToECSRole",
    "EcsParameters": {
      "TaskDefinitionArn": "arn:aws:ecs:ap-northeast-1:123456789012:task-definition/data-processing-task:3",
      "TaskCount": 1,
      "LaunchType": "FARGATE",
      "NetworkConfiguration": {
        "awsvpcConfiguration": {
          "Subnets": [
            "subnet-0123456789abcdef0",
            "subnet-0123456789abcdef1"
          ],
          "SecurityGroups": [
            "sg-0123456789abcdef0"
          ],
          "AssignPublicIp": "DISABLED"
        }
      },
      "PlatformVersion": "LATEST"
    },
    "InputTransformer": {
      "InputPathsMap": {
        "bucket": "$.detail.bucket.name",
        "key": "$.detail.object.key"
      },
      "InputTemplate": "{\"containerOverrides\": [{\"name\": \"data-processor\",\"environment\": [{\"name\": \"S3_BUCKET\",\"value\": \"<bucket>\"},{\"name\": \"S3_KEY\",\"value\": \"<key>\"}]}]}"
    }
  }
]

aws events put-targets \
    --rule s3-data-processing-rule \
    --targets file://targets/ecs-task-target.json

CloudFormationのサンプルコード

Terraformのサンプルコード

料金計算

公式ページ