Smaws_Client_DocDB.CreateEventSubscriptionCreates an Amazon DocumentDB event notification subscription. This action requires a topic Amazon Resource Name (ARN) created by using the Amazon DocumentDB console, the Amazon SNS console, or the Amazon SNS API. To obtain an ARN with Amazon SNS, you must create a topic in Amazon SNS and subscribe to the topic. The ARN is displayed in the Amazon SNS console.
You can specify the type of source (SourceType) that you want to be notified of. You can also provide a list of Amazon DocumentDB sources (SourceIds) that trigger the events, and you can provide a list of event categories (EventCategories) for events that 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 Amazon DocumentDB sources. If you do not specify either the SourceType or the SourceIdentifier, you are notified of events generated from all Amazon DocumentDB sources belonging to your customer account.
val error_to_string :
[ Smaws_Lib.Protocols.AwsQuery.error
| `EventSubscriptionQuotaExceededFault of
Types.event_subscription_quota_exceeded_fault
| `SNSInvalidTopicFault of Types.sns_invalid_topic_fault
| `SNSNoAuthorizationFault of Types.sns_no_authorization_fault
| `SNSTopicArnNotFoundFault of Types.sns_topic_arn_not_found_fault
| `SourceNotFoundFault of Types.source_not_found_fault
| `SubscriptionAlreadyExistFault of Types.subscription_already_exist_fault
| `SubscriptionCategoryNotFoundFault of
Types.subscription_category_not_found_fault ] ->
stringval request :
'http_type Smaws_Lib.Context.t ->
Types.create_event_subscription_message ->
(Types.create_event_subscription_result,
[> Smaws_Lib.Protocols.AwsQuery.error
| `EventSubscriptionQuotaExceededFault of
Types.event_subscription_quota_exceeded_fault
| `SNSInvalidTopicFault of Types.sns_invalid_topic_fault
| `SNSNoAuthorizationFault of Types.sns_no_authorization_fault
| `SNSTopicArnNotFoundFault of Types.sns_topic_arn_not_found_fault
| `SourceNotFoundFault of Types.source_not_found_fault
| `SubscriptionAlreadyExistFault of Types.subscription_already_exist_fault
| `SubscriptionCategoryNotFoundFault of
Types.subscription_category_not_found_fault ])
Stdlib.resultval request_with_metadata :
'http_type Smaws_Lib.Context.t ->
Types.create_event_subscription_message ->
(Types.create_event_subscription_result Smaws_Lib.Response.t,
[> Smaws_Lib.Protocols.AwsQuery.error
| `EventSubscriptionQuotaExceededFault of
Types.event_subscription_quota_exceeded_fault
| `SNSInvalidTopicFault of Types.sns_invalid_topic_fault
| `SNSNoAuthorizationFault of Types.sns_no_authorization_fault
| `SNSTopicArnNotFoundFault of Types.sns_topic_arn_not_found_fault
| `SourceNotFoundFault of Types.source_not_found_fault
| `SubscriptionAlreadyExistFault of Types.subscription_already_exist_fault
| `SubscriptionCategoryNotFoundFault of
Types.subscription_category_not_found_fault ]
* Smaws_Lib.Response.metadata)
Stdlib.result