# Amazon RDS イベント通知にサブスクライブする
<a name="USER_Events.Subscribing"></a>

サブスクリプションを作成する最も簡単な方法は、RDS コンソールを使用する方法です。CLI または API を使用してイベント通知サブスクリプションを作成する場合、Amazon Simple Notification Service トピックを作成し、Amazon SNS コンソールまたは Amazon SNS API を使用してそのトピックにサブスクライブする必要があります。トピックの Amazon Resource Name (ARN) は、CLI コマンドや API オペレーションを送信するときに使用されるため維持する必要があります。SNS トピックの作成とサブスクライブについては、*Amazon Simple Notification Service デベロッパーガイド*の「[Amazon SNS のスタート方法](https://docs.aws.amazon.com/sns/latest/dg/GettingStarted.html)」を参照してください。

通知を受け取る対象となるソースのタイプ、およびイベントをトリガーする Amazon RDS ソースを指定できます。

**ソースタイプ**  
ソースのタイプ。例えば、**[Source type]** (ソースタイプ) が **[Instances]** (インスタンス) の可能性があります。ソースタイプを選択する必要があります。

**インクルードする*リソース***  
イベントを生成している Amazon RDS リソース。例えば、**[Select specific instances]** (特定のインスタンスを選択) を選択して、**[myDBInstance1]** を選択します。

次の表は、**インクルードする*リソース***を指定した場合と、指定しなかった場合の結果について説明しています。


|  インクルードするリソース  |  説明  |  例  | 
| --- | --- | --- | 
|  指定  |  RDS は、指定したリソースのみに関するすべてのイベントを通知します。  | 選択した [Source type] (ソースタイプ) が [Instances] (インスタンス) で、リソースが [myDBInstance1] の場合は、RDS は MyDBInstance1 のみに関するすべてのイベントを通知します。 | 
|  指定されていません  |  RDS は、すべての Amazon RDS リソースについて、指定したソースタイプのイベントを通知します。  |  **[Source type]** (ソースタイプ) が **[Instances]** (インスタンス) の場合は、RDS はそのアカウントのすべてのインスタンス関連イベントを通知します。  | 

デフォルトでは、Amazon SNS トピックのサブスクライバーは、トピックに対して発行されたすべてのメッセージを受信します。メッセージのサブセットのみを受信するには、サブスクライバーはトピックのサブスクリプションにフィルターポリシーを割り当てる必要があります。詳細については、「*Amazon SNS 開発者ガイド*」の「[Amazon SNS メッセージのフィルター処理](https://docs.aws.amazon.com/sns/latest/dg/sns-message-filtering.html)」を参照してください。

## コンソール
<a name="USER_Events.Subscribing.Console"></a>

**RDS イベント通知にサブスクライブするには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. ナビゲーションペインで、[**イベントサブスクリプション**] を選択します。

1. [**イベントサブスクリプション**] ページで、[**イベントサブスクリプションの作成**] を選択します。

1. サブスクリプションの詳細を次のように入力します。

   1. **[Name]** (名前) に、イベント通知サブスクリプションの名前を入力します。

   1. **[Send notifications to]** (通知の送信先) については、次のいずれかを実行します。
      + **[New email topic]** (新しい E メールトピック) を選択します。E メールトピックの名前と受信者のリストを入力します。イベントのサブスクリプションは、プライマリアカウントの連絡先と同じメールアドレスに設定することをお勧めします。推奨事項、サービスイベント、および個人の健康メッセージは、さまざまなチャネルを使用して送信されます。同じメールアドレスでサブスクリプションすると、すべてのメッセージが 1 か所にまとめられます。
      + **[Amazon Resource Name (ARN)]** (Amazon リソースネーム (ARN)) を選択します。次に、Amazon SNS トピックで既存の Amazon SNS ARN を選択します。

        サーバー側の暗号化 (SSE) で有効になっているトピックを使用する場合は、Amazon RDS に、AWS KMS key にアクセスするのに必要な許可を付与します。詳細については、*Amazon Simple Notification Service デベロッパーガイド*の「[AWS サービスと暗号化されたトピックのイベントソース間の互換性を保つ](https://docs.aws.amazon.com/sns/latest/dg/sns-key-management.html#compatibility-with-aws-services)」を参照してください。

   1. [**ソースタイプ**] で、ソースタイプを選択します。例えば、**[Instances]** (インスタンス) または **[Parameter groups]** (パラメータグループ)  を選択します。

   1. イベントの通知を受け取るイベントのカテゴリとリソースを選択します。

      次の例では、`testinst` という名前の DB インスタンスについて、イベント通知を設定します。  
![\[ソースタイプを入力する\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/event-source.png)

   1. [**作成**] を選択します。

Amazon RDS コンソールでは、サブスクリプションが作成されることが示されます。

![\[DB イベント通知サブスクリプションのリスト\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/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**  
Linux、macOS、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`