View a markdown version of this page

Universelle Ziele für einen 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.

Universelle Ziele für einen Custom Event Bus

Ein universelles Ziel ruft eine AWS API-Aktion direkt von einem Abonnenten auf, ohne dass eine Funktion dazwischen liegt. Anstatt eine Warteschlange, ein Thema oder eine Funktion als Ziel zu benennen, benennen Sie den Dienst und die API-Aktion, und Sie schreiben die API-Anfrage, die EventBridge gesendet wird, entweder als fester JSONATA-Ausdruck oder als JSONata-Ausdruck, der die Anforderung aus dem Ereignis erstellt. Ein Abonnent kann ein Element in eine DynamoDB-Tabelle schreiben, ein Objekt in einen Amazon S3-Bucket legen, in einem Amazon SNS-Thema veröffentlichen oder eine Step Functions-Ausführung starten, ohne dass eine Lambda-Funktion im Pfad vorhanden ist.

Der Ziel-ARN

Ein universelles Ziel TargetArn hat eine feste Form ohne Region und ohne Konto:

arn:aws:events:::aws-sdk:service:apiAction
  • serviceist die AWS SDK-Dienst-ID, die nicht immer der vertraute Name des Dienstes ist. Step Functions ist beispielsweisesfn, nichtstates. Beispiele, die funktionieren: sqssns,s3,dynamodb,bedrockagentcore.

  • apiActionist der API-Aktionsname in CamelCase mit einem kleinen Anfangsbuchstaben:putItem, nicht. PutItem EventBridge sucht den Namen genau so, wie Sie ihn in seinem Aktionsindex geschrieben haben, der sich in CamelCase befindet, und PutItem wird daher CreateSubscriber mit der Meldung The api PutItem is not valid for the service dynamodb abgelehnt. Dieselbe Meldung bedeutet, dass die Aktion für diesen Dienst nicht existiert.

Ruft beispielsweise DynamoDB auf und arn:aws:events:::aws-sdk:dynamodb:putItem arn:aws:events:::aws-sdk:sns:publish ruft Amazon PutItem SNS auf. Publish

Aktionen, die nicht unterstützt werden

Zwei Arten von Aktionen können nicht das Ziel eines Abonnenten sein und CreateSubscriber lehnt sie mit einer Meldung ab, die besagt, dass die API oder der gesamte Dienst nicht unterstützt wird.

  • Aktionen, die den Status lesen, statt ihn zu ändern, z. B. Aktionen, deren Namen mit getlist, oder describe beginnen. Ein Ereignis beinhaltet etwas, das passiert ist, daher muss eine Zielaktion ihren Status ändern. EventBridge führt eine Liste blockierter Aktionsnamen und Dienste und kann sie ergänzen, z. B. wenn sich eine Aktion nicht so verhält, wie es das Ziel tun sollte, sodass eine Aktion, die einmal akzeptiert wurde, nicht für immer garantiert ist. Behandeln Sie die Meldung zum Zeitpunkt der Erstellung als Autorität.

  • Die Aktionen zum EventBridge Veröffentlichen undeventbridge:putEvents. eventbridge:putPartnerEvents Um Ereignisse an einen anderen Event-Bus weiterzuleiten, legen Sie den Bus-ARN auf den TargetArn Wert fest. Ein benutzerdefinierter Event-Bus und ein benutzerdefinierter Event-Bus — Classic werden beide als eigenständige Ziele unterstützt. Siehe Ziel des Event-Busses: Bus zu Bus.

Parameters

Ein universelles Ziel erfordertInvokeConfiguration.UniversalTargetParameters. CreateSubscriberlehnt einen Abonnenten ab, der ihn weglässt oder der einen anderen Parameterblock bereitstellt, z. B. SqsParameters Die Nachricht besagt, dass erwartet UniversalTargetParameters wird. Gestalten Sie die Anfrage bis zum Input Ende. Ein Abonnent mit universeller Ausrichtung verwendet nicht die des AbonnentenTransformer, also fügen Sie eine beliebige JSONata-Transformation ein. Input

Input (Erforderlich)

Die API-Anforderung, als JSON-Zeichenfolge oder als JSONata-Ausdruck, in den die Anforderung eingebettet ist. {% %} Verwenden Sie die Mitgliedsnamen aus der eigenen Referenz der Ziel-API; für Amazon SQS ist SendMessage das und. QueueUrl MessageBody Bis zu 262.144 Zeichen.

Ein fester Input JSON-Code wird bei der Erstellung des Abonnenten anhand der von der API benötigten Felder überprüft, und ein fehlendes Feld wird namentlich zurückgewiesen. Eine JSONata Input wird nur auf ihre Syntax überprüft, da ihr Ergebnis vom Ereignis abhängt. Daher erscheint eine Anfrage, die die Ziel-API ablehnt, stattdessen zum Zeitpunkt der Lieferung.

InvocationTimeoutSeconds

Wie lange EventBridge auf einen API-Aufruf gewartet wird, zwischen 1 und 30 Sekunden. Der Standardwert ist 30. Dies muss eine literale Ganzzahl sein; ein JSONata-Ausdruck wird hier nicht akzeptiert.

Die Bereitstellungsrolle in RoleArn benötigt die IAM-Aktion für die von Ihnen aufgerufene API, z. B.dynamodb:PutItem, und sqs:SendMessage in der Warteschlange für tote Buchstaben. Die Vertrauensrichtlinie der Rolle und die übrigen Berechtigungen finden Sie unter. Zugriffskontrolle für den Custom Event Bus

