

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Policy di ripetizione dei tentativi e code DLQ

Quando una chiamata di destinazione fallisce, EventBridge riprova fino a raggiungere uno dei due limiti di `RetryPolicy` ingresso (per impostazione predefinita 5 tentativi o 300 secondi), quindi scrive un record nella coda di Amazon SQS. `OnFailureConfiguration.Arn` Imposta entrambi quando crei l'abbonato: senza una coda di lettere morte, un evento che esaurisce i tentativi viene eliminato e l'unica traccia è la metrica. `EventsDropped`

## Limiti dei tentativi
<a name="eb-custom-bus-retry-policy"></a>

La consegna si interrompe al primo limite raggiunto.


| Limite | Intervallo | Predefinita | 
| --- | --- | --- | 
| MaxRetryAttempts | Da 0 a 185 | 5 | 
| MaxEventAgeInSeconds | Da 60 a 86.400 | 300 | 

Le impostazioni predefinite sono più brevi delle 24 ore e 185 tentativi di Custom Event Bus - Classic target. Un progetto migrato che si basa su un giorno di tentativi deve essere impostato esplicitamente su 86.400; in caso contrario, gli eventi che falliscono durante un'interruzione di attività di Target `MaxEventAgeInSeconds` per più di 5 minuti finiscono nella coda delle lettere non ricevute anziché essere consegnati in ritardo. Per un abbonato FIFO, un evento con esito negativo blocca gli eventi successivi del gruppo per tutto il tempo in cui viene riprovato, quindi una finestra di riprova lunga scambia l'ordine con la latenza.

## Il record a lettera morta
<a name="eb-custom-bus-retry-record"></a>

Il record è un documento JSON, non l'evento. L'esempio seguente mostra un record per due eventi che hanno avuto esito negativo in un unico batch.

```json
{
    "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": "..." }
    ]
}
```

Ogni errore che raggiunge la coda è stato riprovato per primo: non c'è nessun errore di consegna che lo salti. `RetryPolicy` I fallimenti interni vengono EventBridge ripetuti EventBridge senza limiti e non producono mai alcun record. La tabella seguente elenca i codici che un record può contenere. `errorMessage`viene troncato a 1.024 caratteri.


| `errorCode` | Cosa non è riuscito | `errorMessage` | 
| --- | --- | --- | 
| CUSTOMER\_VALIDATION | L'API di destinazione ha rifiutato la richiesta (una risposta 4xx): un valore errato, un campo mancante, un corpo non valido | Il messaggio proprio dell'API di destinazione | 
| ACCESS\_DENIED | EventBridge non ha potuto assumere il ruolo di recapito, al ruolo non è consentito chiamare la destinazione o alla AWS KMS chiave della destinazione è stato negato l'accesso | EventBridge non poteva presumere{{role}}. Verifica che il ruolo esista e che la sua politica di fiducia consenta al responsabile del EventBridge servizio di assumerlo. o non ha EventBridge potuto accedere{{resource}}. Verifica che esista e che il ruolo di consegna dell'abbonato sia autorizzato ad accedervi. | 
| RESOURCE\_NOT\_FOUND | L'obiettivo, o la sua AWS KMS chiave, non esiste | Il messaggio di cui sopra non è possibile accedere o il messaggio generico | 
| INPUT\_TRANSFORMATION\_FAILURE | L'Inputespressione Transformer o universal-target non ha generato o prodotto alcun valore | L'errore di espressione | 
| THROTTLING | Il bersaglio ha rallentato la chiamata | Il messaggio generico | 
| EXECUTION\_TIMEOUT | Il bersaglio non ha risposto entro InvocationTimeoutSeconds | Il messaggio generico | 
| REQUEST\_TOO\_LARGE | La richiesta ha superato il limite di dimensione del target; inferiore MaxBatchSize | Il messaggio generico | 
| PARTIAL\_BATCH\_FAILURE | La destinazione ha accettato parte di un batch e ha rifiutato il resto; il record failedMessages elenca solo gli eventi rifiutati | Il messaggio generico | 
| RESOURCE\_CONFLICT | La destinazione ha segnalato un conflitto, ad esempio un nome già in uso | Il messaggio generico | 
| KMS\_INVALID\_STATE | La AWS KMS chiave della destinazione è disabilitata o è in attesa di eliminazione | Il messaggio generico | 
| SFN\_TYPE\_NOT\_SUPPORTED | REQUEST\_RESPONSEè stato utilizzato con una macchina a stati Standard, che non supporta l'esecuzione sincrona | Il messaggio generico | 
| COMPUTE\_EXECUTION\_ERROR | Una REQUEST\_RESPONSE funzione o un'esecuzione è stata eseguita e ha riportato un errore | Il messaggio generico | 
| INVOCATION\_DEPENDENCY\_INTERNAL | La destinazione ha restituito un errore del server (una risposta 5xx) | Il messaggio generico | 
| LOOP\_DETECTED | L'evento, o un evento da esso derivato, è già passato attraverso il bus di destinazione; vedi [Rilevamento del loop](eb-custom-bus-target-bus.md#eb-custom-bus-target-bus-loops) | Il messaggio generico | 
| INTERNAL\_SERVER\_ERROR | Un errore interno EventBridge durante la chiamata che ha comunque esaurito i tentativi | Il messaggio generico | 

