AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates an RDS event notification subscription. This action requires a topic ARN (Amazon Resource Name) created by either the RDS console, the SNS console, or the SNS API. To obtain an ARN with SNS, you must create a topic in Amazon SNS and subscribe to the topic. The ARN is displayed in the SNS console.

You can specify the type of source (SourceType) you want to be notified of, provide a list of RDS sources (SourceIds) that triggers the events, and provide a list of event categories (EventCategories) for events you want to be notified of. For example, you can specify SourceType = db-instance, SourceIds = mydbinstance1, mydbinstance2 and EventCategories = Availability, Backup.

If you specify both the SourceType and SourceIds, such as SourceType = db-instance and SourceIdentifier = myDBInstance1, you are notified of all the db-instance events for the specified source. If you specify a SourceType but do not specify a SourceIdentifier, you receive notice of the events for that source type for all your RDS sources. If you do not specify either the SourceType nor the SourceIdentifier, you are notified of events generated from all RDS sources belonging to your customer account.


For .NET Core and PCL this operation is only available in asynchronous form. Please refer to CreateEventSubscriptionAsync.

Namespace: Amazon.RDS
Assembly: AWSSDK.RDS.dll
Version: 3.x.y.z


public virtual CreateEventSubscriptionResponse CreateEventSubscription(
         CreateEventSubscriptionRequest request
Type: Amazon.RDS.Model.CreateEventSubscriptionRequest

Container for the necessary parameters to execute the CreateEventSubscription service method.

Return Value
The response from the CreateEventSubscription service method, as returned by RDS.


EventSubscriptionQuotaExceededException You have reached the maximum number of event subscriptions.
SNSInvalidTopicException SNS has responded that there is a problem with the SND topic specified.
SNSNoAuthorizationException You do not have permission to publish to the SNS topic ARN.
SNSTopicArnNotFoundException The SNS topic ARN does not exist.
SourceNotFoundException The requested source could not be found.
SubscriptionAlreadyExistException The supplied subscription name already exists.
SubscriptionCategoryNotFoundException The supplied category does not exist.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also