기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon EventBridge의 규칙에 대한 Amazon API Gateway 대상
Amazon API Gateway를 사용해 API를 생성, 게시, 유지 관리, 모니터링할 수 있습니다. Amazon EventBridge는 API Gateway 엔드포인트로의 이벤트 전송을 지원합니다. API Gateway 엔드포인트를 대상으로 지정하면 대상으로 전송되는 각 이벤트가 엔드포인트로 전송된 요청에 매핑됩니다.
중요
EventBridge는 API Gateway 엣지 최적화 엔드포인트 및 리전 엔드포인트를 대상으로 사용할 수 있도록 지원합니다. 프라이빗 엔드포인트는 현재 지원되지 않습니다. 엔드포인트에 대한 자세한 내용은 https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-endpoint-types.html 섹션을 참조하세요.
다음과 같은 사용 사례에 API Gateway 대상을 사용할 수 있습니다.
-
AWS 또는 타사 이벤트를 기반으로 API Gateway에서 호스팅되는 고객 지정 API를 호출합니다.
-
일정에 따라 주기적으로 엔드포인트를 간접 호출합니다.
EventBridge JSON 이벤트 정보는 HTTP 요청 본문으로 엔드포인트에 전송됩니다. 다음과 같이 대상의 HttpParameters
필드에 다른 요청 속성을 지정할 수 있습니다.
-
PathParameterValues
는 엔드포인트 ARN의 모든 경로 변수에 순차적으로 해당하는 값을 나열합니다(예:"arn:aws:execute-api:us-east-1:112233445566:myapi/dev/POST/pets/*/*"
). -
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 Gateway 대상을 간접 호출할 때 대상으로 전송되는 이벤트에 데이터를 동적으로 추가할 수 있습니다. 자세한 내용은 대상 파라미터 단원을 참조하십시오.
간접 호출 재시도
모든 대상과 마찬가지로 EventBridge는 일부 실패한 간접 호출을 다시 시도합니다. API Gateway의 경우, EventBridge는 5xx 또는 429 HTTP 상태 코드와 함께 전송된 응답을 지수 백오프 및 지터FailedInvocations
지표를 게시합니다. EventBridge는 다른 4xx HTTP 오류를 재시도하지 않습니다.
제한 시간
EventBridge 규칙 API Gateway 요청에는 최대 클라이언트 실행 제한 시간이 5초여야 합니다. API Gateway가 응답하는 데 5초 이상 걸리는 경우 EventBridge는 요청 시간을 초과한 후 재시도합니다.
EventBridge 파이프 API Gateway 요청의 최대 제한 시간은 API Gateway의 최댓값인 29초입니다.