아마존 API 게이트웨이는 아마존 내 규칙을 대상으로 합니다. EventBridge - 아마존 EventBridge
동적 파라미터간접 호출 재시도제한 시간

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

아마존 API 게이트웨이는 아마존 내 규칙을 대상으로 합니다. EventBridge

Amazon API Gateway를 사용하여 생성, 게시, 유지 관리 및 모니터링할 수 APIs 있습니다. EventBridgeAmazon은 API 게이트웨이 엔드포인트로 이벤트를 전송하는 것을 지원합니다. API게이트웨이 엔드포인트를 대상으로 지정하면 대상으로 전송된 각 이벤트가 엔드포인트로 전송된 요청에 매핑됩니다.

중요

EventBridge APIGateway Edge에 최적화된 엔드포인트 및 리전 엔드포인트를 대상으로 사용할 수 있습니다. 프라이빗 엔드포인트는 현재 지원되지 않습니다. 엔드포인트에 대한 자세한 내용은 https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-endpoint-types.html 섹션을 참조하세요.

API게이트웨이 타겟은 다음과 같은 사용 사례에 사용할 수 있습니다.

  • AWS 또는 타사 이벤트를 기반으로 API Gateway에서 API 고객 지정 호스팅을 호출합니다.

  • 일정에 따라 주기적으로 엔드포인트를 간접 호출합니다.

EventBridge JSON이벤트 정보는 HTTP 요청 본문으로 엔드포인트에 전송됩니다. 다음과 같이 대상의 HttpParameters 필드에 다른 요청 속성을 지정할 수 있습니다.

  • PathParameterValues예를 들어 "arn:aws:execute-api:us-east-1:112233445566:myapi/dev/POST/pets/*/*" 엔드포인트의 ARN 모든 경로 변수에 순차적으로 해당하는 값을 나열합니다.

  • QueryStringParameters호출된 엔드포인트에 EventBridge 추가되는 쿼리 문자열 파라미터를 나타냅니다.

  • HeaderParameters요청에 추가할 HTTP 헤더를 정의합니다.

참고

보안상의 이유로 다음 HTTP 헤더 키는 허용되지 않습니다.

  • X-Amz 또는 X-Amzn 접두사가 붙은 모든 항목

  • Authorization

  • Connection

  • Content-Encoding

  • Content-Length

  • Host

  • Max-Forwards

  • TE

  • Transfer-Encoding

  • Trailer

  • Upgrade

  • Via

  • WWW-Authenticate

  • X-Forwarded-For

동적 파라미터

API게이트웨이 대상을 호출할 때 대상으로 전송되는 이벤트에 데이터를 동적으로 추가할 수 있습니다. 자세한 내용은 대상 파라미터 단원을 참조하십시오.

간접 호출 재시도

모든 대상과 마찬가지로 일부 실패한 호출을 EventBridge 재시도합니다. API게이트웨이의 경우 5xx 또는 429 HTTP 상태 코드와 함께 전송된 응답을 지수적 백오프 및 지터를 사용하여 최대 24시간 동안 EventBridge 재시도합니다. 그런 다음 CloudWatch Amazon에 FailedInvocations 메트릭을 EventBridge 게시합니다. EventBridge 다른 HTTP 4xx 오류는 재시도하지 않습니다.

제한 시간

EventBridge 규칙 API 게이트웨이 요청의 최대 클라이언트 실행 제한 시간은 5초여야 합니다. APIGateway에서 응답하는 데 5초 이상 걸리는 경우 요청 EventBridge 제한 시간을 초과한 다음 다시 시도합니다.

EventBridge 파이프 API 게이트웨이 요청의 최대 제한 시간은 API 게이트웨이 최대값인 29초입니다.