Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Working with Amazon SNS events and notifications in Amazon Database Migration Service

Beginning with the release of Amazon DMS 3.4.5 and with later versions, we recommend that you use Amazon EventBridge to provide notifications when an Amazon DMS event occurs. For more information about using EventBridge events with Amazon DMS, see Working with Amazon EventBridge events and notifications in Amazon Database Migration Service.

Moving event subscriptions to Amazon EventBridge

You can use the following Amazon CLI command to migrate active event subscriptions from DMS to Amazon EventBridge, up to 10 at a time.

update-subscriptions-to-event-bridge [--force-move | --no-force-move]

By default, Amazon DMS only migrates active event subscriptions when your replication instance is current with Amazon DMS 3.4.5 and higher. To override this default behavior, use the --force-move option. However, some types of events might not be available by using Amazon EventBridge if your replication instances aren't upgraded.

To run the update-subscriptions-to-event-bridge CLI command, an Amazon Identity and Access Management (IAM) user must have the following policy permissions.

{
  "Version": "2012-10-17",
  "Statement": [
      {
          "Effect": "Allow",
          "Action": [
              "SNS:GetTopicAttributes",
              "SNS:SetTopicAttributes",
              "events:PutTargets",
              "events:EnableRule",
              "events:PutRule"
          ],
          "Resource": "*"
      }
  ]
}
    

For more information about moving subscriptions to EventBridge, see UpdateSubscriptionsToEventBridge in the Amazon Database Migration Service API Reference.

Working with Amazon SNS events and notifications

Amazon DMS versions 3.4.5 and earlier support working with events and notifications as described following.

Amazon Database Migration Service (Amazon DMS) can use Amazon Simple Notification Service (Amazon SNS) to provide notifications when an Amazon DMS event occurs, for example the creation or deletion of a replication instance. You can work with these notifications in any form supported by Amazon SNS for an Amazon Region, such as an email message, a text message, or a call to an HTTP endpoint.

Amazon DMS groups events into categories that you can subscribe to, so you can be notified when an event in that category occurs. For example, if you subscribe to the Creation category for a given replication instance, you are notified whenever a creation-related event occurs that affects your replication instance. If you subscribe to a Configuration Change category for a replication instance, you are notified when the replication instance's configuration is changed. You also receive notification when an event notification subscription changes. For a list of the event categories provided by Amazon DMS, see Amazon DMS event categories and event messages for SNS notifications, following.

Amazon DMS sends event notifications to the addresses you provide when you create an event subscription. You might want to create several different subscriptions, such as one subscription receiving all event notifications and another subscription that includes only critical events for your production DMS resources. You can easily turn off notification without deleting a subscription by deselecting the Enabled option in the Amazon DMS console, or by setting the Enabled parameter to false using the Amazon DMS API.

Amazon DMS uses a subscription identifier to identify each subscription. You can have multiple Amazon DMS event subscriptions published to the same Amazon SNS topic. When you use event notification, Amazon SNS fees apply; for more information on Amazon SNS billing, see Amazon SNS pricing.

To subscribe to Amazon DMS events with Amazon SNS, use the following process:

For the list of categories and events that you can be notified of, see the following section. For more details about subscribing to and working with Amazon DMS event subscriptions, see Subscribing to Amazon DMS event notification using SNS.

Amazon DMS event categories and event messages for SNS notifications

Amazon DMS generates a significant number of events in categories that you can subscribe to using the Amazon DMS console or the Amazon DMS API. Each category applies to a source type; currently Amazon DMS supports the replication instance and replication task source types.

The following table shows the possible categories and events for the replication instance source type.

The following table shows the possible categories and events for the replication task source type.

The following example shows an Amazon DMS event subscription with the State Change category.

            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

Subscribing to Amazon DMS event notification using SNS

You can create an Amazon DMS event notification subscription so you can be notified when an Amazon DMS event occurs. The simplest way to create a subscription is with the Amazon DMS console. In a notification subscription, you choose how and where to send notifications. You specify the type of source you want to be notified of; currently Amazon DMS supports the replication instance and replication task source types. And, depending on the source type you select, you choose the event categories and identify the source you want to receive event notifications for.

Validating the access policy of your SNS topic

Your SNS access policy requires permissions that allow Amazon DMS to publish events to your SNS topic. You can validate and update your access policy as described in the following procedures.

You can update your policy if your SNS access policy doesn't allow Amazon DMS to publish events to your SNS topic.