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à.

# Obiettivi di Amazon API Gateway per le regole in Amazon EventBridge
<a name="eb-api-gateway-target"></a>

Puoi utilizzare Amazon API Gateway per creare, pubblicare, gestire e monitorare APIs. Amazon EventBridge supporta l'invio di eventi a un endpoint API Gateway. Quando specifichi un endpoint Gateway API come [destinazione](eb-targets.md), ogni [evento](eb-events.md) inviato alla destinazione viene mappato a una richiesta inviata all'endpoint.

**Importante**  
EventBridge supporta l'utilizzo di endpoint *regionali* e *ottimizzati per API Gateway Edge* come destinazioni. Gli endpoint *privati* non sono attualmente supportati. Per ulteriori informazioni sugli endpoint, consulta [https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-endpoint-types.html](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-endpoint-types.html).

Puoi utilizzare un destinazione di Gateway API per i seguenti casi d'uso:
+ Per richiamare un'API specificata dal cliente ospitata in API Gateway in base AWS a eventi di terze parti.
+ Per richiamare un endpoint periodicamente in base a una pianificazione.

Le informazioni sull'evento EventBridge JSON vengono inviate come corpo della richiesta HTTP all'endpoint. È possibile specificare gli altri attributi della richiesta nel campo `HttpParameters` della destinazione come segue:
+ `PathParameterValues` elenca i valori che corrispondono in sequenza a qualsiasi variabile di percorso nell'ARN dell'endpoint, ad esempio `"arn:aws:execute-api:us-east-1:112233445566:myapi/dev/POST/pets/*/*"`.
+ `QueryStringParameters`rappresenta i parametri della stringa di query che vengono EventBridge aggiunti all'endpoint richiamato.
+ `HeaderParameters` definisce le intestazioni HTTP da aggiungere alla richiesta.

**Nota**  
Per motivi di sicurezza, le seguenti chiavi di intestazione HTTP non sono consentite:  
Qualsiasi chiave con prefisso `X-Amz` o `X-Amzn`
`Authorization`
`Connection`
`Content-Encoding`
`Content-Length`
`Host`
`Max-Forwards`
`TE`
`Transfer-Encoding`
`Trailer`
`Upgrade`
`Via`
`WWW-Authenticate`
`X-Forwarded-For`

## Parametri dinamici
<a name="eb-targets-apigateway-dynamic"></a>

Quando si richiama una destinazione di Gateway API, è possibile aggiungere dinamicamente dati agli eventi che vengono inviati alla destinazione. Per ulteriori informazioni, consulta [Parametri di destinazione](eb-targets.md#targets-specific-parms).

## Ripetizione di invocazioni
<a name="eb-targets-apigateway-retries"></a>

Come per tutti gli obiettivi, EventBridge riprova alcune chiamate non riuscite. Per API Gateway, EventBridge ritenta le risposte inviate con un codice di stato HTTP 5xx o 429 per un massimo di 24 ore con back off e [jitter esponenziali](https://aws.amazon.com/blogs/architecture/exponential-backoff-and-jitter/). Successivamente, EventBridge pubblica una `FailedInvocations` metrica in Amazon. CloudWatch EventBridge non riprova altri errori HTTP 4xx.

## Timeout
<a name="eb-targets-apigateway-timeout"></a>

EventBridge regola Le richieste API Gateway devono avere un timeout di esecuzione client massimo di 5 secondi. Se API Gateway impiega più di 5 secondi per rispondere, EventBridge calcola il timeout della richiesta e riprova.

EventBridge Le richieste Pipes API Gateway hanno un timeout massimo di 29 secondi, il valore massimo dell'API Gateway.