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ändert | Was bedeutet das für den Umzug |
|---|---|
Der IAM-Aktionsnamespace events: und der events.amazonaws.com Dienstprinzipal | Identitätsrichtlinien, Busressourcenrichtlinien und Vertrauensrichtlinien für Bereitstellungsrollen werden wiederverwendet |
| Zieldienste: Amazon SQS, Lambda, Amazon SNS, Kinesis, Firehose, Step Functions, API Gateway, API-Ziele, Event-Busse | Bereitstellungsrollen 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 Platzhaltern | Regelmuster werden zu unveränderten DATA Filtern für den PutEvents Datenverkehr. Siehe Ereignisse für einen Abonnenten filtern |
| AWS Serviceveranstaltungen und SaaS-Partnerveranstaltungen | Dieselben Ereignisse werden über eine Ereignisquelle an einen benutzerdefinierten Event-Bus weitergeleitet. Siehe Ereignisquellen für einen benutzerdefinierten Event-Bus |
Die PutEvents API und der Envelope | Die Produzenten ändern den Endpunkt und den Client, nicht die Anfrage |
| Eingabetransformation mit JSonata | Ausdrücke werden Transformer mit dem Ereignis unter verschoben $events |
Standardwerte, die sich unterscheiden
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: und bauen Sie sie ein. service:apiActionInput Siehe Universelle Ziele für einen Custom Event Bus.
| Benutzerdefinierter Eventbus — Klassisches Ziel | Universelle Zielaktion |
|---|---|
| Amazon-ECS-Aufgabe | arn:aws:events:::aws-sdk:ecs:runTask |
| AWS Batch-Auftrag | arn:aws:events:::aws-sdk:batch:submitJob |
| CodeBuild Projekt | arn:aws:events:::aws-sdk:codebuild:startBuild |
| CodePipeline Pipeline | arn:aws:events:::aws-sdk:codepipeline:startPipelineExecution |
| Aufrufen von Systems Manager Run Command | arn:aws:events:::aws-sdk:ssm:sendCommand |
| Systems Manager Automation | arn:aws:events:::aws-sdk:ssm:startAutomationExecution |
| AWS Arbeitsablauf beim Glue | arn:aws:events:::aws-sdk:glue:startWorkflowRun |
| SageMaker Pipeline | arn:aws:events:::aws-sdk:sagemaker:startPipelineExecution |
| Redshift Data API-Erklärung | arn:aws:events:::aws-sdk:redshiftdata:executeStatement |
| CloudWatch Logs, Protokollgruppe | arn: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 Inspector | arn: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.
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.
-
Erstellen Sie den Custom Event Bus mit dem gewünschten Aufbewahrungszeitraum und warten Sie, bis der Status erreicht ist.
ACTIVE -
Erstellen Sie für jede Regel einen Abonnenten für jedes ihrer Ziele. Verwenden Sie das Ereignismuster der Regel als
DATAFilter, ihrenJSONATAEingangstransformator als Transformator und ihre Zielrolle alsRoleArn. Fügen Sie eine Warteschlange für unzustellbare Nachrichten hinzu und aktivieren Sie Protokolle, bevor Sie Datenverkehr senden. -
Veröffentlichen Sie von Ihren Produzenten auf beiden Bussen und stellen Sie bei jedem Ziel sicher, dass beide Pfade dieselben Ereignisse liefern.
-
Verlagern Sie nur Produzenten in den Custom Event Bus.
-
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.