

# Amazon RDS 이벤트 알림 작업
<a name="USER_Events"></a>

Amazon RDS는 Amazon RDS 이벤트 발생 시 Amazon Simple Notification Service(Amazon SNS)를 사용하여 알림 서비스를 제공합니다. 이 서비스는 AWS 리전에 따라 Amazon SNS가 지원하는 알림 메시지 형식에 따라 이메일, 문자 또는 HTTP 엔드포인트 호출 등이 될 수 있습니다.

**Topics**
+ [Amazon RDS 이벤트 알림 개요](USER_Events.overview.md)
+ [Amazon SNS 주제에 알림을 게시할 권한 부여](USER_Events.GrantingPermissions.md)
+ [Amazon RDS 이벤트 알림 구독](USER_Events.Subscribing.md)
+ [Amazon RDS 이벤트 알림 태그 및 속성](USER_Events.TagsAttributesForFiltering.md)
+ [Amazon RDS 이벤트 알림 구독의 목록 표시](USER_Events.ListSubscription.md)
+ [Amazon RDS 이벤트 알림 구독 수정](USER_Events.Modifying.md)
+ [Amazon RDS 이벤트 알림 구독에 소스 식별자 추가](USER_Events.AddingSource.md)
+ [Amazon RDS 이벤트 알림 구독에서 소스 식별자 제거](USER_Events.RemovingSource.md)
+ [Amazon RDS 이벤트 알림 카테고리의 목록 표시](USER_Events.ListingCategories.md)
+ [Amazon RDS 이벤트 알림 구독 삭제](USER_Events.Deleting.md)

# Amazon RDS 이벤트 알림 개요
<a name="USER_Events.overview"></a>

Amazon RDS는 구독 가능한 카테고리로 이벤트를 그룹화합니다. 따라서 해당 카테고리의 이벤트가 발생했을 때 이에 대한 알림 메시지를 받을 수 있습니다.

