AddSourceIdentifierToSubscription - Amazon Relational Database Service

AddSourceIdentifierToSubscription

Adds a source identifier to an existing RDS event notification subscription.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

SourceIdentifier

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.

Type: String

Required: Yes

SubscriptionName

The name of the RDS event notification subscription you want to add a source identifier to.

Type: String

Required: Yes

Response Elements

The following element is returned by the service.

EventSubscription

Contains the results of a successful invocation of the DescribeEventSubscriptions action.

Type: EventSubscription object

Errors

For information about the errors that are common to all actions, see Common Errors.

SourceNotFound

The requested source could not be found.

HTTP Status Code: 404

SubscriptionNotFound

The subscription name does not exist.

HTTP Status Code: 404

Example

Sample Request

https://rds.us-east-1.amazonaws.com/ ?Action=AddSourceIdentifierToSubscription &SignatureMethod=HmacSHA256 &SignatureVersion=4 &SourceIdentifier=mysqldb &SubscriptionName=EventSubscription04 &Version=2014-09-01 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIADQKE4SARGYLE/20140422/us-east-1/rds/aws4_request &X-Amz-Date=20140422T230442Z &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date &X-Amz-Signature=347d5e788e809cd06c50214b12750a3c39716bf65b239bb6f7ee8ff5374e2df9

Sample Response

<AddSourceIdentifierToSubscriptionResponse xmlns="http://rds.amazonaws.com/doc/2014-09-01/"> <AddSourceIdentifierToSubscriptionResult> <EventSubscription> <SourceType>db-instance</SourceType> <Enabled>true</Enabled> <CustomerAwsId>803#########</CustomerAwsId> <Status>modifying</Status> <SourceIdsList> <SourceId>mysqldb</SourceId> </SourceIdsList> <SubscriptionCreationTime>2014-04-22 23:03:19.776</SubscriptionCreationTime> <EventCategoriesList> <EventCategory>creation</EventCategory> <EventCategory>deletion</EventCategory> </EventCategoriesList> <CustSubscriptionId>EventSubscription04</CustSubscriptionId> <SnsTopicArn>arn:aws:sns:us-east-1:803#########:myawsuser-RDS</SnsTopicArn> </EventSubscription> </AddSourceIdentifierToSubscriptionResult> <ResponseMetadata> <RequestId>6c05f0b0-bf71-11d3-f4c6-37db295f7674</RequestId> </ResponseMetadata> </AddSourceIdentifierToSubscriptionResponse>

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: