Destinos do Amazon API Gateway para regras no Amazon EventBridge - Amazon EventBridge
Parâmetros dinâmicosRepetições de invocaçãoTimeout (Tempo limite)

Destinos do Amazon API Gateway para regras no Amazon EventBridge

É possível usar o Amazon API Gateway para criar, publicar, manter e monitorar APIs. O Amazon EventBridge é compatível com o envio de eventos para um endpoint do API Gateway. Ao especificar um endpoint do API Gateway como destino, cada evento enviado ao destino é mapeado para uma solicitação enviada ao endpoint.

Importante

O EventBridge é compatível com o uso de endpoints otimizados e regionais 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.

É 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 da AWS ou de terceiros.

  • Para invocar um endpoint periodicamente em um cronograma.

As informações do evento JSON do EventBridge 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 que o EventBridge anexa 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

Ao invocar um destino do API Gateway, você pode adicionar dados dinamicamente aos eventos enviados ao destino. Para ter mais informações, consulte Parâmetros de destino.

Repetições de invocação

Como acontece com todos os destinos, o EventBridge tenta novamente algumas invocações com falha. Para o API Gateway, o EventBridge tenta novamente as respostas enviadas com um código de status HTTP 5xx ou 429 por até 24 horas com recuo exponencial e variação de sinal. Depois disso, o EventBridge publica uma métrica FailedInvocations no Amazon CloudWatch. O EventBridge não tenta novamente outros erros HTTP 4xx.

Timeout (Tempo limite)

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

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