Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Einen Bus erstellen Sie erstellen einen Bus mit`CreateEventBus`, zum Beispiel`aws 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 erstellt`orders`, 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](#eb-custom-bus-create-retention). | | --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. [Verschlüsselung im Ruhezustand für Amazon EventBridge Custom Event Bus](eb-custom-bus-encryption.md) | | --tags | Eine Zuordnung von Tag-Schlüsseln zu Werten, zum Beispielteam=orders,env=prod. Informationen zur tagbasierten Zugriffskontrolle finden Sie unter[Aktionen, Ressourcen und Bedingungstasten für den Custom Event Bus](eb-custom-bus-access-actions.md). | 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` ist`ACTIVE`. ``` 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 unter[Erstellen von benutzerdefinierten Event Bus-Ressourcen mit CloudFormation](eb-custom-bus-cloudformation.md). Die IAM-Aktionen, die zum Erstellen und Beschreiben eines Busses erforderlich sind, finden Sie unter[Aktionen, Ressourcen und Bedingungstasten für den Custom Event Bus](eb-custom-bus-access-actions.md). ## Auswahl des Aufbewahrungszeitraums Ein Bus speichert jedes Ereignis, das er annimmt, für eine bestimmte Anzahl von Tagen`StorageConfiguration.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 ändern`UpdateEventBus`. ``` aws eventsv2 create-event-bus \ --name orders \ --storage-configuration RetentionPeriodInDays=30 ``` `DescribeEventBus`gibt den frühesten Punkt zurück`RetentionWindowStartTime`, von dem aus ein Abonnent lesen kann. Informationen zur Übermittlung beibehaltener Ereignisse an einen Abonnenten finden Sie unter[Wiedergeben von gespeicherten Ereignissen für einen Abonnenten](eb-custom-bus-replay.md). ## 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 `DeleteEventBus`ist 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 mit`RevokeResource`; siehe[Einen Abonnenten oder eine Ereignisquelle sperren](eb-custom-bus-access-revoke.md). Wenn zwischen Ihrem Scheck und dem Löschen ein Abonnent erstellt wird, landet der Bus darin`DELETE_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 unter[Verschlüsselung im Ruhezustand für Amazon EventBridge Custom Event Bus](eb-custom-bus-encryption.md).