aws rds create-event-subscription

Creates an RDS event notification subscription. AWS CLI reference

1 example 7 options Its page in the AWS CLI reference

Examples

from aws-cli, each command read by CmdID

To create an event subscription

The following create-event-subscription example creates a subscription for backup and recovery events for DB instances in the current AWS account. Notifications are sent to an Amazon Simple Notification Service topic, specified by --sns-topic-arn.

aws rds create-event-subscription --subscription-name my-instance-events --source-type db-instance --event-categories '["backup","recovery"]' --sns-topic-arn arn:aws:sns:us-west-2:123456789012:interesting-events

Identify

--subscription-nameThe name of the subscription.

--source-typeThe type of source that is generating the events.

--event-categoriesA list of event categories for a particular source type (SourceType) that you want to subscribe to.

--sns-topic-arnThe Amazon Resource Name (ARN) of the SNS topic created for event notification.

Its output

{
    "EventSubscription": {
        "Status": "creating",
        "CustSubscriptionId": "my-instance-events",
        "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018",
        "EventCategoriesList": [
            "backup",
            "recovery"
        ],
        "SnsTopicArn": "arn:aws:sns:us-west-2:123456789012:interesting-events",
        "CustomerAwsId": "123456789012",
        "EventSubscriptionArn": "arn:aws:rds:us-west-2:123456789012:es:my-instance-events",
        "SourceType": "db-instance",
        "Enabled": true
    }
}

For more information, see Subscribing to Amazon RDS event notification in the Amazon RDS User Guide.

Options

7 in the AWS CLI reference

--enabledSpecifies whether to activate the subscription.

--event-categoriesA list of event categories for a particular source type (SourceType) that you want to subscribe to.

--sns-topic-arnThe Amazon Resource Name (ARN) of the SNS topic created for event notification.

--source-idsThe list of identifiers of the event sources for which events are returned.

--source-typeThe type of source that is generating the events.

--subscription-nameThe name of the subscription.

--tagsA list of tags.