バスの作成

たとえばCreateEventBus、 を使用してバスを作成しますaws eventsv2 create-event-bus --name orders。名前は唯一の必須パラメータです。作成時に、説明、バスがイベントを保持する日数、イベントを暗号化する AWS KMS キー、タグを設定することもできます。呼び出しは、 CREATING 状態のバスとともに一度に戻ります。 が DescribeEventBusを報告すると、バスに発行するか、サブスクライバーを作成しますACTIVE。

を使用したバスの作成 AWS CLI

次のコマンドは、イベントordersを 30 日間保持し、 AWS KMS キーで暗号化し、1 つのタグを保持する という名前のバスを作成します。

aws eventsv2 create-event-bus \
    --name orders \
    --description "Order events from the checkout service" \
    --storage-configuration RetentionPeriodInDays=30 \
    --encryption-configuration KmsKeyIdentifier=arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab \
    --tags team=orders

次の表に、各パラメータが受け入れる内容を示します。

パラメータ	受け入れること
--name	必須。1～256 文字: 文字、数字、ピリオド、ハイフン、アンダースコア。文字または数字で始まります。名前はリージョンのアカウントで一意である必要があります。同じ名前の 2 番目のバスの作成は で失敗しますResourceAlreadyExistsException。
--description	最大 512 文字。
--storage-configuration	RetentionPeriodInDays、1～365。これを省略すると、バスはイベントを 1 日間保持します。期間を後で で変更できますUpdateEventBus。「保持期間の選択」を参照してください。
--encryption-configuration	KmsKeyIdentifier: AWS KMS カスタマーマネージドキーのキー ID、キー ARN、エイリアス名、またはエイリアス ARN。これを省略すると、EventBridge は AWS 所有のキーを使用してイベントを暗号化します。キーに必要なキーポリシーについては、「」を参照してくださいカスタムイベントバスでのイベントの暗号化。
--tags	値へのタグキーのマップ。例: team=orders,env=prod。タグベースのアクセスコントロールについては、「」を参照してくださいカスタムイベントバスのアクション、リソース、および条件キー。

レスポンスはバス ARN を返します。これは、バスのそれ以降の呼び出しごとに使用されます。ARN は EventBridge が生成する識別子で終わるため、名前から構築することはできません。

{
    "EventBusArn": "arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef",
    "Name": "orders",
    "Description": "Order events from the checkout service",
    "EncryptionConfiguration": {
        "KmsKeyIdentifier": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
    },
    "StorageConfiguration": {
        "RetentionPeriodInDays": 30,
        "RetentionWindowStartTime": "2026-09-21T16:00:00+00:00"
    },
    "State": "CREATING",
    "CreationTime": "2026-09-21T16:00:00+00:00"
}

が になるまで、ARN でバスを記述StateしますACTIVE。

aws eventsv2 describe-event-bus \
    --event-bus-arn arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef

CloudFormation 代わりに を使用してバスを作成するには、「」を参照してくださいを使用したカスタムイベントバスリソースの作成 CloudFormation。バスの作成と記述に必要な IAM アクションについては、「」を参照してくださいカスタムイベントバスのアクション、リソース、および条件キー。

保持期間の選択

バスは、 で受け入れるすべてのイベントを 1 日から 365 日までの日数保持します。 は省略しStorageConfiguration.RetentionPeriodInDays、バスはイベントを 1 日間保持します。保持は、サブスクライバーが過去の時点から開始し、イベントを失うことなく一時停止および再開し、障害後にイベントを再度読み取ることを可能にするものです。期間が長いほど、ストレージのコストが増加します。期間を後で で変更できますUpdateEventBus。

aws eventsv2 create-event-bus \
    --name orders \
    --storage-configuration RetentionPeriodInDays=30

DescribeEventBus はRetentionWindowStartTime、サブスクライバーが読み取れる最も早いポイントである を返します。保持されたイベントをサブスクライバーに配信するには、「」を参照してください保持されたイベントをサブスクライバーに再生する。

バスの状態とそれぞれの許可

バスの作成、更新、削除は非同期です。以外のすべての状態は一部のオペレーションACTIVEを拒否し、3 つの失敗した状態にはその理由StateReasonを示す があります。次の表に、バスが通過する状態と、それぞれで実行できる操作を示します。

State	バスの到着方法	できること
CREATING	CreateEventBus が返され、バスがセットアップされています。	説明して待機します。バスを公開、更新、または削除したり、バスにサブスクライバーまたはイベントソースを作成したりすることはできません。
ACTIVE	作成または更新が完了しました。	すべて: 発行、サブスクライバーとイベントソースの作成、更新、共有、削除。
CREATE_FAILED	作成に失敗しました。これは、EventBridge が指定した AWS KMS キーを使用できないときに発生します。	バスを削除します。他には何も受け入れられません。を読みStateReason、キーまたはそのポリシーを修正して、バスを再度作成します。
UPDATING	UpdateEventBus は暗号化設定を変更しています。その他の更新はこの状態をパススルーしません。	通常どおりにパブリッシュして配信します。バスは、 に戻るまで更新または削除することはできませんACTIVE。
UPDATE_FAILED	EventBridge がキーを使用できなかったため、暗号化の更新が再度失敗しました。	バスは以前の設定で実行され続けます。原因を修正した後で更新を再試行するか、バスを削除します。
DELETING	DeleteEventBus が返されました。	待ちます。削除されるバスにサブスクライバーまたはイベントソースを作成することはできません。
DELETE_FAILED	削除により、取り消されていないサブスクライバーまたはイベントソースが見つかりました。	サブスクライバーとイベントソースが削除または取り消されたら、バスを再度削除します。他には何も受け入れられません。

サブスクライバーを持つバスの削除

DeleteEventBus は、バス上のすべてのサブスクライバーとイベントソースが削除または取り消された場合にのみ成功します。別のアカウントが作成したサブスクライバーがカウントされます。そのアカウントのサブスクライバーを自分で削除することはできません。そのため、所有者に削除を依頼するか、 で取り消しますRevokeResource。「」を参照してくださいサブスクライバーまたはイベントソースの取り消し。チェックと削除の間にサブスクライバーが作成された場合、バスは に到着しますDELETE_FAILED。新しいサブスクライバーを処理して再度削除します。

失敗したキー変更からの復旧

どちらの失敗状態も、実行中のバスが AWS KMS キーから到達できる状態です。新しいキーの更新が失敗した場合、キーのポリシーまたは許可を修正UpdateEventBusした後に再試行します。新しいキー自体が使用できない場合、EventBridge は失敗したキーを採用しなかったため、再試行は別のキーに名前を付けることができます。が新しいキーACTIVEを持つバスDescribeEventBusを表示するまで、前のキーに対する EventBridge のアクセスを無効化、削除、または削除しないでください。変更の途中で古いキーを失ったバスは、そのキーを復元するか、削除することによってのみ修復できます。キーのアクセス許可については、「」を参照してくださいカスタムイベントバスでのイベントの暗号化。