Sign in Dashboard Get started
  1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. dms
  6. EventSubscription

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.76.0
published on Monday, Aug 24, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

aws-native.dms.EventSubscription

aws-native logo aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.76.0
published on Monday, Aug 24, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

    Resource Type definition for AWS::DMS::EventSubscription

    Example Usage

    Example

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AwsNative = Pulumi.AwsNative;

return await Deployment.RunAsync(() => 
{
    var myEventSubscription = new AwsNative.Dms.EventSubscription("myEventSubscription", new()
    {
        EventCategories = new[]
        {
            "configuration change",
            "failure",
            "deletion",
        },
        SnsTopicArn = "arn:aws:sns:us-west-2:123456789012:example-topic",
        SourceIds = new[]
        {
            "rep-instance-1",
        },
        SourceType = "replication-instance",
        Enabled = false,
    });

});

    package main

import (
	"github.com/pulumi/pulumi-aws-native/sdk/go/aws/dms"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := dms.NewEventSubscription(ctx, "myEventSubscription", &dms.EventSubscriptionArgs{
			EventCategories: pulumi.StringArray{
				pulumi.String("configuration change"),
				pulumi.String("failure"),
				pulumi.String("deletion"),
			},
			SnsTopicArn: pulumi.String("arn:aws:sns:us-west-2:123456789012:example-topic"),
			SourceIds: pulumi.StringArray{
				pulumi.String("rep-instance-1"),
			},
			SourceType: pulumi.String("replication-instance"),
			Enabled:    pulumi.Bool(false),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    Example coming soon!

    Example coming soon!

    import * as pulumi from "@pulumi/pulumi";
import * as aws_native from "@pulumi/aws-native";

const myEventSubscription = new aws_native.dms.EventSubscription("myEventSubscription", {
    eventCategories: [
        "configuration change",
        "failure",
        "deletion",
    ],
    snsTopicArn: "arn:aws:sns:us-west-2:123456789012:example-topic",
    sourceIds: ["rep-instance-1"],
    sourceType: "replication-instance",
    enabled: false,
});

    import pulumi
import pulumi_aws_native as aws_native

my_event_subscription = aws_native.dms.EventSubscription("myEventSubscription",
    event_categories=[
        "configuration change",
        "failure",
        "deletion",
    ],
    sns_topic_arn="arn:aws:sns:us-west-2:123456789012:example-topic",
    source_ids=["rep-instance-1"],
    source_type="replication-instance",
    enabled=False)

    Example coming soon!

    Example

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AwsNative = Pulumi.AwsNative;

return await Deployment.RunAsync(() => 
{
    var myEventSubscription = new AwsNative.Dms.EventSubscription("myEventSubscription", new()
    {
        Enabled = false,
        EventCategories = new[]
        {
            "configuration change",
            "failure",
            "deletion",
        },
        SnsTopicArn = "arn:aws:sns:us-west-2:123456789012:example-topic",
        SourceIds = new[]
        {
            "rep-instance-1",
        },
        SourceType = "replication-instance",
    });

});

    package main

import (
	"github.com/pulumi/pulumi-aws-native/sdk/go/aws/dms"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := dms.NewEventSubscription(ctx, "myEventSubscription", &dms.EventSubscriptionArgs{
			Enabled: pulumi.Bool(false),
			EventCategories: pulumi.StringArray{
				pulumi.String("configuration change"),
				pulumi.String("failure"),
				pulumi.String("deletion"),
			},
			SnsTopicArn: pulumi.String("arn:aws:sns:us-west-2:123456789012:example-topic"),
			SourceIds: pulumi.StringArray{
				pulumi.String("rep-instance-1"),
			},
			SourceType: pulumi.String("replication-instance"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    Example coming soon!

    Example coming soon!

    import * as pulumi from "@pulumi/pulumi";
import * as aws_native from "@pulumi/aws-native";

const myEventSubscription = new aws_native.dms.EventSubscription("myEventSubscription", {
    enabled: false,
    eventCategories: [
        "configuration change",
        "failure",
        "deletion",
    ],
    snsTopicArn: "arn:aws:sns:us-west-2:123456789012:example-topic",
    sourceIds: ["rep-instance-1"],
    sourceType: "replication-instance",
});

    import pulumi
import pulumi_aws_native as aws_native

my_event_subscription = aws_native.dms.EventSubscription("myEventSubscription",
    enabled=False,
    event_categories=[
        "configuration change",
        "failure",
        "deletion",
    ],
    sns_topic_arn="arn:aws:sns:us-west-2:123456789012:example-topic",
    source_ids=["rep-instance-1"],
    source_type="replication-instance")

    Example coming soon!

    Create EventSubscription Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new EventSubscription(name: string, args: EventSubscriptionArgs, opts?: CustomResourceOptions);
    @overload
def EventSubscription(resource_name: str,
                      args: EventSubscriptionArgs,
                      opts: Optional[ResourceOptions] = None)

@overload
def EventSubscription(resource_name: str,
                      opts: Optional[ResourceOptions] = None,
                      sns_topic_arn: Optional[str] = None,
                      enabled: Optional[bool] = None,
                      event_categories: Optional[Sequence[str]] = None,
                      source_ids: Optional[Sequence[str]] = None,
                      source_type: Optional[str] = None,
                      subscription_name: Optional[str] = None,
                      tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
    func NewEventSubscription(ctx *Context, name string, args EventSubscriptionArgs, opts ...ResourceOption) (*EventSubscription, error)
    public EventSubscription(string name, EventSubscriptionArgs args, CustomResourceOptions? opts = null)
    public EventSubscription(String name, EventSubscriptionArgs args)
public EventSubscription(String name, EventSubscriptionArgs args, CustomResourceOptions options)

    type: aws-native:dms:EventSubscription
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "aws-native_dms_event_subscription" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args EventSubscriptionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args EventSubscriptionArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args EventSubscriptionArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args EventSubscriptionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args EventSubscriptionArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    EventSubscription Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The EventSubscription resource accepts the following input properties:

    SnsTopicArn string
    The Amazon Resource Name (ARN) of the Amazon SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.
    Enabled bool
    Indicates whether to activate the subscription. If you don't specify this property, CloudFormation activates the subscription.
    EventCategories List<string>
    A list of event categories for a source type that you want to subscribe to. If you don't specify this property, you are notified about all event categories.
    SourceIds List<string>

    A list of identifiers for which AWS DMS provides notification events.

    If you don't specify a value, notifications are provided for all sources.

    If you specify multiple values, they must be of the same type. For example, if you specify a database instance ID, then all of the other values must be database instance IDs.

    SourceType string
    The type of AWS DMS resource that generates the events. For example, if you want to be notified of events generated by a replication instance, you set this parameter to replication-instance. If this value isn't specified, all events are returned.
    SubscriptionName string
    The name of the AWS DMS event notification subscription. This name must be less than 255 characters.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    One or more tags to be assigned to the event subscription.
    SnsTopicArn string
    The Amazon Resource Name (ARN) of the Amazon SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.
    Enabled bool
    Indicates whether to activate the subscription. If you don't specify this property, CloudFormation activates the subscription.
    EventCategories []string
    A list of event categories for a source type that you want to subscribe to. If you don't specify this property, you are notified about all event categories.
    SourceIds []string

    A list of identifiers for which AWS DMS provides notification events.

    If you don't specify a value, notifications are provided for all sources.

    If you specify multiple values, they must be of the same type. For example, if you specify a database instance ID, then all of the other values must be database instance IDs.

    SourceType string
    The type of AWS DMS resource that generates the events. For example, if you want to be notified of events generated by a replication instance, you set this parameter to replication-instance. If this value isn't specified, all events are returned.
    SubscriptionName string
    The name of the AWS DMS event notification subscription. This name must be less than 255 characters.
    Tags TagArgs
    One or more tags to be assigned to the event subscription.
    sns_topic_arn string
    The Amazon Resource Name (ARN) of the Amazon SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.
    enabled bool
    Indicates whether to activate the subscription. If you don't specify this property, CloudFormation activates the subscription.
    event_categories list(string)
    A list of event categories for a source type that you want to subscribe to. If you don't specify this property, you are notified about all event categories.
    source_ids list(string)

    A list of identifiers for which AWS DMS provides notification events.

    If you don't specify a value, notifications are provided for all sources.

    If you specify multiple values, they must be of the same type. For example, if you specify a database instance ID, then all of the other values must be database instance IDs.

    source_type string
    The type of AWS DMS resource that generates the events. For example, if you want to be notified of events generated by a replication instance, you set this parameter to replication-instance. If this value isn't specified, all events are returned.
    subscription_name string
    The name of the AWS DMS event notification subscription. This name must be less than 255 characters.
    tags list(object)
    One or more tags to be assigned to the event subscription.
    snsTopicArn String
    The Amazon Resource Name (ARN) of the Amazon SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.
    enabled Boolean
    Indicates whether to activate the subscription. If you don't specify this property, CloudFormation activates the subscription.
    eventCategories List<String>
    A list of event categories for a source type that you want to subscribe to. If you don't specify this property, you are notified about all event categories.
    sourceIds List<String>

    A list of identifiers for which AWS DMS provides notification events.

    If you don't specify a value, notifications are provided for all sources.

    If you specify multiple values, they must be of the same type. For example, if you specify a database instance ID, then all of the other values must be database instance IDs.

    sourceType String
    The type of AWS DMS resource that generates the events. For example, if you want to be notified of events generated by a replication instance, you set this parameter to replication-instance. If this value isn't specified, all events are returned.
    subscriptionName String
    The name of the AWS DMS event notification subscription. This name must be less than 255 characters.
    tags List<Tag>
    One or more tags to be assigned to the event subscription.
    snsTopicArn string
    The Amazon Resource Name (ARN) of the Amazon SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.
    enabled boolean
    Indicates whether to activate the subscription. If you don't specify this property, CloudFormation activates the subscription.
    eventCategories string[]
    A list of event categories for a source type that you want to subscribe to. If you don't specify this property, you are notified about all event categories.
    sourceIds string[]

    A list of identifiers for which AWS DMS provides notification events.

    If you don't specify a value, notifications are provided for all sources.

    If you specify multiple values, they must be of the same type. For example, if you specify a database instance ID, then all of the other values must be database instance IDs.

    sourceType string
    The type of AWS DMS resource that generates the events. For example, if you want to be notified of events generated by a replication instance, you set this parameter to replication-instance. If this value isn't specified, all events are returned.
    subscriptionName string
    The name of the AWS DMS event notification subscription. This name must be less than 255 characters.
    tags Tag[]
    One or more tags to be assigned to the event subscription.
    sns_topic_arn str
    The Amazon Resource Name (ARN) of the Amazon SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.
    enabled bool
    Indicates whether to activate the subscription. If you don't specify this property, CloudFormation activates the subscription.
    event_categories Sequence[str]
    A list of event categories for a source type that you want to subscribe to. If you don't specify this property, you are notified about all event categories.
    source_ids Sequence[str]

    A list of identifiers for which AWS DMS provides notification events.

    If you don't specify a value, notifications are provided for all sources.

    If you specify multiple values, they must be of the same type. For example, if you specify a database instance ID, then all of the other values must be database instance IDs.

    source_type str
    The type of AWS DMS resource that generates the events. For example, if you want to be notified of events generated by a replication instance, you set this parameter to replication-instance. If this value isn't specified, all events are returned.
    subscription_name str
    The name of the AWS DMS event notification subscription. This name must be less than 255 characters.
    tags Sequence[TagArgs]
    One or more tags to be assigned to the event subscription.
    snsTopicArn String
    The Amazon Resource Name (ARN) of the Amazon SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.
    enabled Boolean
    Indicates whether to activate the subscription. If you don't specify this property, CloudFormation activates the subscription.
    eventCategories List<String>
    A list of event categories for a source type that you want to subscribe to. If you don't specify this property, you are notified about all event categories.
    sourceIds List<String>

    A list of identifiers for which AWS DMS provides notification events.

    If you don't specify a value, notifications are provided for all sources.

    If you specify multiple values, they must be of the same type. For example, if you specify a database instance ID, then all of the other values must be database instance IDs.

    sourceType String
    The type of AWS DMS resource that generates the events. For example, if you want to be notified of events generated by a replication instance, you set this parameter to replication-instance. If this value isn't specified, all events are returned.
    subscriptionName String
    The name of the AWS DMS event notification subscription. This name must be less than 255 characters.
    tags List<Property Map>
    One or more tags to be assigned to the event subscription.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the EventSubscription resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Supporting Types

    Tag, TagArgs

    A set of tags to apply to the resource.
    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.76.0
    published on Monday, Aug 24, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws-native

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial