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á.
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, 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 o seu endpoint. É possível especificar os outros atributos da solicitação no campo HttpParameters do destino da seguinte forma:
-
PathParameterValueslista 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
HeaderParametersdefine 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-AmzouX-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 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 exponencialFailedInvocations 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.
