Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Politiques relative aux nouvelles tentatives et files d’attente de lettres mortes
Lorsqu'un appel cible échoue, EventBridge réessayez jusqu'à ce que l'une des deux limites RetryPolicy soit atteinte, par défaut 5 tentatives ou 300 secondes, puis écrit un enregistrement dans la file d'attente Amazon SQS. OnFailureConfiguration.Arn Définissez les deux lorsque vous créez l'abonné : sans file d'attente de lettres mortes, un événement qui a épuisé ses tentatives est supprimé et la seule trace est la métrique. EventsDropped
Limites de nouvelles tentatives
La livraison s'arrête à la première limite atteinte.
| Limite | Range | Par défaut |
|---|---|---|
MaxRetryAttempts | 0 à 185 | 5 |
MaxEventAgeInSeconds | 60 à 86 400 | 300 |
Les valeurs par défaut sont plus courtes que celles d'un Custom Event Bus - Classic Target (24 heures et 185 tentatives). Une conception migrée qui repose sur un jour de tentatives doit être définie MaxEventAgeInSeconds explicitement sur 86 400 ; sinon, les événements qui échouent pendant une interruption cible de plus de 5 minutes sont placés dans la file d'attente des lettres mortes au lieu d'être livrés en retard. Pour un abonné FIFO, un événement défaillant bloque les derniers événements de son groupe tant qu'il fait l'objet d'une nouvelle tentative. Ainsi, une longue fenêtre de tentatives échange l'ordre contre la latence.
Le record de lettres mortes
L'enregistrement est un document JSON, pas l'événement. L'exemple suivant montre un enregistrement pour deux événements qui ont échoué ensemble dans un lot.
{ "version": "1.0", "busArn": "arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef", "subscriberArn": "arn:aws:events:us-east-1:111122223333:subscriber/large-orders/EXAMPLEabcdef1234567890", "targetArn": "arn:aws:sqs:us-east-1:111122223333:large-orders", "errorCode": "ACCESS_DENIED", "errorMessage": "The delivery role is not authorized to perform sqs:SendMessage on the target.", "exhaustedRetryCondition": "MaximumEventAgeInSeconds", "retryAttempts": 4, "failedMessages": [ { "eventId": "a1b2c3d4-...", "eventGroupId": "order-1001", "deduplicationId": null, "timestamp": "2026-09-16T18:40:12Z", "targetRequestId": "..." }, { "eventId": "e5f6a7b8-...", "eventGroupId": "order-1001", "deduplicationId": null, "timestamp": "2026-09-16T18:40:13Z", "targetRequestId": "..." } ] }
Chaque échec atteint la file d'attente a d'abord fait l'objet d'une nouvelle tentative : aucun échec de livraison n'est ignoréRetryPolicy. Les échecs EventBridge internes sont réessayés EventBridge sans limite et ne produisent jamais d'enregistrement. Le tableau suivant répertorie les codes qu'un enregistrement peut contenir. errorMessageest tronqué à 1 024 caractères.
errorCode | Qu'est-ce qui a échoué | errorMessage |
|---|---|---|
CUSTOMER_VALIDATION | L'API cible a rejeté la demande (une réponse 4xx) : une valeur incorrecte, un champ manquant, un corps mal formé | Le propre message de l'API cible |
ACCESS_DENIED | EventBridge n'a pas pu assumer le rôle de livraison, le rôle n'est pas autorisé à appeler la cible ou la AWS KMS clé de la cible a refusé l'accès | EventBridge Je ne pouvais pas supposerrole. Vérifiez que le rôle existe et que sa politique de confiance autorise le principal du EventBridge service à l'assumer. ou n'EventBridge a pas pu y accéderresource. Vérifiez qu'il existe et que le rôle de livraison de l'abonné est autorisé à y accéder. |
RESOURCE_NOT_FOUND | La cible, ou sa AWS KMS clé, n'existe pas | Impossible d'accéder au message ci-dessus ou au message générique |
INPUT_TRANSFORMATION_FAILURE | L'Inputexpression Transformer ou universal-target n'a généré ou produit aucune valeur | L'erreur d'expression |
THROTTLING | La cible a limité l'appel | Le message générique |
EXECUTION_TIMEOUT | La cible n'a pas répondu dans les délais InvocationTimeoutSeconds | Le message générique |
REQUEST_TOO_LARGE | La demande a dépassé la limite de taille de la cible ; inférieure MaxBatchSize | Le message générique |
PARTIAL_BATCH_FAILURE | La cible a accepté une partie d'un lot et a rejeté le reste ; l'enregistrement ne failedMessages répertorie que les événements rejetés | Le message générique |
RESOURCE_CONFLICT | La cible a signalé un conflit, par exemple un nom déjà utilisé | Le message générique |
KMS_INVALID_STATE | La AWS KMS clé de la cible est désactivée ou en attente de suppression | Le message générique |
SFN_TYPE_NOT_SUPPORTED | REQUEST_RESPONSEa été utilisé avec une machine à états standard, qui ne prend pas en charge l'exécution synchrone | Le message générique |
COMPUTE_EXECUTION_ERROR | Une REQUEST_RESPONSE fonction ou une exécution a été exécutée et a signalé une erreur | Le message générique |
INVOCATION_DEPENDENCY_INTERNAL | La cible a renvoyé une erreur de serveur (une réponse 5xx) | Le message générique |
LOOP_DETECTED | L'événement, ou un événement dérivé de celui-ci, est déjà passé par le bus cible ; voir Détection de boucle | Le message générique |
INTERNAL_SERVER_ERROR | Un échec interne EventBridge lors de l'appel qui a toujours épuisé les tentatives | Le message générique |
Le message générique est La livraison a échoué. Utilisez le code d'erreur et l'identifiant de demande de cet enregistrement lors de l'enquête, et contactez le AWS Support si l'échec persiste. EventBridge l'utilise chaque fois que la transmission du message sous-jacent peut exposer les composants internes d'un autre service. Ainsi, pour ces codes, ce targetRequestId sont les faits à partir desquels travailler, ainsi que les enregistrements du EVENT_DELIVERY_ATTEMPT journal, qui contiennent la demande envoyée. errorCode Les mêmes valeurs arrivent sous forme d'attributs de message Amazon SQS (ERROR_CODE,,ERROR_MESSAGE,SUBSCRIBER_ARN,TARGET_ARN,BUS_ARN,RETRY_ATTEMPTS)EXHAUSTED_RETRY_CONDITION, afin qu'un consommateur puisse les acheminer sans en analyser le corps. Pour un abonné au FIFO, utilisez une file d'attente FIFO comme file d'attente de lettres mortes ; EventBridge définit chaque enregistrement à MessageGroupId partir de celui des événementsEventGroupId, de sorte que les enregistrements d'un groupe restent dans l'ordre.
Le rôle de livraison doit figurer dans sqs:SendMessage la file d'attente. Sans cela, la OnFailureDestinationFailed métrique compte chaque enregistrement qui n'a pas pu être écrit, et ces événements sont perdus.
Reproduction d'événements depuis la file d'attente des lettres mortes
La file d'attente contient des records, et non des événements. Vous pouvez donc repartir en rejouant les événements depuis le bus. Les événements doivent toujours se dérouler pendant la période de conservation du bus.
-
Lisez les dossiers et collectez tous les documents
failedMessages[].eventId, ainsi que les plus anciens et les plus récentstimestamp. -
Corrigez la cause par les
errorCodenoms : la politique du rôle, la cible ou l'expression. -
Créez un abonné sur le même bus avec la même cible et le même rôle, une position de
POINT_IN_TIMEdépart dont l'horodatageStartingPointest le plus ancien et le plus récent, et unSYSTEM_METADATAfiltre sur les identifiants.EndPoint -
Lorsque l'abonné a diffusé les événements, supprimez-les et supprimez les enregistrements de la file d'attente.
aws eventsv2 create-subscriber \ --name redrive-2026-09-16 \ --event-bus-arn arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef \ --starting-position POINT_IN_TIME \ --point-in-time-configuration '{ "PointType": "TIMESTAMP", "StartingPoint": "2026-09-16T18:40:00Z", "EndPoint": "2026-09-16T18:41:00Z" }' \ --filter-configuration '{ "Filters": [ { "Scope": "SYSTEM_METADATA", "Pattern": "{\"aws:EventId\":[\"a1b2c3d4-...\",\"e5f6a7b8-...\"]}" } ] }' \ --invoke-configuration '{ "TargetArn": "arn:aws:sqs:us-east-1:111122223333:large-orders", "RoleArn": "arn:aws:iam::111122223333:role/EventBusDeliveryRole" }'
Les événements rejoués arrivent avec aws:DeliveryTypeREPLAY, ce qui permet au consommateur de les connaître grâce au trafic en direct.