EventBridge Metas da Amazon para o Amazon API Gateway

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

É 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/*/*".

• QueryStringParametersrepresenta 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

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 alvos, EventBridge repete 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 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.