翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AWS Database Migration Service での Amazon SNS イベントと通知の使用
AWS DMS 3.4.5 リリース以降のバージョンでは、AWS DMS イベントが発生した際の通知には、Amazon EventBridge を使用することをお勧めします。AWS DMS での EventBridge イベントの使用の詳細については、「AWS Database Migration Service での Amazon EventBridge イベントと通知の使用」を参照してください。
イベントサブスクリプションの Amazon EventBridge への移動
次の AWS CLI コマンドを使用して、アクティブなイベントサブスクリプションを DMS から Amazon EventBridge に一度に最大 10 件移行できます。
update-subscriptions-to-event-bridge [--force-move | --no-force-move]
デフォルトでは、レプリケーションインスタンスが AWS DMS 3.4.5 以降を使用している場合にのみ、AWS DMS はアクティブなイベントサブスクリプションを移行します。このデフォルトの動作を上書きするには、--force-move
オプションを使用します。ただし、レプリケーションインスタンスがアップグレードされていない場合、イベントのタイプによっては Amazon EventBridge を使用しては利用できない場合があります。
update-subscriptions-to-event-bridge
CLI コマンドを実行する AWS Identity and Access Management (IAM) ユーザには、次のポリシーのアクセス許可が必要です。
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "SNS:GetTopicAttributes", "SNS:SetTopicAttributes", "events:PutTargets", "events:EnableRule", "events:PutRule" ], "Resource": "*" } ] }
EventBridge へのサブスクリプションの移動の詳細については、「AWS Database Migration Service API リファレンス」の「UpdateSubscriptionsToEventBridge」を参照してください。
Amazon SNS イベントと通知の使用
AWS DMS 3.4.5 以前のバージョンでサポートされているイベントと通知は、次のとおりです。
AWS Database Migration Service (AWS DMS) は、Amazon Simple Notification Service (Amazon SNS) を使用して、レプリケーションインスタンスの作成や削除などの AWS DMS イベントが発生した際に通知を送信できます。これらの通知は、メールメッセージ、テキストメッセージ、HTTP エンドポイントの呼び出しなど、AWS リージョン用にAmazon SNSでサポートされているいずれの形式でも使用できます。
AWS DMSは、定期契約可能なカテゴリにイベントをグループ化するため、そのカテゴリのイベントが発生すると通知が来ます。たとえば、特定のレプリケーション インスタンスの作成カテゴリにサブスクライブした場合は、レプリケーション インスタンスに影響を与える作成関連のイベントが発生するたびに通知を受け取ります。レプリケーション インスタンスの設定変更カテゴリにサブスクライブした場合は、レプリケーション インスタンスの設定が変更されると、通知を受け取ります。また、イベント通知サブスクリプションが変更されても、通知を受け取ります。AWS DMSから提供されるイベントカテゴリのリストについては、以下の「SNS 通知の AWS DMS イベントカテゴリとイベントメッセージ」をご参照ください。
AWS DMSはイベントサブスクリプションを作成するときに指定したアドレスにイベント通知を送信します。いくつかの異なるサブスクリプションを作成することもできます。たとえば、すべてのイベント通知を受け取るサブスクリプションと、本稼働環境の DMS リソースに関する重要なイベントのみを含むサブスクリプションを作成できます。AWS DMS コンソールで [Enabled] (有効) オプションを選択解除するか、AWS DMS API を使用して Enabled
パラメータを[false] (偽) に設定することで、サブスクリプションを削除せずに通知を簡単に無効にすることができます。
注記
SMS テキストメッセージを使用した AWS DMSイベント通知は現在、Amazon SNS がサポートされている全 AWS リージョンにおいては AWS DMS リソースで使用できます。Amazon SNS が SMS メッセージングをサポートする AWS リージョンと国のリストについては、「対応リージョンと国」をご参照ください。
SNS によるテキストメッセージ使用の詳細については、「Amazon SNS を使用した SMS 通知の送信と受信」をご参照ください。
AWS DMS イベント通知は CloudWatch または EventBridge の CloudTrail イベントとは異なります。CloudTrail イベント通知は任意の API 呼び出しによって生成できます。DMS は、DMS イベントが発生したときにのみ通知を送信します。
AWS DMSでは、サブスクリプション識別子を使用して各サブスクリプションを識別します。複数の AWS DMSイベントサブスクリプションを同じ Amazon SNS トピックに公開できます。イベント通知を使用すると Amazon SNS の料金が適用されます。Amazon SNS の請求詳細については 「 Amazon SNS 料金表
Amazon SNS を使用して AWS DMS イベントをサブスクライブするには、次のプロセスを使用します。
-
Amazon SNS トピックを作成します。トピックでは、受け取る通知のタイプと、通知先のアドレスまたは番号を指定します。
-
AWS Management Console、AWS CLI、または AWS DMS API を使用して、AWS DMS イベント通知サブスクリプションを作成します。
-
サブスクリプションに指定したアドレスに AWS DMS から承認のメールまたは SMS メッセージが来ます。サブスクリプションを確認するには、承認の E メールまたは SMS メッセージのリンクをクリックします。
-
サブスクリプションを確認すると、AWS DMSコンソールの [Event subscriptions] (イベントサブスクリプション) セクションで、サブスクリプションのステータスが更新されます。
-
その後、イベント通知を受け取り始めます。
通知できるカテゴリとイベントのリストについては、次のセクションをご参照ください。AWS DMSイベント サブスクリプションおよび使用方法の詳細については、「SNS を使用した AWS DMS イベント通知のサブスクリプション」をご参照ください。
トピック
SNS 通知の AWS DMS イベントカテゴリとイベントメッセージ
重要
AWS DMS 3.4.5 リリース以降のバージョンでは、AWS DMS イベントが発生した際の通知には、Amazon EventBridge を使用することをお勧めします。AWS DMS での EventBridge イベントの使用の詳細については、「AWS Database Migration Service での Amazon EventBridge イベントと通知の使用」を参照してください。
AWS DMSでは、AWS DMS コンソールまたは AWS DMS API を使用するための定期契約が可能なカテゴリに多数のイベントが生成されます。各カテゴリはソースタイプに適用されます。AWS DMSでは現在、レプリケーション インスタンスとレプリケーションタスクのソースタイプに対応しています。
以下の表では、レプリケーション インスタンスソースタイプの可能なカテゴリとイベントを示しています。
カテゴリ |
DMS イベント ID |
説明 |
---|---|---|
設定変更 | DMS-EVENT-0012 |
このレプリケーション インスタンス用レプリケーション インスタンスクラスを変更中です。 |
設定変更 | DMS-EVENT-0014 |
このレプリケーション インスタンスのレプリケーション インスタンスクラスが変更されました。 |
設定変更 | DMS-EVENT-0018 |
レプリケーション インスタンスのストレージを増加中です。 |
設定変更 | DMS-EVENT-0017 |
レプリケーション インスタンスのストレージが増加しました。 |
設定変更 | DMS-EVENT-0024 |
レプリケーション インスタンスはマルチ AZ 設定に移行中です。 |
設定変更 | DMS-EVENT-0025 |
レプリケーション インスタンスがマルチ AZ 設定に移行されました。 |
設定変更 | DMS-EVENT-0030 |
レプリケーション インスタンスがシングル AZ 設定に移行中です。 |
設定変更 | DMS-EVENT-0029 |
レプリケーション インスタンスがシングル AZ 設定に移行されました。 |
作成 | DMS-EVENT-0067 |
レプリケーションのインスタンスが作成中です。 |
作成 | DMS-EVENT-0005 |
レプリケーションのインスタンスが作成されます。 |
削除 | DMS-EVENT-0066 |
レプリケーション インスタンスを削除しています。 |
削除 | DMS-EVENT-0003 |
レプリケーション インスタンスが削除されます。 |
メンテナンス | DMS-EVENT-0047 | レプリケーション インスタンスの管理ソフトウェアが更新されました。 |
メンテナンス | DMS-EVENT-0026 | レプリケーション インスタンスのオフラインメンテナンスが実行中です。レプリケーション インスタンスは現在使用できません。 |
メンテナンス | DMS-EVENT-0027 | レプリケーション インスタンスのオフラインメンテナンスが完了しました。レプリケーション インスタンスは現在使用できます。 |
メンテナンス | DMS-EVENT-0068 | レプリケーション インスタンスはアップグレードできない状態です。 |
LowStorage | DMS-EVENT-0007 | レプリケーションインスタンスは、割り当てられたストレージの 90% 以上を使用している。空きストレージ領域メトリクスを使用して、レプリケーションインスタンスのストレージ容量をモニタリングできる。 |
フェイルオーバー | DMS-EVENT-0013 | マルチ AZ レプリケーション インスタンスのフェイルオーバーが開始されました。 |
フェイルオーバー | DMS-EVENT-0049 | マルチ AZ レプリケーション インスタンスのフェイルオーバーが完了しました。 |
フェイルオーバー | DMS-EVENT-0015 | スタンドバイへのマルチ AZ フェイルオーバーが完了しました。 |
フェイルオーバー | DMS-EVENT-0050 | マルチ AZ アクティベーションが開始されました。 |
フェイルオーバー | DMS-EVENT-0051 | マルチ AZ アクティベーションが完了しました。 |
フェイルオーバー | DMS-EVENT-0034 | 必要以上に頻繁にフェイルオーバーをリクエストした場合、通常のフェイルオーバーイベントの代わりにこのイベントが発生します。 |
失敗 | DMS-EVENT-0031 | レプリケーション インスタンスがストレージ障害状態になりました。 |
失敗 | DMS-EVENT-0036 | 互換性のないネットワークのためレプリケーション インスタンスで障害が発生しました。 |
失敗 | DMS-EVENT-0037 | このサービスはデータボリュームの暗号化に使用される AWS KMS キーにアクセスできません。 |
以下の表では、レプリケーションタスクソースタイプの可能なカテゴリとイベントを示しています。
カテゴリ |
DMS イベント ID |
説明 |
---|---|---|
状態変更 | DMS-EVENT-0069 |
レプリケーションタスクが開始されました。 |
状態変更 | DMS-EVENT-0081 |
テーブルの詳細のリロードがリクエストされました。 |
状態変更 | DMS-EVENT-0079 |
レプリケーションタスクが停止されました。 |
状態変更 | DMS-EVENT-0091 | 読み込みが一時停止しました。スワップファイル限界に達しました。 |
状態変更 | DMS-EVENT-0092 | 読み取りが一時停止しました。ディスク使用量の限界に達しました。 |
状態変更 | DMS-EVENT-0093 | 読み取りを再開しました。 |
失敗 | DMS-EVENT-0078 |
レプリケーションタスクが失敗しました。 |
失敗 | DMS-EVENT-0082 |
タスクを削除する呼び出しで、タスクデータのクリーンアップに失敗しました。 |
設定変更 | DMS-EVENT-0080 | レプリケーションタスクが変更されました。 |
削除 | DMS-EVENT-0073 |
レプリケーションタスクが削除されます。 |
作成 | DMS-EVENT-0074 | レプリケーションタスクが作成されます。 |
次の例は、状態変更カテゴリの AWS DMS イベントサブスクリプションを表します。
Resources: DMSEvent: Type: AWS::DMS::EventSubscription Properties: Enabled: true EventCategories: State Change SnsTopicArn: arn:aws:sns:us-east-1:123456789:testSNS SourceIds: [] SourceType: replication-task
SNS を使用した AWS DMS イベント通知のサブスクリプション
重要
AWS DMS 3.4.5 リリース以降のバージョンでは、AWS DMS イベントが発生した際の通知には、Amazon EventBridge を使用することをお勧めします。AWS DMS での EventBridge イベントの使用の詳細については、「AWS Database Migration Service での Amazon EventBridge イベントと通知の使用」を参照してください。
AWS DMS イベント通知サブスクリプションを作成して、AWS DMS イベントが発生したときに通知を受け取るようにできます。サブスクリプションを作成する最も簡単な方法は、AWS DMS コンソールを使用する方法です。通知サブスクリプションでは、通知の送信方法と場所を選択します。通知を受け取りたいソースのタイプを指定します。 現在 AWS DMS では、レプリケーション インスタンスとレプリケーション タスクのソースタイプがサポートされています。さらに選択したソースタイプに応じて、イベント通知を受け取る対象のイベントカテゴリを選択しソースを識別します。
AWS Management Console の使用
重要
AWS DMS 3.4.5 リリース以降のバージョンでは、AWS DMS イベントが発生した際の通知には、Amazon EventBridge を使用することをお勧めします。AWS DMS での EventBridge イベントの使用の詳細については、「AWS Database Migration Service での Amazon EventBridge イベントと通知の使用」を参照してください。
コンソールを使用して Amazon SNS で AWS DMS イベント通知をサブスクライブするには
-
AWS Management Console にサインインし、AWS DMS コンソール (https://console.aws.amazon.com/dms/v2/
) を開きます。 IAM ユーザーとしてサインインしている場合は、AWS DMS にアクセスするための適切なアクセス許可があることを確認します。
-
ナビゲーションペインで、[Event subscriptions] (イベントサブスクリプション) を選択します。
-
[Event subscriptions] (イベントサブスクリプション) ページで[Create event subscription] (イベントサブスクリプション作成) を選択します。
-
[Create event subscription] (イベントサブスクリプション作成) ページで、以下の操作を行います。
-
[Details] (詳細) にある[Name] (名前) にイベント通知サブスクリプションの名前を入力します。
-
サブスクリプションを有効にするには、[Enabled] (有効) を選択します。サブスクリプションを作成しても、通知はまだ送信しない場合は、[Enabled] (有効) を選択しません。
-
[Target] (ターゲット) で、[Existing topics] (既存のトピック)、[Create new email topic] (新しい電子メールトピックの作成) または[Create new SMS topic] (新しい SMS トピックの作成) のいずれかを選択して、通知を送信します。通知の送信先として、既存のAmazon SNSトピックを使用するか、トピックを作成する必要があります。トピックを作成すると、通知の送信先のメールアドレスを入力できます。
-
[Event source] (イベントソース) の[Source type] (ソースタイプ) でソースタイプを選択します。唯一の選択肢は[replication-instance] (レプリケーション インスタンス) そして[replication-task] (レプリケーション タスク) です。
-
選択したソースタイプに応じて、イベント通知を受け取る対象となるイベントカテゴリとソースを選択します。
-
[Create event subscription] (イベントサブスクリプション作成)を選択します。
-
AWS DMSコンソールでは、サブスクリプションが作成されることが示されます。
注記
AWS DMS API と CLI を使用して、Amazon SNS イベント通知サブスクリプションを作成することもできます。詳細については、「AWS DMS API リファレンス」の「CreateEventSubscription」と「AWS DMS CLI リファレンス」ドキュメントの「create-event-subscription」を参照してください。
SNS トピックのアクセスポリシーの検証
SNS アクセスポリシーには、AWS DMS が SNS トピックにイベントを公開できるアクセス許可が必要です。次の手順の説明のとおり、アクセスポリシーを検証し、更新できます。
アクセスポリシーを検証するには
-
[Amazon SNS コンソール] を開きます。
-
ナビゲーションペインで [トピック] をクリックして、DMS 通知を受け取るトピックを選択します。
-
[アクセスポリシー] タブをクリックします。
SNS アクセスポリシーで AWS DMS が SNS トピックにイベントをパブリッシュすることを許可していない場合は、ポリシーを更新できます。
アクセスポリシーを更新するには
-
トピックページの [詳細] セクションで、[編集] を選択します。
-
[アクセスポリシー] セクションを展開して、次のポリシーを JSON エディタにアタッチします。
{ "Sid": "dms-allow-publish", "Effect": "Allow", "Principal": { "Service": "dms.amazonaws.com" }, "Action": "sns:Publish", "Resource": "
your-SNS-topic-ARN
" }イベントをトピックにパブリッシュする DMS EventSubscription ARN である
aws:SourceArn
条件を指定して、SNS トピックへのアクセスをさらに制限することをお勧めします。... "Resource": "
your-SNS-topic-ARN
" "Condition": { "StringEquals": { "aws:SourceArn": "arn:partition
:dms:your-AWS-region
:your-AWS-account-ID
:es:your-dms-es-arn or *
" } -
[Save changes] (変更の保存) をクリックします。