Adds a source identifier to an existing RDS event notification subscription.
See also: AWS API Documentation
See ‘aws help’ for descriptions of global parameters.
add-source-identifier-to-subscription
--subscription-name <value>
--source-identifier <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
--subscription-name
(string)
The name of the RDS event notification subscription you want to add a source identifier to.
--source-identifier
(string)
The identifier of the event source to be added.
Constraints:
If the source type is a DB instance, a
DBInstanceIdentifier
value must be supplied.If the source type is a DB cluster, a
DBClusterIdentifier
value must be supplied.If the source type is a DB parameter group, a
DBParameterGroupName
value must be supplied.If the source type is a DB security group, a
DBSecurityGroupName
value must be supplied.If the source type is a DB snapshot, a
DBSnapshotIdentifier
value must be supplied.If the source type is a DB cluster snapshot, a
DBClusterSnapshotIdentifier
value must be supplied.
--cli-input-json
| --cli-input-yaml
(string)
Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton
. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml
.
--generate-cli-skeleton
(string)
Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input
, prints a sample input JSON that can be used as an argument for --cli-input-json
. Similarly, if provided yaml-input
it will print a sample input YAML that can be used with --cli-input-yaml
. If provided with the value output
, it validates the command inputs and returns a sample output JSON for that command.
See ‘aws help’ for descriptions of global parameters.
To add a source identifier to a subscription
The following add-source-identifier
example adds another source identifier to an existing subscription.
aws rds add-source-identifier-to-subscription \
--subscription-name my-instance-events \
--source-identifier test-instance-repl
Output:
{
"EventSubscription": {
"SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018",
"CustSubscriptionId": "my-instance-events",
"EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events",
"Enabled": false,
"Status": "modifying",
"EventCategoriesList": [
"backup",
"recovery"
],
"CustomerAwsId": "123456789012",
"SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events",
"SourceType": "db-instance",
"SourceIdsList": [
"test-instance",
"test-instance-repl"
]
}
}
EventSubscription -> (structure)
Contains the results of a successful invocation of the
DescribeEventSubscriptions
action.CustomerAwsId -> (string)
The Amazon Web Services customer account associated with the RDS event notification subscription.
CustSubscriptionId -> (string)
The RDS event notification subscription Id.
SnsTopicArn -> (string)
The topic ARN of the RDS event notification subscription.
Status -> (string)
The status of the RDS event notification subscription.
Constraints:
Can be one of the following: creating | modifying | deleting | active | no-permission | topic-not-exist
The status “no-permission” indicates that RDS no longer has permission to post to the SNS topic. The status “topic-not-exist” indicates that the topic was deleted after the subscription was created.
SubscriptionCreationTime -> (string)
The time the RDS event notification subscription was created.
SourceType -> (string)
The source type for the RDS event notification subscription.
SourceIdsList -> (list)
A list of source IDs for the RDS event notification subscription.
(string)
EventCategoriesList -> (list)
A list of event categories for the RDS event notification subscription.
(string)
Enabled -> (boolean)
A Boolean value indicating if the subscription is enabled. True indicates the subscription is enabled.
EventSubscriptionArn -> (string)
The Amazon Resource Name (ARN) for the event subscription.