Einen Bus erstellen

Sie erstellen einen Bus mitCreateEventBus, zum Beispielaws eventsv2 create-event-bus --name orders. Der Name ist der einzige erforderliche Parameter. Bei der Erstellung können Sie auch eine Beschreibung, die Anzahl der Tage, an denen der Bus Ereignisse speichert, den AWS KMS Schlüssel, der sie verschlüsselt, und Tags angeben. Der Anruf kehrt sofort zurück, wenn sich der Bus im CREATING Status befindet. Veröffentlichen Sie ihn auf dem Bus oder erstellen Sie einen Abonnenten für den Bus, sobald die Meldung DescribeEventBus gemeldet ACTIVE wird.

Einen Bus erstellen mit dem AWS CLI

Mit dem folgenden Befehl wird ein Bus mit dem Namen erstelltorders, der Ereignisse 30 Tage lang speichert, sie mit Ihrem AWS KMS Schlüssel verschlüsselt und mit einem Tag versehen ist.

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

In der folgenden Tabelle ist aufgeführt, was jeder Parameter akzeptiert.

Parameter	Was er akzeptiert
--name	Erforderlich. 1 bis 256 Zeichen: Buchstaben, Ziffern, Punkte, Bindestriche und Unterstriche, beginnend mit einem Buchstaben oder einer Ziffer. Der Name muss in Ihrem Konto in der Region eindeutig sein. Die Erstellung eines zweiten Busses mit demselben Namen schlägt mit fehl. ResourceAlreadyExistsException
--description	Bis zu 512 Zeichen.
--storage-configuration	RetentionPeriodInDays, von 1 bis 365. Lassen Sie es weg und der Bus speichert Ereignisse für 1 Tag. Sie können den Zeitraum später mit UpdateEventBus ändern. Siehe Auswahl des Aufbewahrungszeitraums.
--encryption-configuration	KmsKeyIdentifier: eine Schlüssel-ID, Schlüssel-ARN, Aliasname oder Alias-ARN eines vom AWS KMS Kunden verwalteten Schlüssels. Lassen Sie ihn weg und EventBridge verschlüsselt Ereignisse mit einem AWS eigenen Schlüssel. Die Schlüsselrichtlinie, die der Schlüssel benötigt, finden Sie unter. Ereignisse auf einem Custom Event Bus verschlüsseln
--tags	Eine Zuordnung von Tag-Schlüsseln zu Werten, zum Beispielteam=orders,env=prod. Informationen zur tagbasierten Zugriffskontrolle finden Sie unterAktionen, Ressourcen und Bedingungsschlüssel für den Custom Event Bus.

Die Antwort gibt den Bus-ARN zurück, den jeder spätere Anruf auf dem Bus verwendet. Der ARN endet mit einem Bezeichner, der EventBridge generiert wird, sodass Sie ihn nicht aus dem Namen erstellen können.

{
    "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"
}

Beschreiben Sie den Bus anhand seiner ARN, bis er State istACTIVE.

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

Informationen zum Erstellen eines Busses mit CloudFormation instead finden Sie unterErstellen von benutzerdefinierten Event Bus-Ressourcen mit CloudFormation. Die IAM-Aktionen, die zum Erstellen und Beschreiben eines Busses erforderlich sind, finden Sie unterAktionen, Ressourcen und Bedingungsschlüssel für den Custom Event Bus.

Auswahl des Aufbewahrungszeitraums

Ein Bus speichert jedes Ereignis, das er annimmt, für eine bestimmte Anzahl von TagenStorageConfiguration.RetentionPeriodInDays, von 1 bis 365. Wenn Sie es weglassen, speichert der Bus Ereignisse für einen Tag. Durch Aufbewahrung kann ein Abonnent an einem Punkt in der Vergangenheit beginnen, pausieren und fortsetzen, ohne dass Ereignisse verloren gehen, und Ereignisse nach einem Ausfall erneut lesen. Ein längerer Zeitraum kostet mehr Speicherplatz. Sie können den Zeitraum später mit ändernUpdateEventBus.

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

DescribeEventBusgibt den frühesten Punkt zurückRetentionWindowStartTime, von dem aus ein Abonnent lesen kann. Informationen zur Übermittlung beibehaltener Ereignisse an einen Abonnenten finden Sie unterWiedergeben von gespeicherten Ereignissen für einen Abonnenten.

Bus-Status und was jeder erlaubt

