

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

# Neptune 이벤트 API
<a name="api-events"></a>

**작업**
+ [CreateEventSubscription(작업)](#CreateEventSubscription)
+ [DeleteEventSubscription(작업)](#DeleteEventSubscription)
+ [ModifyEventSubscription(작업)](#ModifyEventSubscription)
+ [DescribeEventSubscriptions(작업)](#DescribeEventSubscriptions)
+ [AddSourceIdentifierToSubscription(작업)](#AddSourceIdentifierToSubscription)
+ [RemoveSourceIdentifierFromSubscription(작업)](#RemoveSourceIdentifierFromSubscription)
+ [DescribeEvents(작업)](#DescribeEvents)
+ [DescribeEventCategories(작업)](#DescribeEventCategories)

**구조:**
+ [이벤트(구조)](#Event)
+ [EventCategoriesMap(구조)](#EventCategoriesMap)
+ [EventSubscription(구조)](#EventSubscription)

## CreateEventSubscription(작업)
<a name="CreateEventSubscription"></a>

         이 API의 AWS CLI 이름은 `create-event-subscription`입니다.

이벤트 알림 구독을 생성합니다. 이 작업을 하려면 Neptune 콘솔, SNS 콘솔 또는 SNS API에서 생성한 주제 ARN(Amazon 리소스 이름)이 필요합니다. SNS를 통해 ARN을 받으려면 Amazon SNS에서 주제를 생성하고 그 주제를 구독해야 합니다. ARN이 SNS 콘솔에 표시됩니다.

알림을 받으려는 소스 유형(SourceType)을 지정하고, 이벤트를 트리거하는 Neptune 소스(SourceIds)의 목록을 제공하고, 알림을 받고자 하는 이벤트의 이벤트 범주(EventCategories) 목록을 제공할 수 있습니다. 예를 들어 SourceType = db-instance, SourceIds = mydbinstance1, mydbinstance2 및 EventCategories = Availability, Backup으로 지정할 수 있습니다.

SourceType = db-instance 및 SourceIdentifier = myDBInstance1과 같이 SourceType과 SourceIds를 둘 다 지정하면 지정된 소스에 대한 모든 db-instance 이벤트를 알려 줍니다. SourceType만 지정하고 SourceIdentifier는 지정하지 않으면 모든 Neptune 소스 중 해당 소스 유형의 이벤트만 알림을 받게 됩니다. SourceType과 SourceIdentifier를 둘 다 지정하지 않으면 고객 계정에 속하는 모든 Neptune 소스에서 발생하는 이벤트의 알림을 받게 됩니다.

**요청**
+ **Enabled**(CLI의 경우: `--enabled`) - BooleanOptional, 유형은 `boolean`(부울(true 또는 false) 값)입니다.

   부울 값입니다. 구독을 활성화하려면 **true**로 설정하고, 구독을 생성만 하고 활성화하지 않으려면 **false**로 설정합니다.
+ **EventCategories**(CLI의 경우: `--event-categories`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

   구독할 SourceType의 이벤트 범주 목록입니다. **DescribeEventCategories** 작업을 사용하여 지정된 SourceType의 범주 목록을 볼 수 있습니다.
+ **SnsTopicArn**(CLI의 경우: `--sns-topic-arn`) - *필수:* String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림을 위해 생성한 SNS 주제의 Amazon 리소스 이름(ARN)입니다. 주제를 만들고 구독하면 Amazon SNS에서 ARN이 생성됩니다.
+ **SourceIds**(CLI의 경우: `--source-ids`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  반환되는 이벤트에 대한 이벤트 소스 식별자 목록입니다. 지정하지 않으면 모든 소스가 응답에 포함됩니다. 식별자는 문자로 시작해야 하고, ASCII 문자, 숫자 및 하이픈만 포함할 수 있으며, 하이픈으로 끝나거나 하이픈을 연속으로 두 개 사용하면 안 됩니다.

  제약 조건:
  + SourceIds를 입력했으면 SourceType도 입력해야 합니다.
  + 소스 유형이 DB 인스턴스라면 `DBInstanceIdentifier`를 입력해야 합니다.
  + 소스 유형이 DB 보안 그룹이라면 `DBSecurityGroupName`을 입력해야 합니다.
  + 소스 유형이 DB 파라미터 그룹이라면 `DBParameterGroupName`을 입력해야 합니다.
  + 소스 유형이 DB 스냅샷이라면 `DBSnapshotIdentifier`를 입력해야 합니다.
+ **SourceType**(CLI의 경우: `--source-type`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트가 발생하는 소스의 유형입니다. 예를 들어, DB 인스턴스에 의해 발생하는 이벤트에 대한 알림을 받으려면 이 파라미터를 db-instance로 설정합니다. 이 값을 지정하지 않으면 모든 이벤트가 반환됩니다.

  유효한 값: `db-instance` \| `db-cluster` \| `db-parameter-group` \| `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
+ **SubscriptionName**(CLI의 경우: `--subscription-name`) - *필수:* String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  구독의 이름.

  제약: 이름은 255자 미만이어야 합니다.
+ **Tags**(CLI의 경우: `--tags`) - [태그](api-other-apis.md#Tag) 객체의 배열입니다.

  새 이벤트 구독에 적용할 태그입니다.

**응답**:

성공한 [DescribeEventSubscriptions(작업)](#DescribeEventSubscriptions) 작업 호출의 결과가 포함되어 있습니다.
+ **CustomerAwsId** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독과 연결된 Amazon 고객 계정입니다.
+ **CustSubscriptionId** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독 ID입니다.
+ **Enabled** - Boolean, 유형은 `boolean`(부울(true 또는 false) 값)입니다.

  구독의 활성화 여부를 나타내는 부울 값입니다. True는 구독이 활성화되었음을 나타냅니다.
+ **EventCategoriesList** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 이벤트 범주 목록입니다.
+ **EventSubscriptionArn** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 구독의 Amazon 리소스 이름(ARN)입니다.
+ **SnsTopicArn** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 주제 ARN입니다.
+ **SourceIdsList** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 소스 ID 목록입니다.
+ **SourceType** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 소스 유형입니다.
+ **Status** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 상태입니다.

  제약 조건:

  생성 중 \| 수정 중 \| 삭제 중 \| 활성 \| 권한 없음 \| 주제가 존재하지 않음 중 하나일 수 있습니다.

  "권한 없음" 상태는 Neptune이 더 이상 해당 SNS 주제에 게시할 권한이 없음을 나타냅니다. "주제가 존재하지 않음" 상태는 구독을 생성한 후 그 주제가 삭제되었음을 나타냅니다.
+ **SubscriptionCreationTime** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독을 생성한 시간입니다.

**오류**
+ [EventSubscriptionQuotaExceededFault](api-faults.md#EventSubscriptionQuotaExceededFault)
+ [SubscriptionAlreadyExistFault](api-faults.md#SubscriptionAlreadyExistFault)
+ [SNSInvalidTopicFault](api-faults.md#SNSInvalidTopicFault)
+ [SNSNoAuthorizationFault](api-faults.md#SNSNoAuthorizationFault)
+ [SNSTopicArnNotFoundFault](api-faults.md#SNSTopicArnNotFoundFault)
+ [SubscriptionCategoryNotFoundFault](api-faults.md#SubscriptionCategoryNotFoundFault)
+ [SourceNotFoundFault](api-faults.md#SourceNotFoundFault)

## DeleteEventSubscription(작업)
<a name="DeleteEventSubscription"></a>

         이 API의 AWS CLI 이름은 `delete-event-subscription`입니다.

이벤트 알림 구독을 삭제합니다.

**요청**
+ **SubscriptionName**(CLI의 경우: `--subscription-name`) - *필수:* String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  삭제할 이벤트 알림 구독의 이름입니다.

**응답**:

성공한 [DescribeEventSubscriptions(작업)](#DescribeEventSubscriptions) 작업 호출의 결과가 포함되어 있습니다.
+ **CustomerAwsId** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독과 연결된 Amazon 고객 계정입니다.
+ **CustSubscriptionId** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독 ID입니다.
+ **Enabled** - Boolean, 유형은 `boolean`(부울(true 또는 false) 값)입니다.

  구독의 활성화 여부를 나타내는 부울 값입니다. True는 구독이 활성화되었음을 나타냅니다.
+ **EventCategoriesList** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 이벤트 범주 목록입니다.
+ **EventSubscriptionArn** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 구독의 Amazon 리소스 이름(ARN)입니다.
+ **SnsTopicArn** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 주제 ARN입니다.
+ **SourceIdsList** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 소스 ID 목록입니다.
+ **SourceType** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 소스 유형입니다.
+ **Status** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 상태입니다.

  제약 조건:

  생성 중 \| 수정 중 \| 삭제 중 \| 활성 \| 권한 없음 \| 주제가 존재하지 않음 중 하나일 수 있습니다.

  "권한 없음" 상태는 Neptune이 더 이상 해당 SNS 주제에 게시할 권한이 없음을 나타냅니다. "주제가 존재하지 않음" 상태는 구독을 생성한 후 그 주제가 삭제되었음을 나타냅니다.
+ **SubscriptionCreationTime** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독을 생성한 시간입니다.

**오류**
+ [SubscriptionNotFoundFault](api-faults.md#SubscriptionNotFoundFault)
+ [InvalidEventSubscriptionStateFault](api-faults.md#InvalidEventSubscriptionStateFault)

## ModifyEventSubscription(작업)
<a name="ModifyEventSubscription"></a>

         이 API의 AWS CLI 이름은 `modify-event-subscription`입니다.

기존 이벤트 알림 구독을 수정합니다. 이 호출로는 소스 식별자를 수정할 수 없습니다. 구독의 소스 식별자를 변경하려면 [AddSourceIdentifierToSubscription(작업)](#AddSourceIdentifierToSubscription) 및 [RemoveSourceIdentifierFromSubscription(작업)](#RemoveSourceIdentifierFromSubscription) 호출을 사용하십시오.

**DescribeEventCategories** 작업을 사용하여 지정된 SourceType의 이벤트 범주 목록을 볼 수 있습니다.

**요청**
+ **Enabled**(CLI의 경우: `--enabled`) - BooleanOptional, 유형은 `boolean`(부울(true 또는 false) 값)입니다.

   부울 값입니다. 구독을 활성화하려면 **true**로 설정합니다.
+ **EventCategories**(CLI의 경우: `--event-categories`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

   구독할 SourceType의 이벤트 범주 목록입니다. **DescribeEventCategories** 작업을 사용하여 지정된 SourceType의 범주 목록을 볼 수 있습니다.
+ **SnsTopicArn**(CLI의 경우: `--sns-topic-arn`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림을 위해 생성한 SNS 주제의 Amazon 리소스 이름(ARN)입니다. 주제를 만들고 구독하면 Amazon SNS에서 ARN이 생성됩니다.
+ **SourceType**(CLI의 경우: `--source-type`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트가 발생하는 소스의 유형입니다. 예를 들어, DB 인스턴스에 의해 발생하는 이벤트에 대한 알림을 받으려면 이 파라미터를 db-instance로 설정합니다. 이 값을 지정하지 않으면 모든 이벤트가 반환됩니다.

  유효한 값: db-instance \| db-parameter-group \| db-security-group \| db-snapshot
+ **SubscriptionName**(CLI의 경우: `--subscription-name`) - *필수:* String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 이름입니다.

**응답**:

성공한 [DescribeEventSubscriptions(작업)](#DescribeEventSubscriptions) 작업 호출의 결과가 포함되어 있습니다.
+ **CustomerAwsId** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독과 연결된 Amazon 고객 계정입니다.
+ **CustSubscriptionId** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독 ID입니다.
+ **Enabled** - Boolean, 유형은 `boolean`(부울(true 또는 false) 값)입니다.

  구독의 활성화 여부를 나타내는 부울 값입니다. True는 구독이 활성화되었음을 나타냅니다.
+ **EventCategoriesList** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 이벤트 범주 목록입니다.
+ **EventSubscriptionArn** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 구독의 Amazon 리소스 이름(ARN)입니다.
+ **SnsTopicArn** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 주제 ARN입니다.
+ **SourceIdsList** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 소스 ID 목록입니다.
+ **SourceType** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 소스 유형입니다.
+ **Status** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 상태입니다.

  제약 조건:

  생성 중 \| 수정 중 \| 삭제 중 \| 활성 \| 권한 없음 \| 주제가 존재하지 않음 중 하나일 수 있습니다.

  "권한 없음" 상태는 Neptune이 더 이상 해당 SNS 주제에 게시할 권한이 없음을 나타냅니다. "주제가 존재하지 않음" 상태는 구독을 생성한 후 그 주제가 삭제되었음을 나타냅니다.
+ **SubscriptionCreationTime** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독을 생성한 시간입니다.

**오류**
+ [EventSubscriptionQuotaExceededFault](api-faults.md#EventSubscriptionQuotaExceededFault)
+ [SubscriptionNotFoundFault](api-faults.md#SubscriptionNotFoundFault)
+ [SNSInvalidTopicFault](api-faults.md#SNSInvalidTopicFault)
+ [SNSNoAuthorizationFault](api-faults.md#SNSNoAuthorizationFault)
+ [SNSTopicArnNotFoundFault](api-faults.md#SNSTopicArnNotFoundFault)
+ [SubscriptionCategoryNotFoundFault](api-faults.md#SubscriptionCategoryNotFoundFault)

## DescribeEventSubscriptions(작업)
<a name="DescribeEventSubscriptions"></a>

         이 API의 AWS CLI 이름은 `describe-event-subscriptions`입니다.

고객 계정의 모든 구독 설명을 나열합니다. 구독 설명에는 SubscriptionName, SNSTopicARN, CustomerID, SourceType, SourceID, CreationTime 및 Status가 포함됩니다.

SubscriptionName을 지정하면 해당 구독의 설명이 나열됩니다.

**요청**
+ **Filters**(CLI의 경우: `--filters`) - [필터](api-datatypes.md#Filter) 객체의 배열입니다.

  현재 지원되지 않는 파라미터입니다.
+ **Marker**(CLI의 경우: `--marker`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

   이전의 DescribeOrderableDBInstanceOptions 요청에서 제공된 선택적 페이지 매김 토큰입니다. 이 파라미터를 지정한 경우, 마커 이후부터 `MaxRecords`에 지정된 값까지의 레코드만 응답에 포함됩니다.
+ **MaxRecords**(CLI의 경우: `--max-records`) - IntegerOptional, 유형은 `integer`(32비트 부호 있는 정수)입니다.

   응답에 포함되는 최대 레코드 수입니다. 지정된 `MaxRecords` 값보다 레코드 수가 많으면 마커라고 부르는 페이지 매김 토큰을 응답에 포함시켜 나머지 결과를 검색할 수 있도록 합니다.

  기본값: 100

  제약: 최소 20, 최대 100입니다.
+ **SubscriptionName**(CLI의 경우: `--subscription-name`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  설명할 이벤트 알림 구독의 이름입니다.

**응답**:
+ **EventSubscriptionsList** – [EventSubscription](#EventSubscription) 객체의 배열입니다.

  EventSubscriptions 데이터 형식의 목록입니다.
+ **Marker** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

   이전의 DescribeOrderableDBInstanceOptions 요청에서 제공된 선택적 페이지 매김 토큰입니다. 이 파라미터를 지정한 경우, 마커 이후부터 `MaxRecords`에 지정된 값까지의 레코드만 응답에 포함됩니다.

**오류**
+ [SubscriptionNotFoundFault](api-faults.md#SubscriptionNotFoundFault)

## AddSourceIdentifierToSubscription(작업)
<a name="AddSourceIdentifierToSubscription"></a>

         이 API의 AWS CLI 이름은 `add-source-identifier-to-subscription`입니다.

기존의 이벤트 알림 구독에 소스 식별자를 추가합니다.

**요청**
+ **SourceIdentifier**(CLI의 경우: `--source-identifier`) - *필수:* String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  추가할 이벤트 소스의 식별자입니다.

  제약 조건:
  + 소스 유형이 DB 인스턴스라면 `DBInstanceIdentifier`를 입력해야 합니다.
  + 소스 유형이 DB 보안 그룹이라면 `DBSecurityGroupName`을 입력해야 합니다.
  + 소스 유형이 DB 파라미터 그룹이라면 `DBParameterGroupName`을 입력해야 합니다.
  + 소스 유형이 DB 스냅샷이라면 `DBSnapshotIdentifier`를 입력해야 합니다.
+ **SubscriptionName**(CLI의 경우: `--subscription-name`) - *필수:* String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  소스 식별자를 추가하려는 이벤트 알림 구독의 이름입니다.

**응답**:

성공한 [DescribeEventSubscriptions(작업)](#DescribeEventSubscriptions) 작업 호출의 결과가 포함되어 있습니다.
+ **CustomerAwsId** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독과 연결된 Amazon 고객 계정입니다.
+ **CustSubscriptionId** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독 ID입니다.
+ **Enabled** - Boolean, 유형은 `boolean`(부울(true 또는 false) 값)입니다.

  구독의 활성화 여부를 나타내는 부울 값입니다. True는 구독이 활성화되었음을 나타냅니다.
+ **EventCategoriesList** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 이벤트 범주 목록입니다.
+ **EventSubscriptionArn** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 구독의 Amazon 리소스 이름(ARN)입니다.
+ **SnsTopicArn** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 주제 ARN입니다.
+ **SourceIdsList** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 소스 ID 목록입니다.
+ **SourceType** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 소스 유형입니다.
+ **Status** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 상태입니다.

  제약 조건:

  생성 중 \| 수정 중 \| 삭제 중 \| 활성 \| 권한 없음 \| 주제가 존재하지 않음 중 하나일 수 있습니다.

  "권한 없음" 상태는 Neptune이 더 이상 해당 SNS 주제에 게시할 권한이 없음을 나타냅니다. "주제가 존재하지 않음" 상태는 구독을 생성한 후 그 주제가 삭제되었음을 나타냅니다.
+ **SubscriptionCreationTime** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독을 생성한 시간입니다.

**오류**
+ [SubscriptionNotFoundFault](api-faults.md#SubscriptionNotFoundFault)
+ [SourceNotFoundFault](api-faults.md#SourceNotFoundFault)

## RemoveSourceIdentifierFromSubscription(작업)
<a name="RemoveSourceIdentifierFromSubscription"></a>

         이 API의 AWS CLI 이름은 `remove-source-identifier-from-subscription`입니다.

기존의 이벤트 알림 구독에서 소스 식별자를 제거합니다.

**요청**
+ **SourceIdentifier**(CLI의 경우: `--source-identifier`) - *필수:* String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

   DB 인스턴스의 **DB 인스턴스 식별자** 또는 보안 그룹의 이름 등 구독에서 제거할 소스 식별자입니다.
+ **SubscriptionName**(CLI의 경우: `--subscription-name`) - *필수:* String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  소스 식별자를 제거하려는 이벤트 알림 구독의 이름입니다.

**응답**:

성공한 [DescribeEventSubscriptions(작업)](#DescribeEventSubscriptions) 작업 호출의 결과가 포함되어 있습니다.
+ **CustomerAwsId** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독과 연결된 Amazon 고객 계정입니다.
+ **CustSubscriptionId** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독 ID입니다.
+ **Enabled** - Boolean, 유형은 `boolean`(부울(true 또는 false) 값)입니다.

  구독의 활성화 여부를 나타내는 부울 값입니다. True는 구독이 활성화되었음을 나타냅니다.
+ **EventCategoriesList** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 이벤트 범주 목록입니다.
+ **EventSubscriptionArn** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 구독의 Amazon 리소스 이름(ARN)입니다.
+ **SnsTopicArn** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 주제 ARN입니다.
+ **SourceIdsList** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 소스 ID 목록입니다.
+ **SourceType** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 소스 유형입니다.
+ **Status** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 상태입니다.

  제약 조건:

  생성 중 \| 수정 중 \| 삭제 중 \| 활성 \| 권한 없음 \| 주제가 존재하지 않음 중 하나일 수 있습니다.

  "권한 없음" 상태는 Neptune이 더 이상 해당 SNS 주제에 게시할 권한이 없음을 나타냅니다. "주제가 존재하지 않음" 상태는 구독을 생성한 후 그 주제가 삭제되었음을 나타냅니다.
+ **SubscriptionCreationTime** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독을 생성한 시간입니다.

**오류**
+ [SubscriptionNotFoundFault](api-faults.md#SubscriptionNotFoundFault)
+ [SourceNotFoundFault](api-faults.md#SourceNotFoundFault)

## DescribeEvents(작업)
<a name="DescribeEvents"></a>

         이 API의 AWS CLI 이름은 `describe-events`입니다.

지난 14일 동안의 DB 인스턴스, DB 보안 그룹, DB 스냅샷 및 DB 파라미터 그룹과 관련된 이벤트를 반환합니다. 특정한 DB 인스턴스, DB 보안 그룹, 데이터베이스 스냅샷 또는 DB 파라미터 그룹의 이름을 파라미터로 입력하여 그에 해당하는 이벤트를 확인할 수 있습니다. 기본적으로 과거의 이벤트 시간이 반환됩니다.

**요청**
+ **Duration**(CLI의 경우: `--duration`) - IntegerOptional, 유형은 `integer`(32비트 부호 있는 정수)입니다.

  이벤트를 검색할 시간(분)입니다.

  기본값: 60
+ **EndTime**(CLI의 경우: `--end-time`) - TStamp, 유형은 `timestamp`(특정 시점, 일반적으로 1970-01-01 자정까지의 오프셋으로 정의됨)입니다.

   이벤트를 검색할 기간의 종료 시점을 ISO 8601 형식으로 지정합니다. ISO 8601에 대한 자세한 내용은 [ISO8601 위키피디아 페이지](http://en.wikipedia.org/wiki/ISO_8601)를 참조하십시오.

  예: 2009-07-08T18:00Z
+ **EventCategories**(CLI의 경우: `--event-categories`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독에서 알림을 트리거하는 이벤트 범주의 목록입니다.
+ **Filters**(CLI의 경우: `--filters`) - [필터](api-datatypes.md#Filter) 객체의 배열입니다.

  현재 지원되지 않는 파라미터입니다.
+ **Marker**(CLI의 경우: `--marker`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

   이전의 DescribeEvents 요청에서 제공된 선택적 페이지 매김 토큰입니다. 이 파라미터를 지정한 경우, 마커 이후부터 `MaxRecords`에 지정된 값까지의 레코드만 응답에 포함됩니다.
+ **MaxRecords**(CLI의 경우: `--max-records`) - IntegerOptional, 유형은 `integer`(32비트 부호 있는 정수)입니다.

   응답에 포함되는 최대 레코드 수입니다. 지정된 `MaxRecords` 값보다 레코드 수가 많으면 마커라고 부르는 페이지 매김 토큰을 응답에 포함시켜 나머지 결과를 검색할 수 있도록 합니다.

  기본값: 100

  제약: 최소 20, 최대 100입니다.
+ **SourceIdentifier**(CLI의 경우: `--source-identifier`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  반환되는 이벤트에 대한 이벤트 소스의 식별자입니다. 지정하지 않으면 모든 소스가 응답에 포함됩니다.

  제약 조건:
  + SourceIdentifier를 입력했으면 SourceType도 입력해야 합니다.
  + 소스 유형이 `DBInstance`라면 `DBInstanceIdentifier`를 입력해야 합니다.
  + 소스 유형이 `DBSecurityGroup`이라면 `DBSecurityGroupName`을 입력해야 합니다.
  + 소스 유형이 `DBParameterGroup`이라면 `DBParameterGroupName`을 입력해야 합니다.
  + 소스 유형이 `DBSnapshot`이라면 `DBSnapshotIdentifier`을 입력해야 합니다.
  + 하이픈으로 끝나거나 하이픈이 2개 연속으로 이어져서는 안 됩니다.
+ **SourceType**(CLI의 경우: `--source-type`) - SourceType, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트를 검색할 이벤트 소스입니다. 값을 지정하지 않으면 모든 이벤트가 반환됩니다.
+ **StartTime**(CLI의 경우: `--start-time`) - TStamp, 유형은 `timestamp`(특정 시점, 일반적으로 1970-01-01 자정까지의 오프셋으로 정의됨)입니다.

   이벤트를 검색할 기간의 시작 시점을 ISO 8601 형식으로 지정합니다. ISO 8601에 대한 자세한 내용은 [ISO8601 위키피디아 페이지](http://en.wikipedia.org/wiki/ISO_8601)를 참조하십시오.

  예: 2009-07-08T18:00Z

**응답**:
+ **Events** – [Event](#Event) 객체의 배열입니다.

   [이벤트(구조)](#Event) 인스턴스의 목록입니다.
+ **Marker** - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

   이전의 Events 요청에서 제공된 선택적 페이지 매김 토큰입니다. 이 파라미터를 지정한 경우, 마커 이후부터 `MaxRecords`에 지정된 값까지의 레코드만 응답에 포함됩니다.

## DescribeEventCategories(작업)
<a name="DescribeEventCategories"></a>

         이 API의 AWS CLI 이름은 `describe-event-categories`입니다.

모든 이벤트 소스 유형 또는 지정된 경우 지정된 소스 유형에 대한 범주 목록을 표시합니다.

**요청**
+ **Filters**(CLI의 경우: `--filters`) - [필터](api-datatypes.md#Filter) 객체의 배열입니다.

  현재 지원되지 않는 파라미터입니다.
+ **SourceType**(CLI의 경우: `--source-type`) - String, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트가 발생하는 소스의 유형입니다.

  유효한 값: db-instance \| db-parameter-group \| db-security-group \| db-snapshot

**응답**:
+ **EventCategoriesMapList** – [EventCategoriesMap](#EventCategoriesMap) 객체의 배열입니다.

  EventCategoriesMap 데이터 형식의 목록입니다.

## *구조:*
<a name="api-events-structures-spacer"></a>

## 이벤트(구조)
<a name="Event"></a>

 이 데이터 형식은 [DescribeEvents(작업)](#DescribeEvents) 작업에서 응답 요소로 사용됩니다.

**Fields**
+ **Date** - TStamp, 유형은 `timestamp`(특정 시점, 일반적으로 1970-01-01 자정까지의 오프셋으로 정의됨)입니다.

  이벤트 날짜 및 시간을 지정합니다.
+ **EventCategories** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이 이벤트의 범주를 지정합니다.
+ **Message** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이 이벤트의 텍스트를 제공합니다.
+ **SourceArn** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트의 Amazon 리소스 이름(ARN)입니다.
+ **SourceIdentifier** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 소스의 식별자를 제공합니다.
+ **SourceType** - SourceType이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이 이벤트의 소스 유형을 지정합니다.

## EventCategoriesMap(구조)
<a name="EventCategoriesMap"></a>

성공한 [DescribeEventCategories(작업)](#DescribeEventCategories) 작업 호출의 결과가 포함되어 있습니다.

**Fields**
+ **EventCategories** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  지정된 소스 유형의 이벤트 범주입니다.
+ **SourceType** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  반환된 범주의 소스 유형입니다.

## EventSubscription(구조)
<a name="EventSubscription"></a>

성공한 [DescribeEventSubscriptions(작업)](#DescribeEventSubscriptions) 작업 호출의 결과가 포함되어 있습니다.

**Fields**
+ **CustomerAwsId** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독과 연결된 Amazon 고객 계정입니다.
+ **CustSubscriptionId** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독 ID입니다.
+ **Enabled** - Boolean, 유형은 `boolean`(부울(true 또는 false) 값)입니다.

  구독의 활성화 여부를 나타내는 부울 값입니다. True는 구독이 활성화되었음을 나타냅니다.
+ **EventCategoriesList** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 이벤트 범주 목록입니다.
+ **EventSubscriptionArn** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 구독의 Amazon 리소스 이름(ARN)입니다.
+ **SnsTopicArn** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 주제 ARN입니다.
+ **SourceIdsList** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 소스 ID 목록입니다.
+ **SourceType** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 소스 유형입니다.
+ **Status** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독의 상태입니다.

  제약 조건:

  생성 중 \| 수정 중 \| 삭제 중 \| 활성 \| 권한 없음 \| 주제가 존재하지 않음 중 하나일 수 있습니다.

  "권한 없음" 상태는 Neptune이 더 이상 해당 SNS 주제에 게시할 권한이 없음을 나타냅니다. "주제가 존재하지 않음" 상태는 구독을 생성한 후 그 주제가 삭제되었음을 나타냅니다.
+ **SubscriptionCreationTime** - String이며, 유형은 `string`(UTF-8 인코딩 문자열)입니다.

  이벤트 알림 구독을 생성한 시간입니다.

`EventSubscription`는 다음의 응답 요소로 사용됩니다.
+ [CreateEventSubscription](#CreateEventSubscription)
+ [ModifyEventSubscription](#ModifyEventSubscription)
+ [AddSourceIdentifierToSubscription](#AddSourceIdentifierToSubscription)
+ [RemoveSourceIdentifierFromSubscription](#RemoveSourceIdentifierFromSubscription)
+ [DeleteEventSubscription](#DeleteEventSubscription)