

# Amazon RDS イベント通知の操作
<a name="USER_Events"></a>

Amazon RDS では、Amazon RDS のイベントが発生したときに、Amazon Simple Notification Service (Amazon SNS) を使用して通知を送信します。これらの通知については、AWS リージョンの Amazon SNS でサポートされているすべての通知の形式が使用可能です (E メール、テキストメッセージ、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 DB イベント通知サブスクリプションのリスト化](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 EventBridgei を使用した Amazon RDS イベントの例](#events-examples)

## イベントサブスクリプションの対象となる RDS リソース
<a name="USER_Events.overview.resources"></a>

次のリソースのイベントカテゴリにサブスクライブできます。
+ DB インスタンス
+ DB スナップショット
+ DB パラメータグループ
+ DB セキュリティグループ
+ RDS Proxy 
+ カスタムエンジンバージョン

例えば、特定の DB インスタンスのバックアップカテゴリにサブスクライブした場合、DB インスタンスに影響するバックアップ関連のイベントが発生するたびに通知が送信されます。DB インスタンスの設定変更カテゴリにサブスクライブした場合は、DB インスタンスが変更されると、通知を受け取ります。また、イベント通知サブスクリプションが変更されても、通知を受け取ります。

複数の異なるサブスクリプションを作成することもできます。例えば、すべての DB インスタンスの全イベント通知を受信するサブスクリプションや、DB インスタンスのサブセットに関する重要なイベントのみを含むサブスクリプションを作成することもできます。2 番目のサブスクリプションでは、フィルターで 1 つ以上の 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 から承認の E メールまたは SMS メッセージが送信されます。

1. サブスクリプションを確認するには、受信した通知に記載されているリンクを選択します。

1. Amazon RDS コンソールでは、サブスクリプションのステータスで [**My Event Subscriptions**] (イベントのサブスクリプション) が更新されます。

1. Amazon RDS は、サブスクリプションを作成したときに指定したアドレスへの通知の送信を開始します。

Amazon SNS を使用する際の Identity and Access Management に関する詳細については、*Amazon Simple Notification Service デベロッパーガイド*の「[Identity and access management in Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-authentication-and-access-control.html)」を参照してください。

DB インスタンスからのイベント通知の処理には、AWS Lambda を使用することができます。詳細については、*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 イベントカテゴリとイベントメッセージ](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 デベロッパーガイド*の「[Mobile text messaging (SMS)](https://docs.aws.amazon.com/sns/latest/dg/sns-mobile-phone-number-as-subscriber.html)」を参照してください。

サブスクリプションを削除せずに通知を無効にするには、Amazon RDS コンソールで **[Enabled]** (有効) として **[No]** (いいえ) を選択します。または、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 EventBridgei を使用した Amazon RDS イベントの例
<a name="events-examples"></a>

次の例は、JSON 形式のさまざまなタイプの Amazon RDS イベントを示しています。JSON 形式でイベントをキャプチャして表示する方法を示すチュートリアルについては、「[チュートリアル: Amazon EventBridge を使用して DB インスタンスの状態変化をログに記録する](rds-cloud-watch-events.md#log-rds-instance-state)」を参照してください。

**Topics**
+ [DB インスタンスイベントの例](#rds-cloudwatch-events.db-instances)
+ [DB パラメータグループイベントの例](#rds-cloudwatch-events.db-parameter-groups)
+ [DB スナップショットイベントの例](#rds-cloudwatch-events.db-snapshots)

### DB インスタンスイベントの例
<a name="rds-cloudwatch-events.db-instances"></a>

以下は、JSON 形式の DB インスタンスイベントの例です。このイベントは、RDS が `my-db-instance` という名前のインスタンスのためにマルチ AZ フェイルオーバーを実行したことを示しています。イベント ID は RDS-EVENT-0049 です。

```
{
  "version": "0",
  "id": "68f6e973-1a0c-d37b-f2f2-94a7f62ffd4e",
  "detail-type": "RDS DB Instance Event",
  "source": "aws.rds",
  "account": "123456789012",
  "time": "2018-09-27T22:36:43Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:rds:us-east-1:123456789012:db:my-db-instance"
  ],
  "detail": {
    "EventCategories": [
      "failover"
    ],
    "SourceType": "DB_INSTANCE",
    "SourceArn": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
    "Date": "2018-09-27T22:36:43.292Z",
    "Message": "A Multi-AZ failover has completed.",
    "SourceIdentifier": "my-db-instance",
    "EventID": "RDS-EVENT-0049"
  }
}
```

### 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-snapshots"></a>

以下は、JSON 形式の DB スナップショットイベントの例です。イベントは、`my-db-snapshot` という名前のスナップショットの削除を示します。イベント ID は RDS-EVENT-0041 です。

```
{
  "version": "0",
  "id": "844e2571-85d4-695f-b930-0153b71dcb42",
  "detail-type": "RDS DB 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:snapshot:rds:my-db-snapshot"
  ],
  "detail": {
    "EventCategories": [
      "deletion"
    ],
    "SourceType": "SNAPSHOT",
    "SourceArn": "arn:aws:rds:us-east-1:123456789012:snapshot:rds:my-db-snapshot",
    "Date": "2018-10-06T12:26:13.882Z",
    "Message": "Deleted manual snapshot",
    "SourceIdentifier": "my-db-snapshot",
    "EventID": "RDS-EVENT-0041"
  }
}
```

# Amazon SNS トピックに通知を発行するアクセス許可を付与する
<a name="USER_Events.GrantingPermissions"></a>

Amazon Simple Notification Service (Amazon SNS) トピックに通知を発行するための Amazon RDS アクセス許可を付与するには、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 を使用してそのトピックにサブスクライブする必要があります。トピックの 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`

# Amazon RDS イベント通知タグと属性
<a name="USER_Events.TagsAttributesForFiltering"></a>

Amazon RDS が Amazon Simple Notification Service (SNS) または Amazon EventBridge にイベント通知を送信するとき、通知にはメッセージ属性とイベントタグが含まれます。RDS はメッセージと共にメッセージ属性を個別に送信しますが、イベントタグはメッセージの本文に含まれています。メッセージ属性と Amazon RDS タグを使用して、リソースにメタデータを追加します。これらのタグは、DB インスタンスに関する独自の表記で変更できます。Amazon RDS リソースのタグ付けの詳細については、「[ 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 タグは、サービスイベントの影響を受けたリソースに関するデータを提供します。通知が SNS または EventBridge に送信されると、RDS はメッセージ本文にタグの現在の状態を追加します。

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 DB イベント通知サブスクリプションのリスト化
<a name="USER_Events.ListSubscription"></a>

現在の Amazon RDS イベント通知サブスクリプションのリストを表示できます。

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

**現在の Amazon RDS イベント通知サブスクリプションのリストを表示するには**

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

1.  ナビゲーションペインで、[**イベントサブスクリプション**] を選択します。[**イベントサブスクリプション**] ペインにイベント通知サブスクリプションが一覧表示されます。  
![\[DB イベント通知サブスクリプションのリスト\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/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 マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

1.  [**イベントサブスクリプション**] ペインで、変更するサブスクリプションを選択し、[**編集**] をクリックします。

1.  [**ターゲット**] セクションまたは [**ソース**] セクションのいずれかでサブスクリプションを変更します。

1. [**編集**] を選択します。Amazon RDS コンソールでは、サブスクリプションが変更されることが示されます。  
![\[DB イベント通知サブスクリプションのリスト\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/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` サブスクリプションに追加します。  
Linux、macOS、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` サブスクリプションから削除します。  
Linux、macOS、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/ja_jp/AmazonRDS/latest/UserGuide/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 マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

1.  [**My DB Event Subscriptions**] (自分の DB イベントサブスクリプション) ペインで、削除するサブスクリプションを選択します。

1. [**削除**] を選択します。

1. サブスクリプションを削除中であることが Amazon RDS コンソールに表示されます。  
![\[イベント通知サブスクリプションを削除する\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/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`