翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon DocumentDB イベントサブスクリプションを使用する
Amazon DocumentDB では、Amazon DocumentDB のイベントが発生したときに、Amazon Simple Notification Service (Amazon SNS) を使用して通知を送信します。これらの通知は、E メール AWS リージョン、テキストメッセージ、HTTP エンドポイントへの呼び出しなど、 の Amazon SNS でサポートされている任意の形式にすることができます。
Amazon DocumentDB は、サブスクライブ可能なカテゴリにイベントをグループ分けします。これにより、そのカテゴリのイベントが発生すると、通知を受け取ることができます。インスタンス、クラスター、スナップショット、クラスタースナップショット、または パラメータグループのイベントカテゴリをサブスクライブできます。例えば、特定のインスタンスのバックアップカテゴリをサブスクライブした場合、インスタンスに影響するバックアップ関連のイベントが発生するたびに通知が送信されます。また、イベントサブスクリプションが変更されても、通知を受け取ります。
イベントは、クラスターレベルとインスタンスレベルの両方で発生するため、クラスターまたはインスタンスをサブスクライブするとイベントを受信できます。
イベントサブスクリプションは、サブスクリプションを作成するときに指定したアドレスに送信されます。いくつかの異なるサブスクリプションを作成することもできます。例えば、すべてのイベント通知を受信するサブスクリプションと、本番稼働用のインスタンスに関する重要なイベントのみを含むサブスクリプションを作成できます。サブスクリプションを削除せずに通知を簡単にオフにできます。これを行うには、Amazon DocumentDB コンソールで **[Enabled (有効)]** ラジオボタンを [**No (なし)]**に設定します。
**重要**
Amazon DocumentDB はイベントストリームのイベントの順番を保証しません。イベントの順番は変わる場合があります。
Amazon DocumentDB では、Amazon SNS トピックの Amazon リソースネーム (ARN) を使用して、各サブスクリプションを識別します。Amazon DocumentDB コンソールでは、サブスクリプションの作成時に ARN が作成されます。
Amazon DocumentDB イベントサブスクリプションの請求は、Amazon SNS を通じて行われます。使用したイベント通知に対して、Amazon SNS 料金が適用されます。詳細については、「Amazon Simple Notification Service の料金」を参照してください。Amazon SNS の料金以外では、Amazon DocumentDB はイベントサブスクリプションの請求は行いません。
**Topics**
+ [イベントのサブスクライブ](event-subscriptions.subscribe.md)
+ [サブスクリプションを管理する](event-subscriptions.managing.md)
+ [カテゴリとメッセージ](event-subscriptions.categories-messages.md)
# Amazon DocumentDB イベントにサブスクライブする
Amazon DocumentDB コンソールを使用して、次のようにイベントサブスクリプションをサブスクライブできます。
1. AWS マネジメントコンソール で にサインインします[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)。
1. ナビゲーションペインで、**[Event subscriptions]** (イベントサブスクリプション) を選択します。
![\[[イベントサブスクリプション] オプションが強調表示された [Amazon DocumentDB コンソールナビゲーション] ペイン。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/event-subs/subscribe-event-subs.png)
1. [**イベントサブスクリプション**] ページで、[**イベントサブスクリプションの作成**] を選択します。
![\[右上隅にある [イベントサブスクリプションの作成] ボタンが強調表示されたイベントサブスクリプションペイン。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/event-subs/subscribe-create.png)
1. [**イベントサブスクリプションの作成**] ダイアログボックスで、次の操作を行います。
+ [**名前**] に、イベント通知サブスクリプションの名前を入力します。
![\[[詳細] セクションと [名前] 入力フィールドを示す [イベントサブスクリプションの作成] フォーム。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/event-subs/subscribe-name.png)
+ [**ターゲット**]で、通知を送信する場所を選択します。既存の **ARN** を選択できます。または [**新しい電子メールトピック**] を選択して、トピックの名前と受取人のリストを入力します。
![\[通知の送信先を指定するオプションがある [ターゲット] セクション。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/event-subs/subscribe-target.png)
+ [**ソース**] で、ソースタイプを選択します。選択したソースタイプに応じて、イベント通知を受け取る対象のイベントカテゴリとソースを選択します。
![\[イベント通知を受信するソースタイプを選択する [ソース] セクション。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/event-subs/subscribe-source.png)
+ **[作成]** を選択します。
![\[右下隅に [作成] ボタンがある [ソース] セクション。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/event-subs/subscribe-create-2.png)
# Amazon DocumentDB イベント通知サブスクリプションを管理する
Amazon DocumentDB コンソールのナビゲーションペインで [**イベントサブスクリプション**] を選択すると、サブスクリプションカテゴリと現在のサブスクリプションのリストを表示できます。特定のサブスクリプションを変更または削除することもできます。
## 現在の Amazon DocumentDB イベント通知サブスクリプションを変更するには
1. AWS マネジメントコンソール で にサインインします[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)。
1. ナビゲーションペインで、[**イベントサブスクリプション**] を選択します。[**イベントサブスクリプション**] ペインにイベント通知サブスクリプションが一覧表示されます。
![\[[イベントサブスクリプション] オプションが強調表示された [Amazon DocumentDB コンソールナビゲーション] ペイン。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/event-subs/modify-event-subs.png)
1. [**イベントサブスクリプション**] ペインで、変更するサブスクリプションを選択し、[**編集**] をクリックします。
![\[選択したサブスクリプションと [編集] ボタンを示す [イベントサブスクリプション] ペイン。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/event-subs/modify-edit.png)
1. [**ターゲット**] セクションまたは [**ソース**] セクションのいずれかでサブスクリプションを変更します。[ソース] セクションで選択または選択解除することで、ソース識別子を追加または削除できます。
![\[[ターゲット] セクションを強調表示する [イベントサブスクリプションの変更] フォーム。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/event-subs/modify-target.png)
1. **[Modify]** (変更) を選択します。Amazon DocumentDB コンソールでは、サブスクリプションが変更されることが示されます。
![\[[変更] ボタンが強調表示された [イベントサブスクリプションの変更] フォームの最後。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/event-subs/modify-button.png)
## Amazon DocumentDB イベント通知サブスクリプションの削除
不要になったサブスクリプションは削除できます。トピックへのすべてのサブスクライバは、サブスクリプションにより指定されたイベント通知を受け取らなくなります。
1. AWS マネジメントコンソール で にサインインします[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)。
1. ナビゲーションペインで、**[Event subscriptions]** (イベントサブスクリプション) を選択します。
![\[[イベントサブスクリプション] オプションが強調表示された [Amazon DocumentDB コンソールナビゲーション] ペイン。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/event-subs/delete-event-subs.png)
1. [**イベントサブスクリプション**] ペインで、削除するサブスクリプションを選択します。
![\[選択したサブスクリプションを示す [イベントサブスクリプション] ペイン。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/event-subs/delete-select.png)
1. **[削除]** を選択します。
![\[[削除] ボタンが強調表示された [イベントサブスクリプション] ペイン。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/event-subs/delete-delete.png)
1. この通知を完全に削除するかどうかを尋ねるポップアップウィンドウが表示されます。**[削除]** を選択します。
![\[右下隅の [削除] ボタンが強調表示されたイベントサブスクリプションの削除を確認するダイアログボックス。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/event-subs/delete-delete-2.png)
# Amazon DocumentDB イベントのカテゴリとイベントメッセージ
Amazon DocumentDB では、 コンソールを使用してサブスクライブできるカテゴリ内で多数のイベントが生成されます。各カテゴリはインスタンス、クラスター、スナップショットまたはパラメータグループである 1 つのソースタイプに適用されます。
**注記**
Amazon DocumentDB では既存の Amazon RDS イベント定義と ID が使用されます。
## インスタンスから発生する Amazon DocumentDB イベント
| Category | 説明 |
| --- | --- |
| 可用性 | インスタンスが再起動しました。 |
| 可用性 | インスタンスがシャットダウンしました。 |
| 設定変更 | 変更をインスタンスクラスに適用します。 |
| 設定変更 | 変更をインスタンスクラスに適用しました。 |
| 設定変更 | プライマリ認証情報をリセットします。 |
| 作成 | インスタンスが作成されました。 |
| 削除 | インスタンスが削除されました |
| 失敗 | インスタンスは、互換性のない設定または基本的なストレージの問題により失敗しました。インスタンスのポイントインタイムの復元を開始します。 |
| 通知 | インスタンスが停止しました。 |
| 通知 | インスタンスが起動しました。 |
| 通知 | 停止中の最大許容時間を超えたため、インスタンスが起動されています。 |
| 復旧 | インスタンスの復旧が開始しました。復旧時間は、復旧するデータの量に応じて変わります。 |
| 復旧 | インスタンスの復旧が完了しました。 |
| セキュリティパッチ | ご使用のインスタンスに対するオペレーティングシステムアップデートがあります。アップデートの適用方法については、「[Amazon DocumentDB のメンテナンス](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html)」を参照してください。 |
## クラスターから発生する Amazon DocumentDB イベント
| Category | 説明 |
| --- | --- |
| 作成 | クラスターが作成されました |
| 削除 | クラスターが削除されました。 |
| フェイルオーバー | 以前のプライマリを再度プロモートします。 |
| フェイルオーバー | インスタンスへのフェイルオーバーが完了しました。 |
| フェイルオーバー | DB インスタンスへのフェイルオーバーを開始しました: %s |
| フェイルオーバー | DB インスタンスへの同じ AZ フェイルオーバーを開始しました: %s |
| フェイルオーバー | DB インスタンスへのクロスAZ フェイルオーバーを開始しました: %s |
| メンテナンス | クラスターにパッチが適用されました。 |
| メンテナンス | データベースクラスターはアップグレードできない状態です: %s |
| 通知 | クラスターが停止しました。 |
| 通知 | クラスターが開始しました。 |
| 通知 | クラスターの停止が失敗しました。 |
| 通知 | 停止中の最大許容時間を超えたため、クラスターが開始されています。 |
| 通知 | クラスターの名前を %s から %s に変更しました。 |
## クラスタースナップショットから発生する Amazon DocumentDB イベント
次の表は、Amazon DocumentDB クラスターのスナップショットがソースタイプである場合のイベントカテゴリとイベントのリストを示しています。
| Category | 説明 |
| --- | --- |
| バックアップ | 手動クラスタースナップショットの作成 |
| バックアップ | 手動クラスタースナップショットが作成されました。 |
| バックアップ | 自動クラスタースナップショットを作成しています。 |
| バックアップ | 自動クラスタースナップショットが作成されました。 |
## パラメータグループから発生する Amazon DocumentDB イベント
次の表は、パラメータグループがソースタイプである場合のイベントカテゴリとイベントのリストを示します。
| Category | 説明 |
| --- | --- |
| 設定変更 | 適用メソッド %s でパラメータ %s を %s に更新しました |