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

# Amazon EventBridge의 규칙에 대한 Amazon API Gateway 대상
<a name="eb-api-gateway-target"></a>

Amazon API Gateway를 사용해 API를 생성, 게시, 유지 관리, 모니터링할 수 있습니다. Amazon EventBridge는 API Gateway 엔드포인트로의 이벤트 전송을 지원합니다. API Gateway 엔드포인트를 [대상](eb-targets.md)으로 지정하면 대상으로 전송되는 각 [이벤트](eb-events.md)가 엔드포인트로 전송된 요청에 매핑됩니다.

**중요**  
EventBridge는 API Gateway *엣지 최적화* 엔드포인트 및 *리전* 엔드포인트를 대상으로 사용할 수 있도록 지원합니다. *프라이빗* 엔드포인트는 현재 지원되지 않습니다. 엔드포인트에 대한 자세한 내용은 [https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-endpoint-types.html](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`

## 동적 파라미터
<a name="eb-targets-apigateway-dynamic"></a>

API Gateway 대상을 간접 호출할 때 대상으로 전송되는 이벤트에 데이터를 동적으로 추가할 수 있습니다. 자세한 내용은 [대상 파라미터](eb-targets.md#targets-specific-parms) 단원을 참조하십시오.

## 간접 호출 재시도
<a name="eb-targets-apigateway-retries"></a>

모든 대상과 마찬가지로 EventBridge는 일부 실패한 간접 호출을 다시 시도합니다. API Gateway의 경우, EventBridge는 5xx 또는 429 HTTP 상태 코드와 함께 전송된 응답을 [지수 백오프 및 지터](https://aws.amazon.com/blogs/architecture/exponential-backoff-and-jitter/)를 사용해 최대 24시간 동안 재시도합니다. 그 후 EventBridge는 Amazon CloudWatch에 `FailedInvocations` 지표를 게시합니다. EventBridge는 다른 4xx HTTP 오류를 재시도하지 않습니다.

## 제한 시간
<a name="eb-targets-apigateway-timeout"></a>

EventBridge 규칙 API Gateway 요청에는 최대 클라이언트 실행 제한 시간이 5초여야 합니다. API Gateway가 응답하는 데 5초 이상 걸리는 경우 EventBridge는 요청 시간을 초과한 후 재시도합니다.

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