Il messaggio generico è *La consegna non è riuscita. Utilizza il codice di errore e l'ID della richiesta di questo record durante l'analisi e contatta l' AWS assistenza se l'errore persiste.* EventBridge lo utilizza ovunque la trasmissione del messaggio sottostante possa rivelare le funzionalità interne di un altro servizio, quindi per quei codici i dati `errorCode` e `targetRequestId` sono i dati su cui basarsi, insieme ai record di `EVENT_DELIVERY_ATTEMPT` registro che contengono la richiesta inviata. Gli stessi valori arrivano come attributi dei messaggi di Amazon SQS (`ERROR_CODE`,,,,`ERROR_MESSAGE`,`SUBSCRIBER_ARN`,`RETRY_ATTEMPTS`) `TARGET_ARN` `BUS_ARN``EXHAUSTED_RETRY_CONDITION`, in modo che un consumatore possa indirizzarli su di essi senza analizzarne il corpo. Per un abbonato FIFO, utilizza una coda FIFO come coda delle lettere non scritte; EventBridge imposta ogni record in base agli eventi`EventGroupId`, in modo che i record `MessageGroupId` di un gruppo rimangano in ordine.

Il ruolo di consegna deve essere presente in coda. `sqs:SendMessage` Senza di essa, la `OnFailureDestinationFailed` metrica conta ogni record che non è stato possibile scrivere e tali eventi vengono persi.

## Reindirizzamento degli eventi dalla coda delle lettere non scritte
<a name="eb-custom-bus-retry-redrive"></a>

La coda contiene i record, non gli eventi, quindi puoi riguidare riproducendo gli eventi dal bus. Gli eventi devono ancora rientrare nel periodo di conservazione del bus.

1. Leggi i record e raccogli tutti`failedMessages[].eventId`, oltre a quelli più vecchi e più recenti`timestamp`.

1. Correggi la causa e `errorCode` i nomi: la politica del ruolo, l'obiettivo o l'espressione.

1. Crea un abbonato sullo stesso bus con lo stesso obiettivo e lo stesso ruolo, una posizione di `POINT_IN_TIME` partenza il cui timestamp `StartingPoint` sia il primo e l'ultimo, e un `SYSTEM_METADATA` filtro sugli identificatori. `EndPoint`

1. Quando l'abbonato ha consegnato gli eventi, eliminali ed elimina i record dalla coda.

```bash
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" }'
```

Gli eventi riprodotti arrivano in tempo reale `aws:DeliveryType``REPLAY`, in modo che il consumatore possa distinguerli dal traffico in tempo reale.