Menu
Amazon Relational Database Service
API Reference (API Version 2014-10-31)

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, then a DBInstanceIdentifier must be supplied.

  • If the source type is a DB security group, a DBSecurityGroupName must be supplied.

  • If the source type is a DB parameter group, a DBParameterGroupName must be supplied.

  • If the source type is a DB snapshot, a DBSnapshotIdentifier 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

Copy
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

Copy
<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: