View a markdown version of this page

Alvos do Amazon API Gateway para regras na Amazon EventBridge - Amazônia EventBridge
Parâmetros dinâmicosRepetições de invocaçãoTimeout (Tempo limite)

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

Alvos do Amazon API Gateway para regras na Amazon EventBridge

É possível 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, cada evento enviado ao destino é mapeado para uma solicitação enviada ao endpoint.

Importante

EventBridge suporta o uso de API Gateway Edge-optimized e endpoints regionais como alvos. 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 de terceiros 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/*/*".

  • QueryStringParametersrepresenta os parâmetros da cadeia de caracteres de consulta que são 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

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.

Repetições de invocação

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

Timeout (Tempo limite)

EventBridge regra As solicitações 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, expire o EventBridge 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.