Batching und das $events-Array

EventBridge führt einen API-Aufruf pro Batch durch, nicht einen pro Ereignis. BatchConfigurationlegt den Batch fest: MaxBatchSize von 1 bis 500 und MaxBatchWindowInSeconds von 0 bis 300. Ein Stapel wird geschlossen, wenn er die entsprechende Größe erreicht hat oder wenn das Zeitfenster abgelaufen ist, je nachdem, was zuerst eintritt.

In einer JSonata Input $events ist der Batch: ein Array der darin enthaltenen Ereignisse. Bei einer Batchgröße von 1 $events.Data.orderId ergibt sich der Wert des einen Ereignisses. Bei einem größeren Batch adressieren Sie das Array explizit, z. B. mit $map und$join, oder der Ausdruck erzeugt ein Array, in dem die API eine Zeichenfolge erwartet und die Übertragung fehlschlägt.

Setzen Sie MaxBatchSize den Wert MaxBatchWindowInSeconds auf 1 und auf 0, um für jedes Ereignis einen API-Aufruf durchzuführen. Tun Sie dies immer dannInput, wenn JSON fest ist, da eine feste Anforderung für jedes Ereignis im Batch identisch ist und der Batch einen einzigen Aufruf generiert.

Beispiel: Ein DynamoDB-Element pro Ereignis

Der folgende Abonnent schreibt für jedes Ereignis, das mit PutRawEvents veröffentlicht wurde, ein Element in eine DynamoDB-Tabelle und verwendet dabei den Partitionsschlüssel aus dem Feld des Ereignisses. orderId Die Bereitstellungsrolle muss dynamodb:PutItem auf der Tabelle stehen.

aws eventsv2 create-subscriber \ --name orders-to-dynamodb \ --event-bus-arn arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef \ --invoke-configuration '{ "TargetArn": "arn:aws:events:::aws-sdk:dynamodb:putItem", "RoleArn": "arn:aws:iam::111122223333:role/EventBusDeliveryRole", "UniversalTargetParameters": { "Input": "{% { \"TableName\": \"orders\", \"Item\": { \"pk\": { \"S\": $events.Data.orderId }, \"total\": { \"N\": $string($events.Data.total) } } } %}" } }' \ --batch-configuration MaxBatchSize=1,MaxBatchWindowInSeconds=0 \ --on-failure-configuration '{ "Arn": "arn:aws:sqs:us-east-1:111122223333:orders-to-dynamodb-dlq" }'

Für eine VeranstaltungPutEvents, die mit veröffentlicht wurde, befinden sich dieselben Felder unterdetail:$events.Data.detail.orderId. Siehe Eventstruktur: Daten, Metadaten und Systemmetadaten.

Wenn der API-Aufruf fehlschlägt

Wenn Sie den Abonnenten erstellen, EventBridge prüft er die Form des ARN, ob die Aktion existiert und nicht blockiert ist und ob ein fester Wert die erforderlichen Felder der Aktion Input enthält und, bei einer JSONataInput, ob der Ausdruck analysiert wird. Es wird nicht überprüft, ob die in der Anfrage genannte Ressource existiert oder ob die Bereitstellungsrolle die Aktion aufrufen kann. Diese Fehler treten bei der Zustellung auf, und jeder Zustellungsfehler wird unter dem Namen des Abonnenten erneut versuchtRetryPolicy, standardmäßig bis zu 5 Versuche innerhalb von 300 Sekunden. Wenn ein Limit erreicht ist, wird ein Datensatz in die Warteschlange mit toten Buchstaben EventBridge geschrieben, deren errorCode Name der letzte Fehlschlag ist. Die Codes, die ein universelles Ziel am häufigsten erzeugt:

  • CUSTOMER_VALIDATION: Die Ziel-API hat die Anfrage abgelehnt, z. B. ein fehlendes erforderliches Feld oder ein Wert außerhalb des zulässigen Bereichs. Der Datensatz enthält die eigene Fehlermeldung der Ziel-API.

  • ACCESS_DENIED: Die Bereitstellungsrolle EventBridge konnte nicht übernommen werden, oder die Rolle darf die Aktion für die Ressource nicht aufrufen. Welcher das ist, steht in einer EventBridge Nachricht, die die Rolle oder die Ressource benennt.

  • RESOURCE_NOT_FOUND: Die in der Anfrage genannte Tabelle, das Thema oder eine andere Ressource existiert nicht.

  • INPUT_TRANSFORMATION_FAILURE: Der JSONata-Ausdruck in Input hat einen Fehler ausgelöst oder keinen Wert erzeugt.

  • THROTTLING: Die Ziel-API hat den Aufruf gedrosselt. REQUEST_TOO_LARGE: Die Anfrage hat die Größenbeschränkung der Aktion überschritten; niedriger. MaxBatchSize EXECUTION_TIMEOUT: Der Anruf wurde nicht innerhalb des Timeouts zurückgegeben.

Eine vollständige Liste der Fehlercodes, der jeweiligen Meldung und eine Anleitung zum erneuten Fahren finden Sie unter. Richtlinien für Wiederholungsversuche und Warteschlangen für unzustellbare Nachrichten Schalten Sie die Abonnentenprotokolle ein, um jeden Versuch und die genaue gesendete Anfrage zu sehen; sieheBeobachtbarkeit für den Custom Event Bus: Metriken, Protokolle und CloudTrail.