서비스 연결 역할 요청 내 헤더 API 대상 오류 코드 간접 호출 비율 및 이벤트 전송

Amazon EventBridge의 대상으로 사용되는 API 데스티네이션

EventBridge API 대상은 AWS 서비스 또는 리소스를 대상으로 간접 호출하는 방식과 마찬가지로 이벤트 버스 규칙 또는 파이프의 대상으로 간접 호출할 수 있는 HTTPS 엔드포인트입니다. API 대상을 사용하면 API 호출을 사용하여 AWS 서비스, 서비스형 통합 소프트웨어(SaaS) 애플리케이션 및 퍼블릭 또는 프라이빗 애플리케이션 간에 이벤트를 라우팅할 수 있습니다.

API 대상을 규칙 또는 파이프 대상으로 지정하면 EventBridge는 규칙 또는 파이프에 지정된 이벤트 패턴과 일치하는 모든 이벤트에 대해 HTTPS 엔드포인트를 호출한 다음 이벤트 정보를 요청과 함께 전달합니다. EventBridge에서는 CONNECT 및 TRACE를 제외한 모든 HTTP 메서드를 요청에 사용할 수 있습니다. 가장 일반적으로 사용되는 HTTP 메서드는 PUT 및 POST입니다.

입력 변환기를 사용하여 이벤트를 특정 HTTP 엔드포인트 파라미터의 파라미터로 사용자 지정할 수도 있습니다. 자세한 내용은 Amazon EventBridge 입력 변환 단원을 참조하십시오.

API 데스티네이션은 권한 부여 파라미터와의 연결을 사용하여 HTTP 엔드포인트로 이벤트를 전송합니다.

EventBridge API 대상은 연결을 사용하여 EventBridge가 지정된 HTTPS 엔드포인트에 연결할 때 사용할 권한 부여 방법과 자격 증명 및 네트워크 연결을 정의합니다. 연결은 퍼블릭 API와 프라이빗 APIs 모두 지원합니다. 자세한 내용은 연결 단원을 참조하십시오.

참고

EventBridge API 대상은 현재 프라이빗 API를 사용할 때 HTTPS 엔드포인트에 대해 공개적으로 신뢰할 수 있는 인증서가 있는 퍼블릭 도메인 이름만 지원합니다 APIs. API 대상은 상호 TLS(mTLS)를 지원하지 않습니다.

중요

API 대상 엔드포인트에 대한 EventBridge 요청의 최대 클라이언트 실행 제한 시간은 5초여야 합니다. 대상 엔드포인트가 응답하는 데 5초 이상 걸리는 경우 EventBridge는 요청 시간을 초과합니다. EventBridge는 재시도 정책에 구성된 최댓값까지 시간이 초과된 요청을 재시도합니다.

이벤트 버스의 경우 기본적으로 최대값은 24시간 185회입니다.
파이프의 경우 재시도는 파이프 소스 유형과 구성이 결정됩니다. EventBridge는 이벤트가 소스에서 만료되거나 구성된 최대 이벤트 기간 또는 재시도 횟수에 도달할 때까지 재시도합니다.

최대 재시도 횟수를 초과하면 DLQ(Dead Letter Queue)가 있는 경우 이벤트가 DLQ(Dead Letter Queue)로 전송됩니다. 그렇지 않으면 이벤트가 삭제됩니다.

다음 동영상은 API 대상 사용을 보여줍니다.

API 대상을 위한 서비스 연결 역할

API 대상에 대한 연결을 생성하면 AWS ServiceRoleForAmazonEventBridgeApiDestinations라는 서비스 연결 역할이 계정에 추가됩니다. EventBridge는 서비스 연결 역할을 사용하여 보안 암호를 생성하고 Secrets Manager에 저장합니다. 서비스 연결 역할에 필요한 권한을 부여하기 위해 EventBridge는 AmazonEventBridgeApiDestinationsServiceRolePolicy 정책을 역할에 연결합니다. 이 정책은 역할이 연결 보안 암호와 상호 작용하는 데 필요한 권한으로만 부여되는 권한을 제한합니다. 다른 권한은 포함되지 않으며, 역할은 보안 암호를 관리하도록 계정의 연결과만 상호 작용할 수 있습니다.

다음 정책은 AmazonEventBridgeApiDestinationsServiceRolePolicy입니다.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "secretsmanager:CreateSecret",
                "secretsmanager:UpdateSecret",
                "secretsmanager:DescribeSecret",
                "secretsmanager:DeleteSecret",
                "secretsmanager:GetSecretValue",
                "secretsmanager:PutSecretValue"
            ],
            "Resource": "arn:aws:secretsmanager:*:*:secret:events!connection/*"
        }
    ]
}

