View a markdown version of this page

Migration von Custom Event Bus — Classic zum Custom Event Bus - Amazon EventBridge

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.

Migration von Custom Event Bus — Classic zum Custom Event Bus

Custom Event Bus — Classic ist weiterhin verfügbar, und Sie können beide Produkte parallel ausführen. Ihre Identitätsrichtlinien und Bereitstellungsrollen werden übernommen, da der Custom Event Bus den events: IAM-Namespace und den events.amazonaws.com Dienstprinzipal beibehält. Das Routing-Modell ändert sich.

Benutzerdefinierter Event Bus – Klassisch Benutzerdefinierter Event Bus
Eine Regel und eines ihrer Ziele Ein Abonnent
Eine Regel mit fünf Zielen Fünf Teilnehmer auf demselben Bus
Ereignismuster für eine Regel Ein Filter mit einem Gültigkeitsbereich vonDATA. Wenn Hersteller mit veröffentlichenPutEvents, bleibt das Muster unverändert.
Eingangstransformator Ein Transformator mit einer Art von JSONATA
Dead-letter Warteschlange auf einem Ziel OnFailureConfigurationauf dem Abonnenten
Versuchen Sie es erneut mit der Richtlinie für ein Ziel RetryPolicyauf dem Abonnenten
Archivieren und Wiederholen Verbleib im Bus und Startposition eines Teilnehmers
Regeln, die der Busbesitzer für jeden Verbraucher aufstellt Abonnenten, die von den Verbrauchern selbst erstellt wurden
events:PutEvents events:PutEvents, plus events:PutRawEvents für Nicht-JSON-Payloads

Für vier Funktionen gibt es kein Äquivalent zu Custom Event Bus — Classic, sodass Sie sie ohne Umgehung verwenden können:

  • Aufbewahrung auf dem Bus selbst

  • Die Startposition eines Abonnenten

  • Machen Sie eine Pause und fahren Sie mit einem Rückstand fort

  • Eine zweite Veröffentlichungs-API für Nicht-JSON-Payloads

Sie müssen nicht alles verschieben. Die beiden Busse fahren Seite an Seite, sodass eine Regel „Benutzerdefinierter Eventbus — Klassisch“ auf einen benutzerdefinierten Ereignisbus und ein Abonnent auf einen „Benutzerdefinierter Eventbus — Classic“ abzielen kann. Sie können einen Verbraucher oder einen Hersteller nach dem anderen verlagern. Siehe Ziel des Event-Busses: Bus zu Bus.

Was ändert sich nicht

Die folgenden Angaben bleiben unverändert, sodass die entsprechenden Teile Ihrer Bereitstellung unverändert übernommen werden.

UnverändertWas bedeutet das für den Umzug
Der IAM-Aktionsnamespace events: und der events.amazonaws.com DienstprinzipalIdentitätsrichtlinien, Busressourcenrichtlinien und Vertrauensrichtlinien für Bereitstellungsrollen werden wiederverwendet
Zieldienste: Amazon SQS, Lambda, Amazon SNS, Kinesis, Firehose, Step Functions, API Gateway, API-Ziele, Event-BusseBereitstellungsrollen behalten dieselben Zielaktionen bei; jedes Ziel hat einen Parameterblock mit denselben Feldern wie sein klassisches Gegenstück. Siehe Ziele für einen Custom Event Bus-Abonnenten
Syntax von Ereignismustern, außer PlatzhalternRegelmuster werden zu unveränderten DATA Filtern für den PutEvents Datenverkehr. Siehe Ereignisse für einen Abonnenten filtern
AWS Serviceveranstaltungen und SaaS-PartnerveranstaltungenDieselben Ereignisse werden über eine Ereignisquelle an einen benutzerdefinierten Event-Bus weitergeleitet. Siehe Ereignisquellen für einen benutzerdefinierten Event-Bus
Die PutEvents API und der EnvelopeDie Produzenten ändern den Endpunkt und den Client, nicht die Anfrage
Eingabetransformation mit JSonataAusdrücke werden Transformer mit dem Ereignis unter verschoben $events

Standardwerte, die sich unterscheiden

Wichtig

Ein Abonnent wiederholt eine fehlgeschlagene Zustellung für 300 Sekunden und standardmäßig 5 Versuche. Ein benutzerdefinierter Eventbus — Klassisches Ziel versucht es 24 Stunden lang und 185 Versuche erneut. Wenn Ihre Kunden während eines Ausfalls auf einen Tag mit Wiederholungsversuchen angewiesen sind, legen Sie RetryPolicy.MaxEventAgeInSeconds für jeden Abonnenten einen Wert von 86.400 und 185 fest und MaxRetryAttempts fügen Sie eine Warteschlange für eingehende Nachrichten hinzu. Andernfalls werden Ereignisse, die länger als 5 Minuten fehlschlagen, nicht verspätet zugestellt. Siehe Richtlinien für Wiederholungsversuche und Warteschlangen für unzustellbare Nachrichten.

