翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AWS Database Migration Serviceでの Amazon SNS イベントと通知の使用
AWS DMS 3.4.5 以降のバージョンのリリース以降では、Amazon EventBridge を使用して、 AWS DMS イベントが発生したときに通知を提供することをお勧めします。での EventBridge イベントの使用の詳細については AWS DMS、「」を参照してくださいでの Amazon EventBridge イベントと通知の使用 AWS Database Migration Service。
イベントサブスクリプションの 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 が提供するイベントカテゴリのリストについては、AWS SNS 通知の DMS イベントカテゴリとイベントメッセージ以下を参照してください。
AWS DMS は、イベントサブスクリプションの作成時に指定したアドレスにイベント通知を送信します。いくつかの異なるサブスクリプションを作成することもできます。たとえば、すべてのイベント通知を受け取るサブスクリプションと、本稼働環境の DMS リソースに関する重要なイベントのみを含むサブスクリプションを作成できます。DMS コンソールで Enabled オプションを選択解除するか、DMS API AWS を使用して Enabled
パラメータを false AWS に設定することで、サブスクリプションを削除せずに通知を簡単に無効にできます。
注記
AWS SMS テキストメッセージを使用した DMS イベント通知は、現在、Amazon SNS がサポートされているすべての AWS リージョンの AWS DMS リソースで使用できます。 Amazon SNS Amazon SNS が SMS メッセージングをサポートする AWS リージョンと国のリストについては、「対応リージョンと国」をご参照ください。
SNS によるテキストメッセージ使用の詳細については、「Amazon SNS を使用した SMS 通知の送信と受信」をご参照ください。
AWS DMS イベント通知は、CloudWatch または EventBridge の CloudTrail イベントとは異なります。 CloudWatch EventBridge CloudTrail イベント通知は任意の API 呼び出しによって生成できます。DMS は、DMS イベントが発生したときにのみ通知を送信します。
AWS DMS はサブスクリプション識別子を使用して各サブスクリプションを識別します。複数の AWS DMS イベントサブスクリプションを同じ Amazon SNS トピックに発行できます。イベント通知を使用すると Amazon SNS の料金が適用されます。Amazon SNS の請求詳細については 「 Amazon SNS 料金表
Amazon SNS AWS で DMS イベントをサブスクライブするには、次のプロセスを使用します。 Amazon SNS
-
Amazon SNS トピックを作成します。トピックでは、受け取る通知のタイプと、通知先のアドレスまたは番号を指定します。
-
AWS Management Console、、または AWS DMS API を使用して AWS CLI DMS AWS イベント通知サブスクリプションを作成します。
-
AWS DMS は、サブスクリプションで送信したアドレスに承認 E メールまたは SMS メッセージを送信します。サブスクリプションを確認するには、承認の E メールまたは SMS メッセージのリンクをクリックします。
-
サブスクリプションを確認すると、DMS AWS コンソールのイベントサブスクリプションセクションでサブスクリプションのステータスが更新されます。
-
その後、イベント通知を受け取り始めます。
通知できるカテゴリとイベントのリストについては、次のセクションをご参照ください。 AWS DMS イベントサブスクリプションへのサブスクライブと操作の詳細については、「」を参照してくださいSNS AWS を使用した DMS イベント通知のサブスクライブ。
トピック
AWS SNS 通知の DMS イベントカテゴリとイベントメッセージ
重要
AWS DMS 3.4.5 以降のバージョンのリリース以降では、Amazon EventBridge を使用して、 AWS DMS イベントが発生したときに通知を提供することをお勧めします。での EventBridge イベントの使用の詳細については AWS DMS、「」を参照してくださいでの Amazon EventBridge イベントと通知の使用 AWS Database Migration Service。
AWS DMS は、DMS コンソールまたは DMS AWS API AWS を使用してサブスクライブできるカテゴリで多数のイベントを生成します。各カテゴリはソースタイプに適用されます。現在、DMS AWS はレプリケーションインスタンスとレプリケーションタスクのソースタイプをサポートしています。
以下の表では、レプリケーション インスタンスソースタイプの可能なカテゴリとイベントを示しています。
カテゴリ |
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 以降のバージョンのリリース以降では、Amazon EventBridge を使用して、 AWS DMS イベントが発生したときに通知を提供することをお勧めします。での EventBridge イベントの使用の詳細については AWS DMS、「」を参照してくださいでの Amazon EventBridge イベントと通知の使用 AWS Database Migration Service。
AWS DMS イベント通知サブスクリプションを作成して、 AWS DMS イベントが発生したときに通知を受け取ることができます。サブスクリプションを作成する最も簡単な方法は、 AWS DMS コンソールを使用することです。通知サブスクリプションでは、通知の送信方法と場所を選択します。通知を受け取るソースのタイプを指定します。 は現在、レプリケーションインスタンスとレプリケーションタスクのソースタイプ AWS DMS をサポートしています。さらに選択したソースタイプに応じて、イベント通知を受け取る対象のイベントカテゴリを選択しソースを識別します。
の使用 AWS Management Console
重要
AWS DMS 3.4.5 以降のバージョンのリリース以降では、Amazon EventBridge を使用して、 AWS DMS イベントが発生したときに通知を提供することをお勧めします。での EventBridge イベントの使用の詳細については AWS DMS、「」を参照してくださいでの Amazon EventBridge イベントと通知の使用 AWS Database Migration Service。
コンソールを使用して Amazon SNS AWS で DMS イベント通知をサブスクライブするには Amazon SNS
-
にサインイン AWS Management Console し、https://console.aws.amazon.com/dms/v2/
で AWS DMS コンソールを開きます。 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 アクセスポリシーには、 が SNS トピック AWS DMS にイベントを発行できるようにするアクセス許可が必要です。次の手順の説明のとおり、アクセスポリシーを検証し、更新できます。
アクセスポリシーを検証するには
-
[Amazon SNS コンソール] を開きます。
-
ナビゲーションペインで [トピック] をクリックして、DMS 通知を受け取るトピックを選択します。
-
[アクセスポリシー] タブをクリックします。
SNS アクセスポリシーで が SNS トピック AWS DMS にイベントを発行することを許可していない場合は、ポリシーを更新できます。
アクセスポリシーを更新するには
-
トピックページの [詳細] セクションで、[編集] を選択します。
-
[アクセスポリシー] セクションを展開して、次のポリシーを 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] (変更の保存) をクリックします。