서비스 연결 역할에 대한 자세한 내용은 IAM 사용 설명서의 서비스 연결 역할 사용을 참조하세요

리전 가용성

AmazonEventBridgeApiDestinationsServiceRolePolicy 서비스 연결 역할은 다음 AWS 리전에서 지원됩니다.

미국 동부(버지니아 북부)
미국 동부(오하이오)
미국 서부(캘리포니아 북부)
미국 서부(오레곤)
아프리카(케이프타운)
아시아 태평양(홍콩)
아시아 태평양(뭄바이)
아시아 태평양(오사카)
아시아 태평양(서울)
아시아 태평양(싱가포르)
아시아 태평양(시드니)
아시아 태평양(도쿄)
캐나다(중부)
유럽(프랑크푸르트)
유럽(아일랜드)
유럽(런던)
유럽(밀라노)
유럽(파리)
유럽(스톡홀름)
남아메리카(상파울루)
중국(닝샤)
중국(베이징)

API 대상에 대한 요청 내 헤더

다음 섹션에서는 EventBridge가 API 대상에 대한 요청에서 HTTP 헤더를 처리하는 방법을 자세히 설명합니다.

API 대상에 대한 요청에 포함된 헤더

API 대상에 사용되는 연결에 정의된 권한 부여 헤더 외에도 EventBridge는 각 요청에 다음과 같은 헤더를 포함합니다.

헤더 키	헤더 값
사용자 에이전트	Amazon/EventBridge/ApiDestinations
Content-Type	사용자 지정 콘텐츠 유형 값이 지정되지 않은 경우, EventBridge에는 다음 기본값이 콘텐츠 유형으로 포함됩니다. application/json; charset=utf-8
Range	bytes=0-1048575
Accept-Encoding	gzip,deflate
연결	close
Content-Length	수신자에게 보낸 개체 본문의 크기(바이트)를 나타내는 개체 헤더입니다.
Host	요청을 보내는 서버의 호스트 및 포트 번호를 지정하는 요청 헤더입니다.

API 대상에 대한 요청에서 재정의할 수 없는 헤더

EventBridge로는 다음 헤더를 재정의할 수 없습니다.

사용자 에이전트
Range

EventBridge가 API 대상에 대한 요청에서 제거하는 헤더

EventBridge는 모든 API 대상 요청에 대해 다음 헤더를 제거합니다.

A-IM
Accept-Charset
Accept-Datetime
Accept-Encoding
Cache-Control
연결
Content-Encoding
Content-Length
Content-MD5
날짜
Expect
전달됨
From
Host
HTTP2-Settings
If-Match
If-Modified-Since
If-None-Match
If-Range
If-Unmodified-Since
Max-Forwards
오리진(Origin)
Pragma
Proxy-Authorization
Range
참조자
TE
트레일러
Transfer-Encoding
사용자 에이전트
업그레이드
Via
경고

API 대상 오류 코드

EventBridge가 API 대상에 이벤트를 전달하려고 시도할 때 오류가 발생하면 EventBridge는 다음을 수행합니다.

오류 코드 401, , 407, 및 409429와 관련된 이벤트를 재시도합니다5xx.
오류 코드 1xx, 2xx, 3xx,와 관련된 이벤트는 재시도하지 않습니다4xx(위에 언급된 이벤트 제외).

EventBridge API 대상은 표준 HTTP 응답 헤더 Retry-After를 읽어 후속 요청을 수행하기 전에 기다려야 하는 시간을 확인합니다. 이벤트 버스의 경우 EventBridge는 정의된 재시도 정책과 Retry-After 헤더 사이에서 더 보수적인 값을 선택합니다. Retry-After 값이 음수이면 EventBridge는 해당 이벤트에 대한 전송 재시도를 중단합니다.

간접 호출 속도가 이벤트 전송에 미치는 영향

초당 간접 호출 속도를 생성된 간접 호출 수보다 훨씬 낮은 값으로 설정하면 이벤트에 대한 24시간 재시도 기간 내에 이벤트가 전달되지 않을 수 있습니다. 예를 들어 간접 호출 속도를 초당 10회 간접 호출로 설정했지만 초당 수천 개의 이벤트가 생성되는 경우, 24시간을 초과하는 전달 이벤트의 백로그가 빠르게 발생할 수 있습니다. 이벤트가 손실되지 않도록 하려면 나중에 이벤트를 처리할 수 있도록 간접 호출이 실패한 이벤트를 보낼 DLQ(Dead Letter Queue)를 설정하세요. 자세한 내용은 Dead Letter Queue(DLQ)를 사용하여 EventBridge에서 배달되지 않은 이벤트 처리 단원을 참조하십시오.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

타사 통합

API 대상 생성