기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon API Gateway의 규칙 대상 EventBridge
Amazon API Gateway를 사용하여 를 생성, 게시, 유지 관리 및 모니터링할 수 있습니다APIs. Amazon EventBridge은 API Gateway 엔드포인트로 이벤트 전송을 지원합니다. API Gateway 엔드포인트를 대상으로 지정하면 대상으로 전송된 각 이벤트가 엔드포인트로 전송된 요청에 매핑됩니다.
중요
EventBridge 는 API Gateway Edge 최적화 및 리전 엔드포인트를 대상으로 사용하는 것을 지원합니다. 프라이빗 엔드포인트는 현재 지원되지 않습니다. 엔드포인트에 대한 자세한 내용은 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의 경우 는 지수 백오프 및 지터FailedInvocations 는 Amazon 에 지표를 EventBridge 게시 CloudWatch합니다. 는 다른 4xx HTTP 오류를 재시도 EventBridge 하지 않습니다.
제한 시간
EventBridge 규칙 API 게이트웨이 요청의 최대 클라이언트 실행 제한 시간은 5초여야 합니다. API Gateway가 응답하는 데 5초 이상 걸리는 경우 는 요청을 EventBridge 시간 초과한 다음 재시도합니다.
EventBridge Pipes API Gateway 요청의 최대 제한 시간은 API 게이트웨이 최대인 29초입니다.
