ModifyEventSubscription - Amazon DocumentDB

ModifyEventSubscription

Modifies an existing Amazon DocumentDB event notification subscription.

Request Parameters

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

SubscriptionName

The name of the Amazon DocumentDB event notification subscription.

Type: String

Required: Yes

Enabled

A Boolean value; set to true to activate the subscription.

Type: Boolean

Required: No

EventCategories.EventCategory.N

A list of event categories for a SourceType that you want to subscribe to.

Type: Array of strings

Required: No

SnsTopicArn

The Amazon Resource Name (ARN) of the SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.

Type: String

Required: No

SourceType

The type of source that is generating the events. For example, if you want to be notified of events generated by an instance, set this parameter to db-instance. If this value is not specified, all events are returned.

Valid values: db-instance, db-parameter-group, db-security-group

Type: String

Required: No

Response Elements

The following element is returned by the service.

EventSubscription

Detailed information about an event to which you have subscribed.

Type: EventSubscription object

Errors

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

EventSubscriptionQuotaExceeded

You have reached the maximum number of event subscriptions.

HTTP Status Code: 400

SNSInvalidTopic

Amazon SNS has responded that there is a problem with the specified topic.

HTTP Status Code: 400

SNSNoAuthorization

You do not have permission to publish to the SNS topic Amazon Resource Name (ARN).

HTTP Status Code: 400

SNSTopicArnNotFound

The SNS topic Amazon Resource Name (ARN) does not exist.

HTTP Status Code: 404

SubscriptionCategoryNotFound

The provided category does not exist.

HTTP Status Code: 404

SubscriptionNotFound

The subscription name does not exist.

HTTP Status Code: 404

See Also

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