Zwei weitere Standardwerte unterscheiden sich. Ein Abonnent liefert einen Batch als JSON-Array an eine Funktion oder eine Zustandsmaschine. Im Gegensatz dazu lieferte eine Regel ein Ereignis pro Aufruf. Um ein Ereignis pro Anruf beizubehalten, legen Sie den Wert BatchConfiguration.MaxBatchSize auf 1 fest.

Ein Bus speichert auch Ereignisse, sodass ein Abonnent, der nach einem Vorfall erstellt wurde, nachlesen kann, was er verpasst hat. Eine Regel, die zu spät erstellt wurde, sah dagegen nichts.

Klassische Ziele ohne maßgeschneidertes Äquivalent

Verwenden Sie für jeden Zieltyp Custom Event Bus — Classic, für den es kein maßgeschneidertes Ziel auf dem Custom Event Bus gibt, ein universelles Ziel, das die API-Aktion des Dienstes aufruft. Stellen Sie TargetArn die Anfrage ein arn:aws:events:::aws-sdk:service:apiAction und bauen Sie sie ein. Input Siehe Universelle Ziele für einen Custom Event Bus.

Benutzerdefinierter Eventbus — Klassisches ZielUniverselle Zielaktion
Amazon-ECS-Aufgabearn:aws:events:::aws-sdk:ecs:runTask
AWS Batch-Auftragarn:aws:events:::aws-sdk:batch:submitJob
CodeBuild Projektarn:aws:events:::aws-sdk:codebuild:startBuild
CodePipeline Pipelinearn:aws:events:::aws-sdk:codepipeline:startPipelineExecution
Aufrufen von Systems Manager Run Commandarn:aws:events:::aws-sdk:ssm:sendCommand
Systems Manager Automationarn:aws:events:::aws-sdk:ssm:startAutomationExecution
AWS Arbeitsablauf beim Gluearn:aws:events:::aws-sdk:glue:startWorkflowRun
SageMaker Pipelinearn:aws:events:::aws-sdk:sagemaker:startPipelineExecution
Redshift Data API-Erklärungarn:aws:events:::aws-sdk:redshiftdata:executeStatement
CloudWatch Logs, Protokollgruppearn:aws:events:::aws-sdk:cloudwatchlogs:putLogEvents
Amazon EC2 EC2-Aktionen (Beenden, Neustarten, Beenden, Snapshot erstellen)arn:aws:events:::aws-sdk:ec2:stopInstances, rebootInstances, terminateInstances, createSnapshot
Bewertung durch den Inspectorarn:aws:events:::aws-sdk:inspector:startAssessmentRun

Die Namen der Dienste und Aktionen entsprechen den allgemeinen Benennungsregeln für Ziele. CreateSubscriberlehnt einen Namen ab, den es nicht erkennt. Bestätigen Sie daher jeden Namen, wenn Sie den Abonnenten erstellen.

Reihenfolge der Migration

Verschieben Sie einen Bus nach dem anderen in fünf Schritten, wobei die Regeln für Custom Event Bus — Classic bis zum letzten Schritt beibehalten werden. Jeder Schritt ist reversibel, bis Sie die Regeln löschen.

Wichtig

Ein aus einer Regel kopiertes Muster entspricht Ereignissen, die mit veröffentlicht wurdenPutEvents, da diese API denselben Umschlag erzeugt wie Custom Event Bus — Classic. Das gleiche Muster passt nicht zu Ereignissen, die mit veröffentlicht wurdenPutRawEvents, weil die Payload nicht darunter verschachtelt ist. detail Siehe Eventstruktur: Daten, Metadaten und Systemmetadaten.

  1. Erstellen Sie den Custom Event Bus mit dem gewünschten Aufbewahrungszeitraum und warten Sie, bis der Status erreicht ist. ACTIVE

  2. Erstellen Sie für jede Regel einen Abonnenten für jedes ihrer Ziele. Verwenden Sie das Ereignismuster der Regel als DATA Filter, ihren JSONATA Eingangstransformator als Transformator und ihre Zielrolle alsRoleArn. Fügen Sie eine Warteschlange für unzustellbare Nachrichten hinzu und aktivieren Sie Protokolle, bevor Sie Datenverkehr senden.

  3. Veröffentlichen Sie von Ihren Produzenten auf beiden Bussen und stellen Sie bei jedem Ziel sicher, dass beide Pfade dieselben Ereignisse liefern.

  4. Verlagern Sie nur Produzenten in den Custom Event Bus.

  5. Deaktivieren Sie die Regeln für den Custom Event Bus — Classic. Löschen Sie sie, nachdem das Wiederholungsfenster und Ihr eigener Überprüfungszeitraum abgelaufen sind.