**Topics**
+ [이벤트 구독에 적합한 RDS 리소스](#USER_Events.overview.resources)
+ [Amazon RDS 이벤트 알림을 구독하는 기본 프로세스](#USER_Events.overview.process)
+ [RDS 이벤트 알림 전송](#USER_Events.overview.subscriptions)
+ [Amazon RDS 이벤트 알림 결제](#USER_Events.overview.billing)
+ [Amazon EventBridge를 사용한 Aurora 이벤트의 예](#events-examples)

## 이벤트 구독에 적합한 RDS 리소스
<a name="USER_Events.overview.resources"></a>

Amazon Aurora의 경우 이벤트는 DB 클러스터와 DB 인스턴스 수준 모두에서 발생합니다.  다음 리소스에 대한 이벤트 범주에 구독할 수 있습니다.
+ DB 인스턴스
+ DB 클러스터
+ DB 클러스터 스냅샷
+ DB 파라미터 그룹
+ DB 보안 그룹
+ RDS 프록시
+ 커스텀 엔진 버전

예를 들어 임의의 DB 인스턴스에 대한 백업 카테고리를 구독할 경우 백업 관련 이벤트가 발생하여 DB 인스턴스에 영향을 끼칠 때마다 알림 메시지가 수신됩니다. 혹은 DB 인스턴스의 구성 변경 카테고리를 구독하면 DB 인스턴스가 변경될 때마다 메시지가 수신됩니다. 또한 이벤트 알림 메시지 구독이 변경되어도 알림 메시지가 수신됩니다.

여러 가지 다른 구독을 만들 수 있습니다. 예를 들어, 전체 DB 인스턴스에 대한 모든 이벤트 알림을 수신하는 하나의 구독과 DB 인스턴스의 하위 집합에 대한 중요 이벤트만 포함하는 다른 구독을 만들 수 있습니다. 두 번째 구독의 경우 필터에 하나 이상의 DB 인스턴스를 지정합니다.

## Amazon RDS 이벤트 알림을 구독하는 기본 프로세스
<a name="USER_Events.overview.process"></a>

Amazon RDS 이벤트 알림 서비스를 구독하는 프로세스는 다음과 같습니다.

1. Amazon RDS 콘솔, AWS CLI 또는 API를 사용하여 Amazon RDS 이벤트 알림 서비스 구독을 생성합니다.

   Amazon RDS에서는 Amazon SNS 주제의 ARN을 사용하여 각 구독을 식별합니다. Amazon RDS 콘솔은 구독 생성 시 ARN을 생성합니다. Amazon SNS 콘솔인 AWS CLI 또는 Amazon SNS API를 사용하여 ARN을 생성합니다.

1. Amazon RDS가 구독 생성 시 제출한 이메일 주소로 승인 이메일 또는 SMS 메시지를 전송합니다.

1. 전송된 알림의 링크를 선택하여 구독 여부를 확인합니다.

1. Amazon RDS 콘솔은 구독 상태로 **내 이벤트 구독** 섹션을 업데이트합니다.

1. Amazon RDS는 구독을 생성할 때 제공한 주소로 알림을 보내기 시작합니다.

Amazon SNS 사용 시 자격 증명 및 액세스 관리에 대한 자세한 내용은 *Amazon Simple Notification Service 개발자 가이드*의 [Amazon SNS의 Identity and Access Management](https://docs.aws.amazon.com/sns/latest/dg/sns-authentication-and-access-control.html)를 참조하세요.

AWS Lambda를 사용하여 DB 인스턴스의 이벤트 알림을 처리할 수 있습니다. 자세한 내용은 *AWS Lambda 개발자 안내서*의 [Amazon RDS에서 AWS Lambda 사용](https://docs.aws.amazon.com/lambda/latest/dg/services-rds.html)을 참조하세요.

## RDS 이벤트 알림 전송
<a name="USER_Events.overview.subscriptions"></a>

Amazon RDS는 구독 생성 시 입력한 주소로 알림을 보냅니다. 알림에는 메시지에 대한 구조화된 메타데이터를 제공하는 메시지 속성이 포함될 수 있습니다. 메시지 속성에 대한 자세한 내용은 [Amazon RDS 이벤트 카테고리 및 Aurora용 이벤트 메시지](USER_Events.Messages.md) 단원을 참조하세요.

이벤트 알림을 전달하는 데 최대 5분 정도 걸릴 수 있습니다.

**중요**  
Amazon RDS는 이벤트 스트림에서 전송된 이벤트 순서를 보장하지 않습니다. 이벤트 순서는 변경될 수 있습니다.

Amazon SNS이 구독된 HTTP 또는 HTTPS 엔드포인트에 알림을 전송할 때 엔드포인트에 전송된 POST 메시지에는 JSON 문서를 포함하는 메시지 본문이 있습니다. 자세한 내용은 *Amazon Simple Notification Service 개발자 안내서*의 [Amazon SNS 메시지 및 JSON 형식](https://docs.aws.amazon.com/sns/latest/dg/sns-message-and-json-formats.html)을 참조하십시오.

문자 메시지로 알리도록 SNS를 구성할 수 있습니다. 자세한 내용은 *Amazon Simple Notification Service 개발자 가이드*의 [모바일 문자 메시지(SMS)](https://docs.aws.amazon.com/sns/latest/dg/sns-mobile-phone-number-as-subscriber.html)를 참조하세요.

구독을 삭제하지 않고 알림을 끄려면 Amazon RDS 콘솔에서 **활성**에 대해 **아니요**를 선택합니다. 또는 AWS CLI 또는 Amazon RDS API를 사용하여 `Enabled` 파라미터를 `false`(으)로 설정할 수 있습니다.

## Amazon RDS 이벤트 알림 결제
<a name="USER_Events.overview.billing"></a>

Amazon RDS 이벤트 알림에 대한 결제는 Amazon SNS를 통해 이루어집니다. Amazon SNS 요금은 이벤트 알림 사용 시 적용됩니다. Amazon SNS 결제에 대한 자세한 내용은 [Amazon Simple Notification Service 요금](https://aws.amazon.com/sns/#pricing)을 참조하세요.

## Amazon EventBridge를 사용한 Aurora 이벤트의 예
<a name="events-examples"></a>

다음 예에서는 JSON 형식으로 다양한 Aurora 이벤트 유형을 보여줍니다. JSON 형식으로 이벤트를 캡처하고 보는 방법을 보여 주는 자습서는 [자습서: Amazon EventBridge를 사용하여 DB 인스턴스의 상태 변경 로깅](rds-cloud-watch-events.md#log-rds-instance-state) 단원을 참조하세요.

**Topics**
+ [DB 클러스터 이벤트의 예](#rds-cloudwatch-events.db-clusters)
+ [DB 파라미터 그룹 이벤트의 예](#rds-cloudwatch-events.db-parameter-groups)
+ [DB 클러스터 스냅샷 이벤트의 예](#rds-cloudwatch-events.db-cluster-snapshots)

### DB 클러스터 이벤트의 예
<a name="rds-cloudwatch-events.db-clusters"></a>

다음은 JSON 형식의 DB 클러스터 이벤트에 대한 예제입니다. 이 이벤트는 이름이 `my-db-cluster`인 클러스터에 패치가 적용되었음을 보여줍니다. 이벤트 ID는 `RDS-EVENT-0173`입니다.

```
{
  "version": "0",
  "id": "844e2571-85d4-695f-b930-0153b71dcb42",
  "detail-type": "RDS DB Cluster Event",
  "source": "aws.rds",
  "account": "123456789012",
  "time": "2018-10-06T12:26:13Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:rds:us-east-1:123456789012:cluster:my-db-cluster"
  ],
  "detail": {
    "EventCategories": [
      "notification"
    ],
    "SourceType": "CLUSTER",
    "SourceArn": "arn:aws:rds:us-east-1:123456789012:cluster:my-db-cluster",
    "Date": "2018-10-06T12:26:13.882Z",
    "Message": "Database cluster has been patched",
    "SourceIdentifier": "my-db-cluster",
    "EventID": "RDS-EVENT-0173"
  }
}
```

### DB 파라미터 그룹 이벤트의 예
<a name="rds-cloudwatch-events.db-parameter-groups"></a>

다음은 JSON 형식의 DB 파라미터 그룹 이벤트에 대한 예제입니다. 이 이벤트는 `time_zone` 파라미터가 파라미터 그룹 `my-db-param-group`에서 업데이트되었음을 보여줍니다. 이벤트 ID는 RDS-EVENT-0037입니다.

```
{
  "version": "0",
  "id": "844e2571-85d4-695f-b930-0153b71dcb42",
  "detail-type": "RDS DB Parameter Group Event",
  "source": "aws.rds",
  "account": "123456789012",
  "time": "2018-10-06T12:26:13Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:rds:us-east-1:123456789012:pg:my-db-param-group"
  ],
  "detail": {
    "EventCategories": [
      "configuration change"
    ],
    "SourceType": "DB_PARAM",
    "SourceArn": "arn:aws:rds:us-east-1:123456789012:pg:my-db-param-group",
    "Date": "2018-10-06T12:26:13.882Z",
    "Message": "Updated parameter time_zone to UTC with apply method immediate",
    "SourceIdentifier": "my-db-param-group",
    "EventID": "RDS-EVENT-0037"
  }
}
```

### DB 클러스터 스냅샷 이벤트의 예
<a name="rds-cloudwatch-events.db-cluster-snapshots"></a>

다음은 JSON 형식의 DB 클러스터 스냅샷 이벤트에 대한 예제입니다. 이 이벤트는 `my-db-cluster-snapshot`이라는 스냅샷의 생성을 보여줍니다. 이벤트 ID는 RDS-EVENT-0074입니다.

```
{
  "version": "0",
  "id": "844e2571-85d4-695f-b930-0153b71dcb42",
  "detail-type": "RDS DB Cluster Snapshot Event",
  "source": "aws.rds",
  "account": "123456789012",
  "time": "2018-10-06T12:26:13Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:rds:my-db-cluster-snapshot"
  ],
  "detail": {
    "EventCategories": [
      "backup"
    ],
    "SourceType": "CLUSTER_SNAPSHOT",
    "SourceArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:rds:my-db-cluster-snapshot",
    "Date": "2018-10-06T12:26:13.882Z",
    "SourceIdentifier": "my-db-cluster-snapshot",
    "Message": "Creating manual cluster snapshot",
    "EventID": "RDS-EVENT-0074"
  }
}
```

# Amazon SNS 주제에 알림을 게시할 권한 부여
<a name="USER_Events.GrantingPermissions"></a>

Amazon RDS 권한을 부여하여 알림을 Amazon Simple Notification Service(Amazon SNS) 주제에 게시하려면 대상 주제에 AWS Identity and Access Management(IAM) 정책을 연결하면 됩니다. 권한에 대한 자세한 내용은 *Amazon Simple Notification Service 개발자 안내서*의 [Amazon Simple Notification Service 액세스 제어 예제 사례](https://docs.aws.amazon.com/sns/latest/dg/sns-access-policy-use-cases.html)를 참조하세요.

기본적으로 Amazon SNS 주제에는 동일한 계정 내의 모든 Amazon RDS 리소스가 알림을 게시하도록 허용하는 정책이 있습니다. 교차 계정 알림을 허용하거나 특정 리소스에 대한 액세스를 제한하는 사용자 지정 정책을 연결할 수 있습니다.

다음은 대상 Amazon SNS 주제에 연결하는 IAM 정책의 예입니다. 지정된 접두사와 일치하는 이름을 가진 DB 인스턴스로 주제를 제한합니다. 이 정책을 사용하려면 다음 값을 지정합니다.
+ `Resource` – Amazon SNS 주제에 대한 Amazon 리소스 이름(ARN)
+ `SourceARN` - RDS 리소스 ARN
+ `SourceAccount` – 사용자의 AWS 계정 ID

리소스 유형 및 해당 ARN 목록을 보려면 *서비스 승인 참조*에서 [Amazon RDS에서 정의한 리소스](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonrds.html#amazonrds-resources-for-iam-policies)를 참조하세요.

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "events.rds.amazonaws.com"
      },
      "Action": [
        "sns:Publish"
      ],
      "Resource": "arn:aws:sns:us-east-1:123456789012:topic_name",
      "Condition": {
        "ArnLike": {
          "aws:SourceArn": "arn:aws:rds:us-east-1:123456789012:db:prefix-*"
        },
        "StringEquals": {
          "aws:SourceAccount": "123456789012"
        }
      }
    }
  ]
}
```

------

# Amazon RDS 이벤트 알림 구독
<a name="USER_Events.Subscribing"></a>

가장 간단한 구독 생성 방법은 RDS 콘솔입니다. CLI 또는 API를 사용하여 이벤트 알림 구독을 생성하려면 먼저 Amazon Simple Notification Service 주제를 만든 후 Amazon SNS 콘솔이나 Amazon SNS API를 통해 해당 주제를 구독해야 합니다. 또한 CLI 명령이나 API 작업을 제출할 때도 사용되기 때문에 해당 주제의 Amazon 리소스 이름(ARN)을 잊어서는 안 됩니다. SNS 주제를 새로 만들어 구독하는 방법에 대한 자세한 내용은 *Amazon Simple Notification Service 개발자 안내서*의 [Amazon SNS 시작하기](https://docs.aws.amazon.com/sns/latest/dg/GettingStarted.html) 단원을 참조하십시오.

알림 메시지를 받고 싶은 소스 유형과 이벤트를 트리거링하는 Amazon RDS 소스를 지정할 수 있습니다.

**소스 유형**  
소스 유형입니다. 예를 들어 **소스 유형**은 **인스턴스**일 수 있습니다. 소스 유형을 선택해야 합니다.

**포함할 *리소스***  
이벤트를 생성하는 Amazon RDS 리소스입니다. 예를 들어 **특정 인스턴스 선택**을 선택한 다음 **myDBInstance1**을 선택할 수 있습니다.

다음 테이블에서는 **포함할 *리소스***를 지정하거나 지정하지 않을 때의 결과를 설명합니다


|  포함할 리소스  |  설명  |  예  | 
| --- | --- | --- | 
|  지정됨  |  RDS는 지정된 리소스에 대한 모든 이벤트에 대해서만 알림을 보냅니다.  | 소스 유형이 인스턴스이고 리소스가 myDBInstance1인 경우 RDS는 myDBInstance1에 대한 모든 이벤트에 대해서만 알립니다. | 
|  지정되지 않음  |  RDS는 모든 Amazon RDS 리소스에 대해 지정된 소스 유형에 대한 이벤트를 알려줍니다.  |  **소스 유형**이 **인스턴스**인 경우 RDS는 계정의 모든 인스턴스 관련 이벤트에 대해 알려줍니다.  | 

Amazon SNS 주제 구독자는 기본적으로 주제에 게시된 모든 메시지를 수신합니다. 메시지의 하위 집합만 수신하려면 구독자는 주제 구독에 필터 정책을 할당해야 합니다. SNS 메시지 필터링에 대한 자세한 내용은 **Amazon Simple Notification Service 개발자 안내서의 [Amazon SNS 메시지 필터링](https://docs.aws.amazon.com/sns/latest/dg/sns-message-filtering.html)을 참조하세요.

## 콘솔
<a name="USER_Events.Subscribing.Console"></a>

**RDS 이벤트 알림 구독 방법**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)에서 Amazon RDS 콘솔을 엽니다.

1. 탐색 창에서 **이벤트 구독**을 선택합니다.

1. **이벤트 구독** 창에서 **이벤트 구독 생성**을 선택합니다.

1. 다음과 같이 구독 세부 정보를 입력합니다.

   1. **이름**에서 이벤트 알림 구독 이름을 입력합니다.

   1. **알림 보내기 대상**에게 다음 중 하나를 실시합니다.
      + **새 이메일 주제**를 선택합니다. 이메일 주제의 이름과 수신자 목록을 입력합니다. 기본 계정 연락처와 동일한 이메일 주소로 이벤트 구독을 구성하는 것이 좋습니다. 권장 사항, 서비스 이벤트 및 개인 건강 메시지는 다양한 채널을 사용하여 전송됩니다. 동일한 이메일 주소를 구독하면 모든 메시지가 한 위치에 통합됩니다.
      + **Amazon 리소스 이름(ARN)**을 선택합니다. 그런 다음 Amazon SNS 주제에 대해 기존 Amazon SNS ARN을 선택합니다.

        서버 측 암호화(SSE)에 대해 활성화된 주제를 사용하려면 AWS KMS key에 액세스하는 데 필요한 권한을 Amazon RDS에 부여하면 됩니다. 자세한 내용은 *Amazon Simple Notification Service 개발자 안내서*의 [AWS 서비스 및 암호화된 주제의 이벤트 소스 간 호환성 활성화](https://docs.aws.amazon.com/sns/latest/dg/sns-key-management.html#compatibility-with-aws-services)를 참조하세요.

   1. [**Source type**]에서 원본 형식을 선택합니다. 예를 들어 **클러스터** 또는 **클러스터 스냅샷**을 선택합니다.

   1. 이벤트 알림을 받을 이벤트 카테고리 및 리소스를 선택합니다.

      다음 예에서는 `testinst`라는 DB 인스턴스에 대한 이벤트 알림을 구성합니다.  
![\[소스 유형 입력\]](http://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/AuroraUserGuide/images/event-source.png)

   1. **생성**을 선택합니다.

Amazon RDS 콘솔에 현재 구독 생성 중으로 나옵니다.

![\[DB 이벤트 알림 구독의 목록 표시\]](http://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/AuroraUserGuide/images/EventNotification-Create2.png)


## AWS CLI
<a name="USER_Events.Subscribing.CLI"></a>

RDS 이벤트 알림을 구독하려면 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/create-event-subscription.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-event-subscription.html) 명령을 사용합니다. 다음 필수 파라미터를 포함합니다.
+ `--subscription-name`
+ `--sns-topic-arn`

**Example**  
대상 LinuxmacOS, 또는Unix:  

```
aws rds create-event-subscription \
    --subscription-name myeventsubscription \
    --sns-topic-arn arn:aws:sns:us-east-1:123456789012:myawsuser-RDS \
    --enabled
```
Windows의 경우:  

```
aws rds create-event-subscription ^
    --subscription-name myeventsubscription ^
    --sns-topic-arn arn:aws:sns:us-east-1:123456789012:myawsuser-RDS ^
    --enabled
```

## API
<a name="USER_Events.Subscribing.API"></a>

Amazon RDS 이벤트 알림을 구독하려면 Amazon RDS API 함수 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateEventSubscription.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateEventSubscription.html)을 호출합니다. 다음 필수 파라미터를 포함합니다.
+ `SubscriptionName`
+ `SnsTopicArn`

# Amazon RDS 이벤트 알림 태그 및 속성
<a name="USER_Events.TagsAttributesForFiltering"></a>

Amazon RDS에서 Amazon Simple Notification Service(SNS) 또는 Amazon EventBridge로 이벤트 알림을 전송할 경우, 알림에 메시지 속성과 이벤트 태그가 포함됩니다. RDS는 이벤트 태그가 메시지 본문에 있는 동안 메시지 속성을 메시지와 함께 별도로 전송합니다. 메시지 속성과 Amazon RDS 태그를 사용하여 메타데이터를 리소스에 추가할 수 있습니다. 이러한 태그를 DB 인스턴스, Aurora 클러스터 등에 대한 주석과 함께 수정할 수 있습니다. Amazon RDS 리소스 태그 지정에 대한 자세한 내용은 [Amazon Aurora 및Amazon RDS 리소스에 태그 지정](USER_Tagging.md) 단원을 참조하세요.

기본적으로 Amazon SNS 및 Amazon EventBridge는 전송되는 모든 메시지를 수신합니다. SNS 및 EventBridge는 메시지를 필터링할 수 있으며 이메일, 문자 메시지 또는 HTTP 엔드포인트로 수신되는 통화 같은 기본 커뮤니케이션 모드로 알림을 전송할 수 있습니다.

**참고**  
이메일이나 문자 메시지로 전송된 알림에는 이벤트 태그가 없습니다.

다음 표에는 주제 구독자에게 전송되는 RDS 이벤트의 메시지 속성이 나와 있습니다.


| Amazon RDS 이벤트 속성 |  설명  | 
| --- | --- | 
| EventID |  RDS 이벤트 메시지의 식별자는 예를 들어 RDS-EVENT-0006입니다.  | 
| 리소스 |  이벤트를 발생시키는 리소스의 ARN 식별자(예: `arn:aws:rds:ap-southeast-2:123456789012:db:database-1`)입니다.  | 

RDS 태그는 서비스 이벤트의 영향을 받은 리소스에 대한 데이터를 제공합니다. RDS는 알림이 SNS 또는 EventBridge로 전송될 때 메시지 본문에 태그의 현재 상태를 추가합니다.

SNS의 필터링 메시지 속성에 대한 자세한 내용은 *Amazon Simple Notification Service 개발자 안내서*의 [Amazon SNS 메시지 필터링](https://docs.aws.amazon.com/sns/latest/dg/sns-message-filtering.html)을 참조하세요.

EventBridge의 이벤트 태그 필터링에 대한 자세한 내용은 *Amazon EventBridge 사용 설명서*에서 [Amazon EventBridge 이벤트 패턴에 사용할 콘텐츠 비교 연산자](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns-content-based-filtering.html)를 참조하세요.

SNS에 대한 페이로드 기반 태그 필터링에 대한 자세한 내용은 [Introducing payload-based message filtering for Amazon SNS](https://aws.amazon.com/blogs/compute/introducing-payload-based-message-filtering-for-amazon-sns/)를 참조하세요.

# Amazon RDS 이벤트 알림 구독의 목록 표시
<a name="USER_Events.ListSubscription"></a>

현재 Amazon RDS 이벤트 알림 구독을 목록으로 표시할 수 있습니다.

## 콘솔
<a name="USER_Events.ListSubscription.Console"></a>

**현재 Amazon RDS 이벤트 알림 구독을 목록으로 표시하려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)에서 Amazon RDS 콘솔을 엽니다.

1.  탐색 창에서 [**Event subscriptions**]를 선택합니다. [**Event subscriptions**] 창에 이벤트 알림 구독이 모두 표시됩니다.  
![\[DB 이벤트 알림 구독의 목록 표시\]](http://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/AuroraUserGuide/images/EventNotification-ListSubs.png)

   

## AWS CLI
<a name="USER_Events.ListSubscription.CLI"></a>

현재 Amazon RDS 이벤트 알림 구독을 표시하려면 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-event-subscriptions.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-event-subscriptions.html) 명령을 사용합니다.

**Example**  
다음은 모든 이벤트 구독을 설명하는 예제입니다.  

```
aws rds describe-event-subscriptions
```
다음은 `myfirsteventsubscription`을 설명하는 예제입니다.  

```
aws rds describe-event-subscriptions --subscription-name myfirsteventsubscription
```

## API
<a name="USER_Events.ListSubscription.API"></a>

현재 Amazon RDS 이벤트 알림 구독을 표시하려면 Amazon RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeEventSubscriptions.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeEventSubscriptions.html) 작업을 사용합니다.

# Amazon RDS 이벤트 알림 구독 수정
<a name="USER_Events.Modifying"></a>

구독을 생성한 후에는 구독 이름, 소스 식별자, 카테고리 또는 주제 ARN을 변경할 수 있습니다.

## 콘솔
<a name="USER_Events.Modifying.Console"></a>

**Amazon RDS 이벤트 알림 구독을 변경하려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)에서 Amazon RDS 콘솔을 엽니다.

1.  탐색 창에서 [**Event subscriptions**]를 선택합니다.

1.  [**Event subscriptions**] 창에서 수정할 구독을 선택한 다음 [**Edit**]를 선택합니다.

1.  **대상** 또는 **원본** 섹션에서 구독을 변경합니다.

1. **편집**을 선택합니다. Amazon RDS 콘솔에 현재 구독 변경 중으로 나옵니다.  
![\[DB 이벤트 알림 구독의 목록 표시\]](http://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/AuroraUserGuide/images/EventNotification-Modify2.png)

   

## AWS CLI
<a name="USER_Events.Modifying.CLI"></a>

Amazon RDS 이벤트 알림 구독을 수정하려면, AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-event-subscription.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-event-subscription.html) 명령을 사용합니다. 다음 필수 파라미터를 포함합니다.
+ `--subscription-name`

**Example**  
다음 코드를 사용하여 `myeventsubscription`을 사용할 수 있습니다.  
Linux, macOS 또는 Unix 대상:  

```
aws rds modify-event-subscription \
    --subscription-name myeventsubscription \
    --enabled
```
Windows의 경우:  

```
aws rds modify-event-subscription ^
    --subscription-name myeventsubscription ^
    --enabled
```

## API
<a name="USER_Events.Modifying.API"></a>

Amazon RDS 이벤트를 수정하려면 Amazon RDS API 작업 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyEventSubscription.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyEventSubscription.html)을 호출합니다. 다음 필수 파라미터를 포함합니다.
+ `SubscriptionName`

# Amazon RDS 이벤트 알림 구독에 소스 식별자 추가
<a name="USER_Events.AddingSource"></a>

소스 식별자(이벤트를 발생시키는 Amazon RDS 소스)를 기존 구독에 추가할 수 있습니다.

## 콘솔
<a name="USER_Events.AddingSource.Console"></a>

소스 식별자는 Amazon RDS 콘솔에서 구독 관련 설정을 변경하면서 선택 또는 선택 해제를 통해 쉽게 추가하거나 제거할 수 있습니다. 자세한 내용은 [Amazon RDS 이벤트 알림 구독 수정](USER_Events.Modifying.md) 섹션을 참조하세요.

## AWS CLI
<a name="USER_Events.AddingSource.CLI"></a>

Amazon RDS 이벤트 알림 구독에 소스 식별자를 추가하려면 AWS CLI [https://docs.aws.amazon.com/](https://docs.aws.amazon.com/) 명령을 사용합니다. 다음 필수 파라미터를 포함합니다.
+ `--subscription-name`
+ `--source-identifier`

**Example**  
다음 예제에서는 `mysqldb` 구독에 소스 식별자 `myrdseventsubscription`를 추가합니다.  
대상 LinuxmacOS, 또는Unix:  

```
aws rds add-source-identifier-to-subscription \
    --subscription-name myrdseventsubscription \
    --source-identifier mysqldb
```
Windows의 경우:  

```
aws rds add-source-identifier-to-subscription ^
    --subscription-name myrdseventsubscription ^
    --source-identifier mysqldb
```

## API
<a name="USER_Events.AddingSource.API"></a>

Amazon RDS 이벤트 알림 구독에 소스 식별자를 추가하려면 Amazon RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AddSourceIdentifierToSubscription.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AddSourceIdentifierToSubscription.html)을 호출합니다. 다음 필수 파라미터를 포함합니다.
+ `SubscriptionName`
+ `SourceIdentifier`

# Amazon RDS 이벤트 알림 구독에서 소스 식별자 제거
<a name="USER_Events.RemovingSource"></a>

임의 소스의 이벤트 알림 메시지를 더 이상 받고 싶지 않을 때는 소스 식별자(이벤트를 발생시키는 Amazon RDS 소스)를 구독에서 제거할 수 있습니다.

## 콘솔
<a name="USER_Events.RemovingSource.Console"></a>

소스 식별자는 Amazon RDS 콘솔에서 구독 관련 설정을 변경하면서 선택 또는 선택 해제를 통해 쉽게 추가하거나 제거할 수 있습니다. 자세한 내용은 [Amazon RDS 이벤트 알림 구독 수정](USER_Events.Modifying.md) 섹션을 참조하세요.

## AWS CLI
<a name="USER_Events.RemovingSource.CLI"></a>

Amazon RDS 이벤트 알림 구독에서 소스 식별자를 제거하려면 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/remove-source-identifier-from-subscription.html](https://docs.aws.amazon.com/cli/latest/reference/rds/remove-source-identifier-from-subscription.html) 명령을 사용합니다. 다음 필수 파라미터를 포함합니다.
+ `--subscription-name`
+ `--source-identifier`

**Example**  
다음 예제에서는 `mysqldb` 구독에서 소스 식별자 `myrdseventsubscription`를 제거합니다.  
대상 LinuxmacOS, 또는Unix:  

```
aws rds remove-source-identifier-from-subscription \
    --subscription-name myrdseventsubscription \
    --source-identifier mysqldb
```
Windows의 경우:  

```
aws rds remove-source-identifier-from-subscription ^
    --subscription-name myrdseventsubscription ^
    --source-identifier mysqldb
```

## API
<a name="USER_Events.RemovingSource.API"></a>

Amazon RDS 이벤트 알림 구독에서 소스 식별자를 제거하려면 Amazon RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RemoveSourceIdentifierFromSubscription.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RemoveSourceIdentifierFromSubscription.html) 명령을 사용합니다. 다음 필수 파라미터를 포함합니다.
+ `SubscriptionName`
+ `SourceIdentifier`

# Amazon RDS 이벤트 알림 카테고리의 목록 표시
<a name="USER_Events.ListingCategories"></a>

리소스 유형의 이벤트는 모두 여러 카테고리로 그룹화됩니다. 이용 가능한 카테고리 목록을 보려면 다음 절차를 따릅니다.

## 콘솔
<a name="USER_Events.ListingCategories.Console"></a>

이벤트 알림 구독을 생성 또는 변경할 때는 이벤트 카테고리가 Amazon RDS 콘솔에 표시됩니다. 자세한 내용은 [Amazon RDS 이벤트 알림 구독 수정](USER_Events.Modifying.md) 섹션을 참조하세요.

![\[DB 이벤트 알림 카테고리의 목록 표시\]](http://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/AuroraUserGuide/images/EventNotification-Categories.png)




## AWS CLI
<a name="USER_Events.ListingCategories.CLI"></a>

Amazon RDS 이벤트 알림 범주를 표시하려면 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-event-categories.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-event-categories.html) 명령을 사용합니다. 이 명령에는 필수 파라미터가 없습니다.

**Example**  

```
aws rds describe-event-categories
```

## API
<a name="USER_Events.ListingCategories.API"></a>

Amazon RDS 이벤트 알림 범주를 표시하려면 Amazon RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeEventCategories.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeEventCategories.html) 명령을 사용합니다. 이 명령에는 필수 파라미터가 없습니다.

# Amazon RDS 이벤트 알림 구독 삭제
<a name="USER_Events.Deleting"></a>

필요 없는 구독은 삭제할 수 있습니다. 그러면 해당 주제의 모든 구독자에게는 구독 시 지정한 이벤트 알림 메시지가 발송되지 않습니다.

## 콘솔
<a name="USER_Events.Deleting.Console"></a>

**Amazon RDS 이벤트 알림 구독을 삭제하려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)에서 Amazon RDS 콘솔을 엽니다.

1.  탐색 창에서 [**DB Event Subscriptions**]를 선택합니다.

1.  [**My DB Event Subscriptions**] 창에서 삭제할 구독을 선택합니다.

1. **Delete**(삭제)를 선택합니다.

1. Amazon RDS 콘솔에 현재 구독 삭제 중으로 나옵니다.  
![\[이벤트 알림 구독 삭제\]](http://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/AuroraUserGuide/images/EventNotification-Delete.png)

   

## AWS CLI
<a name="USER_Events.Deleting.CLI"></a>

Amazon RDS 이벤트 알림 구독을 삭제하려면, AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/delete-event-subscription.html](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-event-subscription.html) 명령을 사용합니다. 다음 필수 파라미터를 포함합니다.
+ `--subscription-name`

**Example**  
다음은 `myrdssubscription` 구독을 삭제하는 예제입니다.  

```
aws rds delete-event-subscription --subscription-name myrdssubscription
```

## API
<a name="USER_Events.Deleting.API"></a>

Amazon RDS 이벤트 알림 구독을 삭제하려면, RDS API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteEventSubscription.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteEventSubscription.html) 명령을 사용합니다. 다음 필수 파라미터를 포함합니다.
+ `SubscriptionName`