기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CreateEventSubscription
Amazon DocumentDB 이벤트 알림 구독 생성 이 작업을 하려면 Amazon DocumentDB 콘솔, Amazon SNS 콘솔 또는 Amazon SNS API를 사용해 생성한 주제 Amazon 리소스 이름(ARN)이 필요합니다. Amazon SNS를 통해 ARN을 받으려면 Amazon SNS에서 주제를 생성하고 그 주제를 구독해야 합니다. ARN이 Amazon SNS 콘솔에 표시됩니다.
알림 메시지를 받고 싶은 소스 유형과 이벤트를 트리거링하는 소스(SourceType)를 지정할 수 있습니다. 또한 이벤트를 트리거하는 Amazon DocumentDB 소스 목록(SourceIds)을 제공하고 알림을 받고자 하는 이벤트의 이벤트 카테고리 목록(EventCategories)을 제공할 수 있습니다. 예를 들어, SourceType = db-instance, SourceIds = mydbinstance1, mydbinstance2 및 EventCategories = Availability, Backup을 지정할 수 있습니다.
SourceType및 SourceIds (예: SourceType = db-instance 및SourceIdentifier = myDBInstance1)를 모두 지정하면 지정된 소스의 모든 db-instance 이벤트에 대한 알림을 받게 됩니다. 하지만 SourceType을 지정하지만 SourceIdentifier를 지정하지 않으면 모든 Amazon DocumentDB 소스에 대한 소스 유형의 이벤트만 알림 메시지로 받게 됩니다. SourceType 또는 SourceIdentifier를 둘 다 지정하지 않으면 고객 계정에 속하는 모든 Amazon DocumentDB 소스에서 발생하는 이벤트의 알림을 받게 됩니다.
요청 파라미터
모든 작업에 공통되는 파라미터에 대한 자세한 내용은 공통 파라미터를 참조하십시오.
- SnsTopicArn
-
이벤트 알림을 위해 생성한 SNS 주제의 Amazon 리소스 이름(ARN)입니다. Amazon SNS는 주제를 생성하고 구독할 때 ARN을 생성합니다.
유형: 문자열
필수 항목 여부: 예
- SubscriptionName
-
구독의 이름.
제약: 이름은 255자 미만이어야 합니다.
유형: 문자열
필수 항목 여부: 예
- Enabled
-
부울 값입니다. 구독을 활성화하려면
true로 설정하고, 구독을 생성만 하고 활성화하지 않으려면false로 설정합니다.유형: 부울
필수 항목 여부: 아니요
- EventCategories.EventCategory.N
-
구독할
SourceType의 이벤트 범주 목록입니다.유형: 문자열 배열
필수 여부: 아니요
- SourceIds.SourceId.N
-
반환되는 이벤트에 대한 이벤트 소스 식별자 목록입니다. 지정하지 않으면 모든 소스가 응답에 포함됩니다. 식별자는 문자로 시작해야 하고, ASCII 문자, 숫자 및 하이픈만 포함할 수 있으며, 하이픈으로 끝나거나 하이픈을 연속으로 두 개 사용하면 안 됩니다.
제약 조건:
-
SourceIds이 제공된 경우SourceType도 제공해야 합니다. -
소스 유형이 인스턴스라면
DBInstanceIdentifier을 제공해야 합니다. -
소스 유형이 보안 그룹이라면
DBSecurityGroupName을 제공해야 합니다. -
소스 유형이 파라미터 그룹이라면
DBParameterGroupName을 제공해야 합니다. -
소스 유형이 스냅샷이라면
DBSnapshotIdentifier을 제공해야 합니다.
유형: 문자열 배열
필수 여부: 아니요
-
- SourceType
-
이벤트가 발생하는 소스의 유형입니다. 예를 들어, 인스턴스에서 생성되는 이벤트에 대한 알림을 받으려면 이 파라미터를
db-instance로 설정합니다. 이 값을 지정하지 않으면 모든 이벤트가 반환됩니다.유효한 값:
db-instance,db-cluster,db-parameter-group,db-security-group,db-cluster-snapshot유형: 문자열
필수 항목 여부: 아니요
- Tags.Tag.N
-
이벤트 구독에 할당할 태그입니다.
유형: Tag 객체 배열
필수 여부: 아니요
응답 요소
서비스에서 다음 요소를 반환합니다.
- EventSubscription
-
구독한 이벤트에 대한 세부 정보.
유형: EventSubscription 객체
오류
모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 일반적인 오류 단원을 참조하십시오.
- EventSubscriptionQuotaExceeded
-
최대 이벤트 구독 수에 도달했습니다.
HTTP 상태 코드: 400
- SNSInvalidTopic
-
Amazon SNS에서 지정된 주제에 문제가 있다고 응답했습니다.
HTTP 상태 코드: 400
- SNSNoAuthorization
-
SNS 주제 Amazon 리소스 이름(ARN) 에 게시할 권한이 없습니다.
HTTP 상태 코드: 400
- SNSTopicArnNotFound
-
SNS 주제 Amazon 리소스 이름(ARN)이 존재하지 않습니다
HTTP 상태 코드: 404
- SourceNotFound
-
요청한 소스를 찾을 수 없습니다.
HTTP 상태 코드: 404
- SubscriptionAlreadyExist
-
입력한 구독 이름이 이미 존재합니다.
HTTP 상태 코드: 400
- SubscriptionCategoryNotFound
-
제공된 범주가 존재하지 않습니다.
HTTP 상태 코드: 404
참고
언어별 AWS SDKs