Das Erstellen, Aktualisieren und Löschen eines Busses erfolgt asynchron. In allen Bundesstaaten werden einige Operationen ACTIVE verweigert, und in den drei ausgefallenen Zuständen wird eine Meldung angezeigt, aus der StateReason hervorgeht, warum. In der folgenden Tabelle sind die Bundesstaaten aufgeführt, durch die ein Bus fährt, und welche Aktionen Sie in den einzelnen Bundesstaaten ausführen können.

Status	Wie kommt der Bus dorthin	Was Sie tun können
CREATING	CreateEventBusist zurückgekehrt und der Bus wird gerade aufgebaut.	Beschreibe und warte. Sie können den Bus nicht veröffentlichen, aktualisieren oder löschen oder einen Abonnenten oder eine Ereignisquelle darauf erstellen.
ACTIVE	Die Erstellung oder Aktualisierung ist abgeschlossen.	Alles: veröffentlichen, Abonnenten und Eventquellen erstellen, aktualisieren, teilen, löschen.
CREATE_FAILED	Die Erstellung ist fehlgeschlagen. Dies passiert, wenn der von Ihnen angegebene AWS KMS Schlüssel EventBridge nicht verwendet werden kann.	Löschen Sie den Bus. Nichts anderes wird akzeptiert. Lesen SieStateReason, korrigieren Sie den Schlüssel oder seine Richtlinie und erstellen Sie den Bus erneut.
UPDATING	UpdateEventBusändert die Verschlüsselungskonfiguration. Andere Updates durchlaufen diesen Status nicht.	Veröffentlichen und liefern Sie wie gewohnt. Sie können den Bus erst aktualisieren oder löschen, wenn er wieder zu ihm zurückkehrtACTIVE.
UPDATE_FAILED	Ein Verschlüsselungsupdate ist fehlgeschlagen, auch hier, weil der Schlüssel nicht verwendet werden EventBridge konnte.	Der Bus läuft mit seiner vorherigen Konfiguration weiter. Versuchen Sie das Update erneut, nachdem Sie die Ursache behoben haben, oder löschen Sie den Bus.
DELETING	DeleteEventBuszurückgekehrt.	Warten Sie. Sie können keinen Abonnenten oder keine Ereignisquelle auf einem Bus erstellen, der gerade gelöscht wird.
DELETE_FAILED	Beim Löschen wurde ein Abonnent oder eine Ereignisquelle gefunden, die nicht gesperrt wurde.	Löschen Sie den Bus erneut, nachdem seine Abonnenten und Ereignisquellen gelöscht oder gesperrt wurden. Nichts anderes wird akzeptiert.

Löschen eines Busses, der Abonnenten hat

DeleteEventBusist nur erfolgreich, wenn alle Teilnehmer und alle Ereignisquellen auf dem Bus gelöscht oder gesperrt werden. Ein Abonnent, den ein anderes Konto erstellt hat, zählt. Sie können den Abonnenten dieses Kontos nicht selbst löschen. Bitten Sie also entweder den Besitzer, das Konto zu löschen, oder kündigen Sie es mitRevokeResource; sieheEinen Abonnenten oder eine Ereignisquelle sperren. Wenn zwischen Ihrem Scheck und dem Löschen ein Abonnent erstellt wird, landet der Bus darinDELETE_FAILED; kümmern Sie sich um den neuen Abonnenten und löschen Sie ihn erneut.

Wiederherstellung nach einem fehlgeschlagenen Schlüsselwechsel

Beide fehlerhaften Zustände, die ein laufender Bus erreichen kann, stammen vom AWS KMS Schlüssel. Wenn die Aktualisierung eines neuen Schlüssels fehlschlägt, versuchen Sie es erneut, UpdateEventBus nachdem Sie die Richtlinie oder die Gewährung des Schlüssels korrigiert haben. Wenn der neue Schlüssel selbst unbrauchbar ist, kann beim erneuten Versuch ein anderer Schlüssel benannt werden, da der fehlerhafte Schlüssel EventBridge nicht übernommen wurde. Deaktivieren, löschen oder entfernen Sie EventBridge den Zugriff auf den vorherigen Schlüssel erst, wenn der Bus ACTIVE mit dem neuen Schlüssel DescribeEventBus angezeigt wird. Ein Bus, der während einer Änderung seinen alten Schlüssel verliert, kann nur repariert werden, indem dieser Schlüssel wiederhergestellt oder gelöscht wird. Informationen zu den Schlüsselberechtigungen finden Sie unterEreignisse auf einem Custom Event Bus verschlüsseln.