As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# O Amazon API Gateway visa regras na Amazon EventBridge
<a name="eb-api-gateway-target"></a>

Você pode usar o Amazon API Gateway para criar, publicar, manter e monitorar APIs. A Amazon EventBridge oferece suporte ao envio de eventos para um endpoint do API Gateway. Ao especificar um endpoint do API Gateway como [destino](eb-targets.md), cada [evento](eb-events.md) enviado ao destino é mapeado para uma solicitação enviada ao endpoint.

**Importante**  
EventBridge suporta o uso de endpoints *regionais* e *otimizados para o API Gateway Edge* como destinos. No momento, endpoints *privados* não são compatíveis. Para saber mais sobre os endpoints do cluster, consulte [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).

É possível usar um destino do API Gateway para os seguintes casos de uso:
+ Para invocar uma API especificada pelo cliente hospedada no API Gateway com base em eventos AWS ou de terceiros.
+ Para invocar um endpoint periodicamente em um cronograma.

As informações do evento EventBridge JSON são enviadas como o corpo da solicitação HTTP para seu endpoint. É possível especificar os outros atributos da solicitação no campo `HttpParameters` do destino da seguinte forma:
+ `PathParameterValues` lista os valores que correspondem sequencialmente a qualquer variável de caminho no ARN do endpoint, por exemplo `"arn:aws:execute-api:us-east-1:112233445566:myapi/dev/POST/pets/*/*"`.
+ `QueryStringParameters`representa os parâmetros da sequência de caracteres de consulta EventBridge anexados ao endpoint invocado.
+ O `HeaderParameters` define cabeçalhos HTTP a serem adicionados à solicitação.

**nota**  
Por questões de segurança, as seguintes chaves de cabeçalho HTTP não são permitidas:  
Qualquer prexico com `X-Amz` ou `X-Amzn`
`Authorization`
`Connection`
`Content-Encoding`
`Content-Length`
`Host`
`Max-Forwards`
`TE`
`Transfer-Encoding`
`Trailer`
`Upgrade`
`Via`
`WWW-Authenticate`
`X-Forwarded-For`

## Parâmetros dinâmicos
<a name="eb-targets-apigateway-dynamic"></a>

Ao invocar um destino do API Gateway, você pode adicionar dados dinamicamente aos eventos enviados ao destino. Para obter mais informações, consulte [Parâmetros de destino](eb-targets.md#targets-specific-parms).

## Repetições de invocação
<a name="eb-targets-apigateway-retries"></a>

Como acontece com todos os alvos, EventBridge repete algumas invocações que falharam. Para o API Gateway, EventBridge tente novamente as respostas enviadas com um código de status HTTP 5xx ou 429 por até 24 horas com [recuo exponencial](https://aws.amazon.com/blogs/architecture/exponential-backoff-and-jitter/) e instabilidade. Depois disso, EventBridge publica uma `FailedInvocations` métrica na Amazon CloudWatch. EventBridge não repete outros erros HTTP 4xx.

## Timeout (Tempo limite)
<a name="eb-targets-apigateway-timeout"></a>

EventBridge As solicitações de regra do API Gateway devem ter um tempo limite máximo de execução do cliente de 5 segundos. Se o API Gateway demorar mais de 5 segundos para responder, EventBridge exceda o tempo limite da solicitação e tente novamente.

EventBridge As solicitações do Pipes API Gateway têm um tempo limite máximo de 29 segundos, o máximo do API Gateway.