aws-sdk-docdb 1.29.0 → 1.33.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3032dd7cbf4e00fa845dc616e86a4f64ec7ecc98f524f12e6e4627e871361872
-  data.tar.gz: 3b0644ead88134136d111638b3dc7a61b389e0616284d7f249ecebdba0f061bd
+  metadata.gz: 6fd8cd589d911370953f9ec1fc9d8393c8ea8a4d7fe5e78a5df30a3d40dcb5b6
+  data.tar.gz: 2865a85012335ba556591d550a1e3f3fa4c619c8e3d9c754301dea6e703bef75
 SHA512:
-  metadata.gz: 7a9dbc1def3477eb6f84bf8cbc586c263e0a04588a7321df532ac91ecd4d491015c9908d784e4fd8044b552a816e25177e8bceed026f19a755e702e758ff4b30
-  data.tar.gz: 74648e61385463a9b2321743589a8aac6a2f5d7b188296d5687a518f8e394ae23f972ee94f3f4f6d1b29e929ee81fe7b9732555685c99618f1c5f1456a9421f7
+  metadata.gz: 6b94cf7e96d297ebad290c98ed81cfc622fefed714c75c66459d9f288b056b1bf54660d5eba8bf8a6a976a19eefd6c315c3afd9f6cadb5ffa650951ec3384d6d
+  data.tar.gz: 22a80cd7b906ee048492719ad369e95d5a304a36c774f121ebb67fbc4556b15f35ab11ed9927a22e5fa772670c4e0c6f61e69b1506a9259e940fb2504e4d6b26

data/CHANGELOG.md

@@ -1,6 +1,26 @@
 Unreleased Changes
 ------------------
 
+1.33.0 (2021-07-28)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.32.0 (2021-06-23)
+------------------
+
+* Feature - DocumentDB documentation-only edits
+
+1.31.0 (2021-06-02)
+------------------
+
+* Feature - This SDK release adds support for DocDB global clusters.
+
+1.30.0 (2021-03-29)
+------------------
+
+* Feature - This release adds support for Event Subscriptions to DocumentDB.
+
 1.29.0 (2021-03-10)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.29.0
+1.33.0

data/lib/aws-sdk-docdb.rb

@@ -29,7 +29,7 @@ require_relative 'aws-sdk-docdb/customizations'
 # structure.
 #
 #     doc_db = Aws::DocDB::Client.new
-#     resp = doc_db.add_tags_to_resource(params)
+#     resp = doc_db.add_source_identifier_to_subscription(params)
 #
 # See {Client} for more information.
 #
@@ -49,6 +49,6 @@ require_relative 'aws-sdk-docdb/customizations'
 # @!group service
 module Aws::DocDB
 
-  GEM_VERSION = '1.29.0'
+  GEM_VERSION = '1.33.0'
 
 end

data/lib/aws-sdk-docdb/client.rb

@@ -329,10 +329,67 @@ module Aws::DocDB
 
     # @!group API Operations
 
+    # Adds a source identifier to an existing event notification
+    # subscription.
+    #
+    # @option params [required, String] :subscription_name
+    #   The name of the Amazon DocumentDB event notification subscription that
+    #   you want to add a source identifier to.
+    #
+    # @option params [required, String] :source_identifier
+    #   The identifier of the event source to be added:
+    #
+    #   * If the source type is an instance, a `DBInstanceIdentifier` must be
+    #     provided.
+    #
+    #   * If the source type is a security group, a `DBSecurityGroupName` must
+    #     be provided.
+    #
+    #   * If the source type is a parameter group, a `DBParameterGroupName`
+    #     must be provided.
+    #
+    #   * If the source type is a snapshot, a `DBSnapshotIdentifier` must be
+    #     provided.
+    #
+    # @return [Types::AddSourceIdentifierToSubscriptionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::AddSourceIdentifierToSubscriptionResult#event_subscription #event_subscription} => Types::EventSubscription
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.add_source_identifier_to_subscription({
+    #     subscription_name: "String", # required
+    #     source_identifier: "String", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.event_subscription.customer_aws_id #=> String
+    #   resp.event_subscription.cust_subscription_id #=> String
+    #   resp.event_subscription.sns_topic_arn #=> String
+    #   resp.event_subscription.status #=> String
+    #   resp.event_subscription.subscription_creation_time #=> String
+    #   resp.event_subscription.source_type #=> String
+    #   resp.event_subscription.source_ids_list #=> Array
+    #   resp.event_subscription.source_ids_list[0] #=> String
+    #   resp.event_subscription.event_categories_list #=> Array
+    #   resp.event_subscription.event_categories_list[0] #=> String
+    #   resp.event_subscription.enabled #=> Boolean
+    #   resp.event_subscription.event_subscription_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/AddSourceIdentifierToSubscription AWS API Documentation
+    #
+    # @overload add_source_identifier_to_subscription(params = {})
+    # @param [Hash] params ({})
+    def add_source_identifier_to_subscription(params = {}, options = {})
+      req = build_request(:add_source_identifier_to_subscription, params)
+      req.send_request(options)
+    end
+
     # Adds metadata tags to an Amazon DocumentDB resource. You can use these
     # tags with cost allocation reporting to track costs that are associated
-    # with Amazon DocumentDB resources. or in a `Condition` statement in an
-    # AWS Identity and Access Management (IAM) policy for Amazon DocumentDB.
+    # with Amazon DocumentDB resources or in a `Condition` statement in an
+    # Identity and Access Management (IAM) policy for Amazon DocumentDB.
     #
     # @option params [required, String] :resource_name
     #   The Amazon DocumentDB resource that the tags are added to. This value
@@ -432,11 +489,11 @@ module Aws::DocDB
     #
     #   * Must specify a valid cluster parameter group.
     #
-    #   * If the source cluster parameter group is in the same AWS Region as
-    #     the copy, specify a valid parameter group identifier; for example,
+    #   * If the source cluster parameter group is in the same Region as the
+    #     copy, specify a valid parameter group identifier; for example,
     #     `my-db-cluster-param-group`, or a valid ARN.
     #
-    #   * If the source parameter group is in a different AWS Region than the
+    #   * If the source parameter group is in a different Region than the
     #     copy, specify a valid cluster parameter group ARN; for example,
     #     `arn:aws:rds:us-east-1:123456789012:sample-cluster:sample-parameter-group`.
     #
@@ -500,7 +557,7 @@ module Aws::DocDB
     # To copy a cluster snapshot from a shared manual cluster snapshot,
     # `SourceDBClusterSnapshotIdentifier` must be the Amazon Resource Name
     # (ARN) of the shared cluster snapshot. You can only copy a shared DB
-    # cluster snapshot, whether encrypted or not, in the same AWS Region.
+    # cluster snapshot, whether encrypted or not, in the same Region.
     #
     # To cancel the copy operation after it is in progress, delete the
     # target cluster snapshot identified by
@@ -515,10 +572,10 @@ module Aws::DocDB
     #
     #   * Must specify a valid system snapshot in the *available* state.
     #
-    #   * If the source snapshot is in the same AWS Region as the copy,
-    #     specify a valid snapshot identifier.
+    #   * If the source snapshot is in the same Region as the copy, specify a
+    #     valid snapshot identifier.
     #
-    #   * If the source snapshot is in a different AWS Region than the copy,
+    #   * If the source snapshot is in a different Region than the copy,
     #     specify a valid cluster snapshot ARN.
     #
     #   Example: `my-cluster-snapshot1`
@@ -538,54 +595,53 @@ module Aws::DocDB
     #   Example: `my-cluster-snapshot2`
     #
     # @option params [String] :kms_key_id
-    #   The AWS KMS key ID for an encrypted cluster snapshot. The AWS KMS key
-    #   ID is the Amazon Resource Name (ARN), AWS KMS key identifier, or the
-    #   AWS KMS key alias for the AWS KMS encryption key.
+    #   The KMS key ID for an encrypted cluster snapshot. The KMS key ID is
+    #   the Amazon Resource Name (ARN), KMS key identifier, or the KMS key
+    #   alias for the KMS encryption key.
     #
-    #   If you copy an encrypted cluster snapshot from your AWS account, you
-    #   can specify a value for `KmsKeyId` to encrypt the copy with a new AWS
-    #   KMS encryption key. If you don't specify a value for `KmsKeyId`, then
-    #   the copy of the cluster snapshot is encrypted with the same AWS KMS
-    #   key as the source cluster snapshot.
+    #   If you copy an encrypted cluster snapshot from your account, you can
+    #   specify a value for `KmsKeyId` to encrypt the copy with a new KMS
+    #   encryption key. If you don't specify a value for `KmsKeyId`, then the
+    #   copy of the cluster snapshot is encrypted with the same KMS key as the
+    #   source cluster snapshot.
     #
     #   If you copy an encrypted cluster snapshot that is shared from another
-    #   AWS account, then you must specify a value for `KmsKeyId`.
+    #   account, then you must specify a value for `KmsKeyId`.
     #
-    #   To copy an encrypted cluster snapshot to another AWS Region, set
-    #   `KmsKeyId` to the AWS KMS key ID that you want to use to encrypt the
-    #   copy of the cluster snapshot in the destination Region. AWS KMS
-    #   encryption keys are specific to the AWS Region that they are created
-    #   in, and you can't use encryption keys from one AWS Region in another
-    #   AWS Region.
+    #   To copy an encrypted cluster snapshot to another Region, set
+    #   `KmsKeyId` to the KMS key ID that you want to use to encrypt the copy
+    #   of the cluster snapshot in the destination Region. KMS encryption keys
+    #   are specific to the Region that they are created in, and you can't
+    #   use encryption keys from one Region in another Region.
     #
     #   If you copy an unencrypted cluster snapshot and specify a value for
     #   the `KmsKeyId` parameter, an error is returned.
     #
     # @option params [String] :pre_signed_url
-    #   The URL that contains a Signature Version 4 signed request for the
-    #   `CopyDBClusterSnapshot` API action in the AWS Region that contains the
+    #   The URL that contains a Signature Version 4 signed request for
+    #   the`CopyDBClusterSnapshot` API action in the Region that contains the
     #   source cluster snapshot to copy. You must use the `PreSignedUrl`
-    #   parameter when copying a cluster snapshot from another AWS Region.
+    #   parameter when copying a cluster snapshot from another Region.
     #
-    #   If you are using an AWS SDK tool or the AWS CLI, you can specify
-    #   `SourceRegion` (or `--source-region` for the AWS CLI) instead of
+    #   If you are using an Amazon Web Services SDK tool or the CLI, you can
+    #   specify `SourceRegion` (or `--source-region` for the CLI) instead of
     #   specifying `PreSignedUrl` manually. Specifying `SourceRegion`
     #   autogenerates a pre-signed URL that is a valid request for the
-    #   operation that can be executed in the source AWS Region.
+    #   operation that can be executed in the source Region.
     #
     #   The presigned URL must be a valid request for the
     #   `CopyDBClusterSnapshot` API action that can be executed in the source
-    #   AWS Region that contains the cluster snapshot to be copied. The
-    #   presigned URL request must contain the following parameter values:
+    #   Region that contains the cluster snapshot to be copied. The presigned
+    #   URL request must contain the following parameter values:
     #
     #   * `SourceRegion` - The ID of the region that contains the snapshot to
     #     be copied.
     #
     #   * `SourceDBClusterSnapshotIdentifier` - The identifier for the the
     #     encrypted cluster snapshot to be copied. This identifier must be in
-    #     the Amazon Resource Name (ARN) format for the source AWS Region. For
+    #     the Amazon Resource Name (ARN) format for the source Region. For
     #     example, if you are copying an encrypted cluster snapshot from the
-    #     us-east-1 AWS Region, then your `SourceDBClusterSnapshotIdentifier`
+    #     us-east-1 Region, then your `SourceDBClusterSnapshotIdentifier`
     #     looks something like the following:
     #     `arn:aws:rds:us-east-1:12345678012:sample-cluster:sample-cluster-snapshot`.
     #
@@ -709,16 +765,16 @@ module Aws::DocDB
     #   Valid values: `docdb`
     #
     # @option params [String] :engine_version
-    #   The version number of the database engine to use. The --engine-version
-    #   will default to the latest major engine version. For production
-    #   workloads, we recommend explicitly declaring this parameter with the
-    #   intended major engine version.
+    #   The version number of the database engine to use. The
+    #   `--engine-version` will default to the latest major engine version.
+    #   For production workloads, we recommend explicitly declaring this
+    #   parameter with the intended major engine version.
     #
     # @option params [Integer] :port
     #   The port number on which the instances in the cluster accept
     #   connections.
     #
-    # @option params [required, String] :master_username
+    # @option params [String] :master_username
     #   The name of the master user for the cluster.
     #
     #   Constraints:
@@ -729,7 +785,7 @@ module Aws::DocDB
     #
     #   * Cannot be a reserved word for the chosen database engine.
     #
-    # @option params [required, String] :master_user_password
+    # @option params [String] :master_user_password
     #   The password for the master database user. This password can contain
     #   any printable ASCII character except forward slash (/), double quote
     #   ("), or the "at" symbol (@).
@@ -742,7 +798,7 @@ module Aws::DocDB
     #   parameter.
     #
     #   The default is a 30-minute window selected at random from an 8-hour
-    #   block of time for each AWS Region.
+    #   block of time for each Region.
     #
     #   Constraints:
     #
@@ -761,8 +817,7 @@ module Aws::DocDB
     #   Format: `ddd:hh24:mi-ddd:hh24:mi`
     #
     #   The default is a 30-minute window selected at random from an 8-hour
-    #   block of time for each AWS Region, occurring on a random day of the
-    #   week.
+    #   block of time for each Region, occurring on a random day of the week.
     #
     #   Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
     #
@@ -775,13 +830,13 @@ module Aws::DocDB
     #   Specifies whether the cluster is encrypted.
     #
     # @option params [String] :kms_key_id
-    #   The AWS KMS key identifier for an encrypted cluster.
+    #   The KMS key identifier for an encrypted cluster.
     #
-    #   The AWS KMS key identifier is the Amazon Resource Name (ARN) for the
-    #   AWS KMS encryption key. If you are creating a cluster using the same
-    #   AWS account that owns the AWS KMS encryption key that is used to
-    #   encrypt the new cluster, you can use the AWS KMS key alias instead of
-    #   the ARN for the AWS KMS encryption key.
+    #   The KMS key identifier is the Amazon Resource Name (ARN) for the KMS
+    #   encryption key. If you are creating a cluster using the same account
+    #   that owns the KMS encryption key that is used to encrypt the new
+    #   cluster, you can use the KMS key alias instead of the ARN for the KMS
+    #   encryption key.
     #
     #   If an encryption key is not specified in `KmsKeyId`\:
     #
@@ -790,9 +845,8 @@ module Aws::DocDB
     #
     #   ^
     #
-    #   AWS KMS creates the default encryption key for your AWS account. Your
-    #   AWS account has a different default encryption key for each AWS
-    #   Region.
+    #   KMS creates the default encryption key for your account. Your account
+    #   has a different default encryption key for each Regions.
     #
     # @option params [String] :pre_signed_url
     #   Not currently supported.
@@ -814,6 +868,9 @@ module Aws::DocDB
     #   `DeletionProtection` is disabled. `DeletionProtection` protects
     #   clusters from being accidentally deleted.
     #
+    # @option params [String] :global_cluster_identifier
+    #   The cluster identifier of the new global cluster.
+    #
     # @option params [String] :source_region
     #   The source region of the snapshot. This is only needed when the
     #   shapshot is encrypted and in a different region.
@@ -834,8 +891,8 @@ module Aws::DocDB
     #     engine: "String", # required
     #     engine_version: "String",
     #     port: 1,
-    #     master_username: "String", # required
-    #     master_user_password: "String", # required
+    #     master_username: "String",
+    #     master_user_password: "String",
     #     preferred_backup_window: "String",
     #     preferred_maintenance_window: "String",
     #     tags: [
@@ -849,6 +906,7 @@ module Aws::DocDB
     #     pre_signed_url: "String",
     #     enable_cloudwatch_logs_exports: ["String"],
     #     deletion_protection: false,
+    #     global_cluster_identifier: "GlobalClusterIdentifier",
     #     source_region: "String",
     #   })
     #
@@ -873,6 +931,9 @@ module Aws::DocDB
     #   resp.db_cluster.master_username #=> String
     #   resp.db_cluster.preferred_backup_window #=> String
     #   resp.db_cluster.preferred_maintenance_window #=> String
+    #   resp.db_cluster.replication_source_identifier #=> String
+    #   resp.db_cluster.read_replica_identifiers #=> Array
+    #   resp.db_cluster.read_replica_identifiers[0] #=> String
     #   resp.db_cluster.db_cluster_members #=> Array
     #   resp.db_cluster.db_cluster_members[0].db_instance_identifier #=> String
     #   resp.db_cluster.db_cluster_members[0].is_cluster_writer #=> Boolean
@@ -1090,7 +1151,7 @@ module Aws::DocDB
     #   The Amazon EC2 Availability Zone that the instance is created in.
     #
     #   Default: A random, system-chosen Availability Zone in the endpoint's
-    #   AWS Region.
+    #   Region.
     #
     #   Example: `us-east-1d`
     #
@@ -1101,18 +1162,17 @@ module Aws::DocDB
     #   Format: `ddd:hh24:mi-ddd:hh24:mi`
     #
     #   The default is a 30-minute window selected at random from an 8-hour
-    #   block of time for each AWS Region, occurring on a random day of the
-    #   week.
+    #   block of time for each Region, occurring on a random day of the week.
     #
     #   Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
     #
     #   Constraints: Minimum 30-minute window.
     #
     # @option params [Boolean] :auto_minor_version_upgrade
-    #   Indicates that minor engine upgrades are applied automatically to the
-    #   instance during the maintenance window.
+    #   This parameter does not apply to Amazon DocumentDB. Amazon DocumentDB
+    #   does not perform minor version upgrades regardless of the value set.
     #
-    #   Default: `true`
+    #   Default: `false`
     #
     # @option params [Array<Types::Tag>] :tags
     #   The tags to be assigned to the instance. You can assign up to 10 tags
@@ -1225,7 +1285,7 @@ module Aws::DocDB
     end
 
     # Creates a new subnet group. subnet groups must contain at least one
-    # subnet in at least two Availability Zones in the AWS Region.
+    # subnet in at least two Availability Zones in the Region.
     #
     # @option params [required, String] :db_subnet_group_name
     #   The name for the subnet group. This value is stored as a lowercase
@@ -1284,6 +1344,214 @@ module Aws::DocDB
       req.send_request(options)
     end
 
+    # Creates 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.
+    #
+    # @option params [required, String] :subscription_name
+    #   The name of the subscription.
+    #
+    #   Constraints: The name must be fewer than 255 characters.
+    #
+    # @option params [required, String] :sns_topic_arn
+    #   The Amazon Resource Name (ARN) of the SNS topic created for event
+    #   notification. Amazon SNS creates the ARN when you create a topic and
+    #   subscribe to it.
+    #
+    # @option params [String] :source_type
+    #   The type of source that is generating the events. For example, if you
+    #   want to be notified of events generated by an instance, you would set
+    #   this parameter to `db-instance`. If this value is not specified, all
+    #   events are returned.
+    #
+    #   Valid values: `db-instance`, `db-cluster`, `db-parameter-group`,
+    #   `db-security-group`, `db-cluster-snapshot`
+    #
+    # @option params [Array<String>] :event_categories
+    #   A list of event categories for a `SourceType` that you want to
+    #   subscribe to.
+    #
+    # @option params [Array<String>] :source_ids
+    #   The list of identifiers of the event sources for which events are
+    #   returned. If not specified, then all sources are included in the
+    #   response. An identifier must begin with a letter and must contain only
+    #   ASCII letters, digits, and hyphens; it can't end with a hyphen or
+    #   contain two consecutive hyphens.
+    #
+    #   Constraints:
+    #
+    #   * If `SourceIds` are provided, `SourceType` must also be provided.
+    #
+    #   * If the source type is an instance, a `DBInstanceIdentifier` must be
+    #     provided.
+    #
+    #   * If the source type is a security group, a `DBSecurityGroupName` must
+    #     be provided.
+    #
+    #   * If the source type is a parameter group, a `DBParameterGroupName`
+    #     must be provided.
+    #
+    #   * If the source type is a snapshot, a `DBSnapshotIdentifier` must be
+    #     provided.
+    #
+    # @option params [Boolean] :enabled
+    #   A Boolean value; set to `true` to activate the subscription, set to
+    #   `false` to create the subscription but not active it.
+    #
+    # @option params [Array<Types::Tag>] :tags
+    #   The tags to be assigned to the event subscription.
+    #
+    # @return [Types::CreateEventSubscriptionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateEventSubscriptionResult#event_subscription #event_subscription} => Types::EventSubscription
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_event_subscription({
+    #     subscription_name: "String", # required
+    #     sns_topic_arn: "String", # required
+    #     source_type: "String",
+    #     event_categories: ["String"],
+    #     source_ids: ["String"],
+    #     enabled: false,
+    #     tags: [
+    #       {
+    #         key: "String",
+    #         value: "String",
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.event_subscription.customer_aws_id #=> String
+    #   resp.event_subscription.cust_subscription_id #=> String
+    #   resp.event_subscription.sns_topic_arn #=> String
+    #   resp.event_subscription.status #=> String
+    #   resp.event_subscription.subscription_creation_time #=> String
+    #   resp.event_subscription.source_type #=> String
+    #   resp.event_subscription.source_ids_list #=> Array
+    #   resp.event_subscription.source_ids_list[0] #=> String
+    #   resp.event_subscription.event_categories_list #=> Array
+    #   resp.event_subscription.event_categories_list[0] #=> String
+    #   resp.event_subscription.enabled #=> Boolean
+    #   resp.event_subscription.event_subscription_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/CreateEventSubscription AWS API Documentation
+    #
+    # @overload create_event_subscription(params = {})
+    # @param [Hash] params ({})
+    def create_event_subscription(params = {}, options = {})
+      req = build_request(:create_event_subscription, params)
+      req.send_request(options)
+    end
+
+    # Creates an Amazon DocumentDB global cluster that can span multiple
+    # multiple Regions. The global cluster contains one primary cluster with
+    # read-write capability, and up-to give read-only secondary clusters.
+    # Global clusters uses storage-based fast replication across regions
+    # with latencies less than one second, using dedicated infrastructure
+    # with no impact to your workload’s performance.
+    #
+    #
+    #
+    # You can create a global cluster that is initially empty, and then add
+    # a primary and a secondary to it. Or you can specify an existing
+    # cluster during the create operation, and this cluster becomes the
+    # primary of the global cluster.
+    #
+    # <note markdown="1"> This action only applies to Amazon DocumentDB clusters.
+    #
+    #  </note>
+    #
+    # @option params [required, String] :global_cluster_identifier
+    #   The cluster identifier of the new global cluster.
+    #
+    # @option params [String] :source_db_cluster_identifier
+    #   The Amazon Resource Name (ARN) to use as the primary cluster of the
+    #   global cluster. This parameter is optional.
+    #
+    # @option params [String] :engine
+    #   The name of the database engine to be used for this cluster.
+    #
+    # @option params [String] :engine_version
+    #   The engine version of the global cluster.
+    #
+    # @option params [Boolean] :deletion_protection
+    #   The deletion protection setting for the new global cluster. The global
+    #   cluster can't be deleted when deletion protection is enabled.
+    #
+    # @option params [String] :database_name
+    #   The name for your database of up to 64 alpha-numeric characters. If
+    #   you do not provide a name, Amazon DocumentDB will not create a
+    #   database in the global cluster you are creating.
+    #
+    # @option params [Boolean] :storage_encrypted
+    #   The storage encryption setting for the new global cluster.
+    #
+    # @return [Types::CreateGlobalClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateGlobalClusterResult#global_cluster #global_cluster} => Types::GlobalCluster
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_global_cluster({
+    #     global_cluster_identifier: "GlobalClusterIdentifier", # required
+    #     source_db_cluster_identifier: "String",
+    #     engine: "String",
+    #     engine_version: "String",
+    #     deletion_protection: false,
+    #     database_name: "String",
+    #     storage_encrypted: false,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.global_cluster.global_cluster_identifier #=> String
+    #   resp.global_cluster.global_cluster_resource_id #=> String
+    #   resp.global_cluster.global_cluster_arn #=> String
+    #   resp.global_cluster.status #=> String
+    #   resp.global_cluster.engine #=> String
+    #   resp.global_cluster.engine_version #=> String
+    #   resp.global_cluster.database_name #=> String
+    #   resp.global_cluster.storage_encrypted #=> Boolean
+    #   resp.global_cluster.deletion_protection #=> Boolean
+    #   resp.global_cluster.global_cluster_members #=> Array
+    #   resp.global_cluster.global_cluster_members[0].db_cluster_arn #=> String
+    #   resp.global_cluster.global_cluster_members[0].readers #=> Array
+    #   resp.global_cluster.global_cluster_members[0].readers[0] #=> String
+    #   resp.global_cluster.global_cluster_members[0].is_writer #=> Boolean
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/CreateGlobalCluster AWS API Documentation
+    #
+    # @overload create_global_cluster(params = {})
+    # @param [Hash] params ({})
+    def create_global_cluster(params = {}, options = {})
+      req = build_request(:create_global_cluster, params)
+      req.send_request(options)
+    end
+
     # Deletes a previously provisioned cluster. When you delete a cluster,
     # all automated backups for that cluster are deleted and can't be
     # recovered. Manual DB cluster snapshots of the specified cluster are
@@ -1362,6 +1630,9 @@ module Aws::DocDB
     #   resp.db_cluster.master_username #=> String
     #   resp.db_cluster.preferred_backup_window #=> String
     #   resp.db_cluster.preferred_maintenance_window #=> String
+    #   resp.db_cluster.replication_source_identifier #=> String
+    #   resp.db_cluster.read_replica_identifiers #=> Array
+    #   resp.db_cluster.read_replica_identifiers[0] #=> String
     #   resp.db_cluster.db_cluster_members #=> Array
     #   resp.db_cluster.db_cluster_members[0].db_instance_identifier #=> String
     #   resp.db_cluster.db_cluster_members[0].is_cluster_writer #=> Boolean
@@ -1607,8 +1878,95 @@ module Aws::DocDB
       req.send_request(options)
     end
 
+    # Deletes an Amazon DocumentDB event notification subscription.
+    #
+    # @option params [required, String] :subscription_name
+    #   The name of the Amazon DocumentDB event notification subscription that
+    #   you want to delete.
+    #
+    # @return [Types::DeleteEventSubscriptionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DeleteEventSubscriptionResult#event_subscription #event_subscription} => Types::EventSubscription
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_event_subscription({
+    #     subscription_name: "String", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.event_subscription.customer_aws_id #=> String
+    #   resp.event_subscription.cust_subscription_id #=> String
+    #   resp.event_subscription.sns_topic_arn #=> String
+    #   resp.event_subscription.status #=> String
+    #   resp.event_subscription.subscription_creation_time #=> String
+    #   resp.event_subscription.source_type #=> String
+    #   resp.event_subscription.source_ids_list #=> Array
+    #   resp.event_subscription.source_ids_list[0] #=> String
+    #   resp.event_subscription.event_categories_list #=> Array
+    #   resp.event_subscription.event_categories_list[0] #=> String
+    #   resp.event_subscription.enabled #=> Boolean
+    #   resp.event_subscription.event_subscription_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/DeleteEventSubscription AWS API Documentation
+    #
+    # @overload delete_event_subscription(params = {})
+    # @param [Hash] params ({})
+    def delete_event_subscription(params = {}, options = {})
+      req = build_request(:delete_event_subscription, params)
+      req.send_request(options)
+    end
+
+    # Deletes a global cluster. The primary and secondary clusters must
+    # already be detached or deleted before attempting to delete a global
+    # cluster.
+    #
+    # <note markdown="1"> This action only applies to Amazon DocumentDB clusters.
+    #
+    #  </note>
+    #
+    # @option params [required, String] :global_cluster_identifier
+    #   The cluster identifier of the global cluster being deleted.
+    #
+    # @return [Types::DeleteGlobalClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DeleteGlobalClusterResult#global_cluster #global_cluster} => Types::GlobalCluster
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_global_cluster({
+    #     global_cluster_identifier: "GlobalClusterIdentifier", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.global_cluster.global_cluster_identifier #=> String
+    #   resp.global_cluster.global_cluster_resource_id #=> String
+    #   resp.global_cluster.global_cluster_arn #=> String
+    #   resp.global_cluster.status #=> String
+    #   resp.global_cluster.engine #=> String
+    #   resp.global_cluster.engine_version #=> String
+    #   resp.global_cluster.database_name #=> String
+    #   resp.global_cluster.storage_encrypted #=> Boolean
+    #   resp.global_cluster.deletion_protection #=> Boolean
+    #   resp.global_cluster.global_cluster_members #=> Array
+    #   resp.global_cluster.global_cluster_members[0].db_cluster_arn #=> String
+    #   resp.global_cluster.global_cluster_members[0].readers #=> Array
+    #   resp.global_cluster.global_cluster_members[0].readers[0] #=> String
+    #   resp.global_cluster.global_cluster_members[0].is_writer #=> Boolean
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/DeleteGlobalCluster AWS API Documentation
+    #
+    # @overload delete_global_cluster(params = {})
+    # @param [Hash] params ({})
+    def delete_global_cluster(params = {}, options = {})
+      req = build_request(:delete_global_cluster, params)
+      req.send_request(options)
+    end
+
     # Returns a list of certificate authority (CA) certificates provided by
-    # Amazon DocumentDB for this AWS account.
+    # Amazon DocumentDB for this account.
     #
     # @option params [String] :certificate_identifier
     #   The user-supplied certificate identifier. If this parameter is
@@ -1843,12 +2201,12 @@ module Aws::DocDB
     # Returns a list of cluster snapshot attribute names and values for a
     # manual DB cluster snapshot.
     #
-    # When you share snapshots with other AWS accounts,
+    # When you share snapshots with other accounts,
     # `DescribeDBClusterSnapshotAttributes` returns the `restore` attribute
-    # and a list of IDs for the AWS accounts that are authorized to copy or
+    # and a list of IDs for the accounts that are authorized to copy or
     # restore the manual cluster snapshot. If `all` is included in the list
     # of values for the `restore` attribute, then the manual cluster
-    # snapshot is public and can be copied or restored by all AWS accounts.
+    # snapshot is public and can be copied or restored by all accounts.
     #
     # @option params [required, String] :db_cluster_snapshot_identifier
     #   The identifier for the cluster snapshot to describe the attributes
@@ -1913,13 +2271,13 @@ module Aws::DocDB
     #   the following values:
     #
     #   * `automated` - Return all cluster snapshots that Amazon DocumentDB
-    #     has automatically created for your AWS account.
+    #     has automatically created for your account.
     #
     #   * `manual` - Return all cluster snapshots that you have manually
-    #     created for your AWS account.
+    #     created for your account.
     #
     #   * `shared` - Return all manual cluster snapshots that have been shared
-    #     to your AWS account.
+    #     to your account.
     #
     #   * `public` - Return all cluster snapshots that have been marked as
     #     public.
@@ -1928,7 +2286,7 @@ module Aws::DocDB
     #   manual cluster snapshots are returned. You can include shared cluster
     #   snapshots with these results by setting the `IncludeShared` parameter
     #   to `true`. You can include public cluster snapshots with these results
-    #   by setting the `IncludePublic` parameter to `true`.
+    #   by setting the`IncludePublic` parameter to `true`.
     #
     #   The `IncludeShared` and `IncludePublic` parameters don't apply for
     #   `SnapshotType` values of `manual` or `automated`. The `IncludePublic`
@@ -1956,13 +2314,13 @@ module Aws::DocDB
     #
     # @option params [Boolean] :include_shared
     #   Set to `true` to include shared manual cluster snapshots from other
-    #   AWS accounts that this AWS account has been given permission to copy
-    #   or restore, and otherwise `false`. The default is `false`.
+    #   accounts that this account has been given permission to copy or
+    #   restore, and otherwise `false`. The default is `false`.
     #
     # @option params [Boolean] :include_public
     #   Set to `true` to include manual cluster snapshots that are public and
-    #   can be copied or restored by any AWS account, and otherwise `false`.
-    #   The default is `false`.
+    #   can be copied or restored by any account, and otherwise `false`. The
+    #   default is `false`.
     #
     # @return [Types::DBClusterSnapshotMessage] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2109,6 +2467,9 @@ module Aws::DocDB
     #   resp.db_clusters[0].master_username #=> String
     #   resp.db_clusters[0].preferred_backup_window #=> String
     #   resp.db_clusters[0].preferred_maintenance_window #=> String
+    #   resp.db_clusters[0].replication_source_identifier #=> String
+    #   resp.db_clusters[0].read_replica_identifiers #=> Array
+    #   resp.db_clusters[0].read_replica_identifiers[0] #=> String
     #   resp.db_clusters[0].db_cluster_members #=> Array
     #   resp.db_clusters[0].db_cluster_members[0].db_instance_identifier #=> String
     #   resp.db_clusters[0].db_cluster_members[0].is_cluster_writer #=> Boolean
@@ -2530,8 +2891,7 @@ module Aws::DocDB
     # @option params [String] :source_type
     #   The type of source that is generating the events.
     #
-    #   Valid values: `db-instance`, `db-parameter-group`,
-    #   `db-security-group`, `db-snapshot`
+    #   Valid values: `db-instance`, `db-parameter-group`, `db-security-group`
     #
     # @option params [Array<Types::Filter>] :filters
     #   This parameter is not currently supported.
@@ -2568,6 +2928,83 @@ module Aws::DocDB
       req.send_request(options)
     end
 
+    # Lists all the subscription descriptions for a customer account. The
+    # description for a subscription includes `SubscriptionName`,
+    # `SNSTopicARN`, `CustomerID`, `SourceType`, `SourceID`, `CreationTime`,
+    # and `Status`.
+    #
+    # If you specify a `SubscriptionName`, lists the description for that
+    # subscription.
+    #
+    # @option params [String] :subscription_name
+    #   The name of the Amazon DocumentDB event notification subscription that
+    #   you want to describe.
+    #
+    # @option params [Array<Types::Filter>] :filters
+    #   This parameter is not currently supported.
+    #
+    # @option params [Integer] :max_records
+    #   The maximum number of records to include in the response. If more
+    #   records exist than the specified `MaxRecords` value, a pagination
+    #   token (marker) is included in the response so that the remaining
+    #   results can be retrieved.
+    #
+    #   Default: 100
+    #
+    #   Constraints: Minimum 20, maximum 100.
+    #
+    # @option params [String] :marker
+    #   An optional pagination token provided by a previous request. If this
+    #   parameter is specified, the response includes only records beyond the
+    #   marker, up to the value specified by `MaxRecords`.
+    #
+    # @return [Types::EventSubscriptionsMessage] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::EventSubscriptionsMessage#marker #marker} => String
+    #   * {Types::EventSubscriptionsMessage#event_subscriptions_list #event_subscriptions_list} => Array&lt;Types::EventSubscription&gt;
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_event_subscriptions({
+    #     subscription_name: "String",
+    #     filters: [
+    #       {
+    #         name: "String", # required
+    #         values: ["String"], # required
+    #       },
+    #     ],
+    #     max_records: 1,
+    #     marker: "String",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.marker #=> String
+    #   resp.event_subscriptions_list #=> Array
+    #   resp.event_subscriptions_list[0].customer_aws_id #=> String
+    #   resp.event_subscriptions_list[0].cust_subscription_id #=> String
+    #   resp.event_subscriptions_list[0].sns_topic_arn #=> String
+    #   resp.event_subscriptions_list[0].status #=> String
+    #   resp.event_subscriptions_list[0].subscription_creation_time #=> String
+    #   resp.event_subscriptions_list[0].source_type #=> String
+    #   resp.event_subscriptions_list[0].source_ids_list #=> Array
+    #   resp.event_subscriptions_list[0].source_ids_list[0] #=> String
+    #   resp.event_subscriptions_list[0].event_categories_list #=> Array
+    #   resp.event_subscriptions_list[0].event_categories_list[0] #=> String
+    #   resp.event_subscriptions_list[0].enabled #=> Boolean
+    #   resp.event_subscriptions_list[0].event_subscription_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/DescribeEventSubscriptions AWS API Documentation
+    #
+    # @overload describe_event_subscriptions(params = {})
+    # @param [Hash] params ({})
+    def describe_event_subscriptions(params = {}, options = {})
+      req = build_request(:describe_event_subscriptions, params)
+      req.send_request(options)
+    end
+
     # Returns events related to instances, security groups, snapshots, and
     # DB parameter groups for the past 14 days. You can obtain events
     # specific to a particular DB instance, security group, snapshot, or
@@ -2687,6 +3124,86 @@ module Aws::DocDB
       req.send_request(options)
     end
 
+    # Returns information about Amazon DocumentDB global clusters. This API
+    # supports pagination.
+    #
+    # <note markdown="1"> This action only applies to Amazon DocumentDB clusters.
+    #
+    #  </note>
+    #
+    # @option params [String] :global_cluster_identifier
+    #   The user-supplied cluster identifier. If this parameter is specified,
+    #   information from only the specific cluster is returned. This parameter
+    #   isn't case-sensitive.
+    #
+    # @option params [Array<Types::Filter>] :filters
+    #   A filter that specifies one or more global DB clusters to describe.
+    #
+    #   Supported filters: `db-cluster-id` accepts cluster identifiers and
+    #   cluster Amazon Resource Names (ARNs). The results list will only
+    #   include information about the clusters identified by these ARNs.
+    #
+    # @option params [Integer] :max_records
+    #   The maximum number of records to include in the response. If more
+    #   records exist than the specified `MaxRecords` value, a pagination
+    #   token called a marker is included in the response so that you can
+    #   retrieve the remaining results.
+    #
+    # @option params [String] :marker
+    #   An optional pagination token provided by a previous
+    #   `DescribeGlobalClusters` request. If this parameter is specified, the
+    #   response includes only records beyond the marker, up to the value
+    #   specified by `MaxRecords`.
+    #
+    # @return [Types::GlobalClustersMessage] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GlobalClustersMessage#marker #marker} => String
+    #   * {Types::GlobalClustersMessage#global_clusters #global_clusters} => Array&lt;Types::GlobalCluster&gt;
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_global_clusters({
+    #     global_cluster_identifier: "GlobalClusterIdentifier",
+    #     filters: [
+    #       {
+    #         name: "String", # required
+    #         values: ["String"], # required
+    #       },
+    #     ],
+    #     max_records: 1,
+    #     marker: "String",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.marker #=> String
+    #   resp.global_clusters #=> Array
+    #   resp.global_clusters[0].global_cluster_identifier #=> String
+    #   resp.global_clusters[0].global_cluster_resource_id #=> String
+    #   resp.global_clusters[0].global_cluster_arn #=> String
+    #   resp.global_clusters[0].status #=> String
+    #   resp.global_clusters[0].engine #=> String
+    #   resp.global_clusters[0].engine_version #=> String
+    #   resp.global_clusters[0].database_name #=> String
+    #   resp.global_clusters[0].storage_encrypted #=> Boolean
+    #   resp.global_clusters[0].deletion_protection #=> Boolean
+    #   resp.global_clusters[0].global_cluster_members #=> Array
+    #   resp.global_clusters[0].global_cluster_members[0].db_cluster_arn #=> String
+    #   resp.global_clusters[0].global_cluster_members[0].readers #=> Array
+    #   resp.global_clusters[0].global_cluster_members[0].readers[0] #=> String
+    #   resp.global_clusters[0].global_cluster_members[0].is_writer #=> Boolean
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/DescribeGlobalClusters AWS API Documentation
+    #
+    # @overload describe_global_clusters(params = {})
+    # @param [Hash] params ({})
+    def describe_global_clusters(params = {}, options = {})
+      req = build_request(:describe_global_clusters, params)
+      req.send_request(options)
+    end
+
     # Returns a list of orderable instance options for the specified engine.
     #
     # @option params [required, String] :engine
@@ -2909,6 +3426,9 @@ module Aws::DocDB
     #   resp.db_cluster.master_username #=> String
     #   resp.db_cluster.preferred_backup_window #=> String
     #   resp.db_cluster.preferred_maintenance_window #=> String
+    #   resp.db_cluster.replication_source_identifier #=> String
+    #   resp.db_cluster.read_replica_identifiers #=> Array
+    #   resp.db_cluster.read_replica_identifiers[0] #=> String
     #   resp.db_cluster.db_cluster_members #=> Array
     #   resp.db_cluster.db_cluster_members[0].db_instance_identifier #=> String
     #   resp.db_cluster.db_cluster_members[0].is_cluster_writer #=> Boolean
@@ -3063,7 +3583,7 @@ module Aws::DocDB
     #   parameter.
     #
     #   The default is a 30-minute window selected at random from an 8-hour
-    #   block of time for each AWS Region.
+    #   block of time for each Region.
     #
     #   Constraints:
     #
@@ -3082,8 +3602,7 @@ module Aws::DocDB
     #   Format: `ddd:hh24:mi-ddd:hh24:mi`
     #
     #   The default is a 30-minute window selected at random from an 8-hour
-    #   block of time for each AWS Region, occurring on a random day of the
-    #   week.
+    #   block of time for each Region, occurring on a random day of the week.
     #
     #   Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
     #
@@ -3097,9 +3616,8 @@ module Aws::DocDB
     #
     # @option params [String] :engine_version
     #   The version number of the database engine to which you want to
-    #   upgrade. Changing this parameter results in an outage. The change is
-    #   applied during the next maintenance window unless the
-    #   `ApplyImmediately` parameter is set to `true`.
+    #   upgrade. Modifying engine version is not supported on Amazon
+    #   DocumentDB.
     #
     # @option params [Boolean] :deletion_protection
     #   Specifies whether this cluster can be deleted. If `DeletionProtection`
@@ -3153,6 +3671,9 @@ module Aws::DocDB
     #   resp.db_cluster.master_username #=> String
     #   resp.db_cluster.preferred_backup_window #=> String
     #   resp.db_cluster.preferred_maintenance_window #=> String
+    #   resp.db_cluster.replication_source_identifier #=> String
+    #   resp.db_cluster.read_replica_identifiers #=> Array
+    #   resp.db_cluster.read_replica_identifiers[0] #=> String
     #   resp.db_cluster.db_cluster_members #=> Array
     #   resp.db_cluster.db_cluster_members[0].db_instance_identifier #=> String
     #   resp.db_cluster.db_cluster_members[0].is_cluster_writer #=> Boolean
@@ -3247,19 +3768,19 @@ module Aws::DocDB
     end
 
     # Adds an attribute and values to, or removes an attribute and values
-    # from, a manual DB cluster snapshot.
+    # from, a manual cluster snapshot.
     #
-    # To share a manual cluster snapshot with other AWS accounts, specify
+    # To share a manual cluster snapshot with other accounts, specify
     # `restore` as the `AttributeName`, and use the `ValuesToAdd` parameter
-    # to add a list of IDs of the AWS accounts that are authorized to
-    # restore the manual cluster snapshot. Use the value `all` to make the
-    # manual cluster snapshot public, which means that it can be copied or
-    # restored by all AWS accounts. Do not add the `all` value for any
-    # manual DB cluster snapshots that contain private information that you
-    # don't want available to all AWS accounts. If a manual cluster
-    # snapshot is encrypted, it can be shared, but only by specifying a list
-    # of authorized AWS account IDs for the `ValuesToAdd` parameter. You
-    # can't use `all` as a value for that parameter in this case.
+    # to add a list of IDs of the accounts that are authorized to restore
+    # the manual cluster snapshot. Use the value `all` to make the manual
+    # cluster snapshot public, which means that it can be copied or restored
+    # by all accounts. Do not add the `all` value for any manual cluster
+    # snapshots that contain private information that you don't want
+    # available to all accounts. If a manual cluster snapshot is encrypted,
+    # it can be shared, but only by specifying a list of authorized account
+    # IDs for the `ValuesToAdd` parameter. You can't use `all` as a value
+    # for that parameter in this case.
     #
     # @option params [required, String] :db_cluster_snapshot_identifier
     #   The identifier for the cluster snapshot to modify the attributes for.
@@ -3267,31 +3788,30 @@ module Aws::DocDB
     # @option params [required, String] :attribute_name
     #   The name of the cluster snapshot attribute to modify.
     #
-    #   To manage authorization for other AWS accounts to copy or restore a
-    #   manual cluster snapshot, set this value to `restore`.
+    #   To manage authorization for other accounts to copy or restore a manual
+    #   cluster snapshot, set this value to `restore`.
     #
     # @option params [Array<String>] :values_to_add
     #   A list of cluster snapshot attributes to add to the attribute
     #   specified by `AttributeName`.
     #
-    #   To authorize other AWS accounts to copy or restore a manual cluster
-    #   snapshot, set this list to include one or more AWS account IDs. To
-    #   make the manual cluster snapshot restorable by any AWS account, set it
-    #   to `all`. Do not add the `all` value for any manual cluster snapshots
+    #   To authorize other accounts to copy or restore a manual cluster
+    #   snapshot, set this list to include one or more account IDs. To make
+    #   the manual cluster snapshot restorable by any account, set it to
+    #   `all`. Do not add the `all` value for any manual cluster snapshots
     #   that contain private information that you don't want to be available
-    #   to all AWS accounts.
+    #   to all accounts.
     #
     # @option params [Array<String>] :values_to_remove
     #   A list of cluster snapshot attributes to remove from the attribute
     #   specified by `AttributeName`.
     #
-    #   To remove authorization for other AWS accounts to copy or restore a
-    #   manual cluster snapshot, set this list to include one or more AWS
-    #   account identifiers. To remove authorization for any AWS account to
-    #   copy or restore the cluster snapshot, set it to `all` . If you specify
-    #   `all`, an AWS account whose account ID is explicitly added to the
-    #   `restore` attribute can still copy or restore a manual cluster
-    #   snapshot.
+    #   To remove authorization for other accounts to copy or restore a manual
+    #   cluster snapshot, set this list to include one or more account
+    #   identifiers. To remove authorization for any account to copy or
+    #   restore the cluster snapshot, set it to `all` . If you specify `all`,
+    #   an account whose account ID is explicitly added to the `restore`
+    #   attribute can still copy or restore a manual cluster snapshot.
     #
     # @return [Types::ModifyDBClusterSnapshotAttributeResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3338,8 +3858,7 @@ module Aws::DocDB
     #
     # @option params [String] :db_instance_class
     #   The new compute and memory capacity of the instance; for example,
-    #   `db.r5.large`. Not all instance classes are available in all AWS
-    #   Regions.
+    #   `db.r5.large`. Not all instance classes are available in all Regions.
     #
     #   If you modify the instance class, an outage occurs during the change.
     #   The change is applied during the next maintenance window, unless
@@ -3379,13 +3898,8 @@ module Aws::DocDB
     #   Constraints: Must be at least 30 minutes.
     #
     # @option params [Boolean] :auto_minor_version_upgrade
-    #   Indicates that minor version upgrades are applied automatically to the
-    #   instance during the maintenance window. Changing this parameter
-    #   doesn't result in an outage except in the following case, and the
-    #   change is asynchronously applied as soon as possible. An outage
-    #   results if this parameter is set to `true` during the maintenance
-    #   window, and a newer minor version is available, and Amazon DocumentDB
-    #   has enabled automatic patching for that engine version.
+    #   This parameter does not apply to Amazon DocumentDB. Amazon DocumentDB
+    #   does not perform minor version upgrades regardless of the value set.
     #
     # @option params [String] :new_db_instance_identifier
     #   The new instance identifier for the instance when renaming an
@@ -3506,7 +4020,7 @@ module Aws::DocDB
     end
 
     # Modifies an existing subnet group. subnet groups must contain at least
-    # one subnet in at least two Availability Zones in the AWS Region.
+    # one subnet in at least two Availability Zones in the Region.
     #
     # @option params [required, String] :db_subnet_group_name
     #   The name for the subnet group. This value is stored as a lowercase
@@ -3556,6 +4070,143 @@ module Aws::DocDB
       req.send_request(options)
     end
 
+    # Modifies an existing Amazon DocumentDB event notification
+    # subscription.
+    #
+    # @option params [required, String] :subscription_name
+    #   The name of the Amazon DocumentDB event notification subscription.
+    #
+    # @option params [String] :sns_topic_arn
+    #   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.
+    #
+    # @option params [String] :source_type
+    #   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`
+    #
+    # @option params [Array<String>] :event_categories
+    #   A list of event categories for a `SourceType` that you want to
+    #   subscribe to.
+    #
+    # @option params [Boolean] :enabled
+    #   A Boolean value; set to `true` to activate the subscription.
+    #
+    # @return [Types::ModifyEventSubscriptionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ModifyEventSubscriptionResult#event_subscription #event_subscription} => Types::EventSubscription
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.modify_event_subscription({
+    #     subscription_name: "String", # required
+    #     sns_topic_arn: "String",
+    #     source_type: "String",
+    #     event_categories: ["String"],
+    #     enabled: false,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.event_subscription.customer_aws_id #=> String
+    #   resp.event_subscription.cust_subscription_id #=> String
+    #   resp.event_subscription.sns_topic_arn #=> String
+    #   resp.event_subscription.status #=> String
+    #   resp.event_subscription.subscription_creation_time #=> String
+    #   resp.event_subscription.source_type #=> String
+    #   resp.event_subscription.source_ids_list #=> Array
+    #   resp.event_subscription.source_ids_list[0] #=> String
+    #   resp.event_subscription.event_categories_list #=> Array
+    #   resp.event_subscription.event_categories_list[0] #=> String
+    #   resp.event_subscription.enabled #=> Boolean
+    #   resp.event_subscription.event_subscription_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/ModifyEventSubscription AWS API Documentation
+    #
+    # @overload modify_event_subscription(params = {})
+    # @param [Hash] params ({})
+    def modify_event_subscription(params = {}, options = {})
+      req = build_request(:modify_event_subscription, params)
+      req.send_request(options)
+    end
+
+    # Modify a setting for an Amazon DocumentDB global cluster. You can
+    # change one or more configuration parameters (for example: deletion
+    # protection), or the global cluster identifier by specifying these
+    # parameters and the new values in the request.
+    #
+    # <note markdown="1"> This action only applies to Amazon DocumentDB clusters.
+    #
+    #  </note>
+    #
+    # @option params [required, String] :global_cluster_identifier
+    #   The identifier for the global cluster being modified. This parameter
+    #   isn't case-sensitive.
+    #
+    #   Constraints:
+    #
+    #   * Must match the identifier of an existing global cluster.
+    #
+    #   ^
+    #
+    # @option params [String] :new_global_cluster_identifier
+    #   The new identifier for a global cluster when you modify a global
+    #   cluster. This value is stored as a lowercase string.
+    #
+    #   * Must contain from 1 to 63 letters, numbers, or hyphens
+    #
+    #     The first character must be a letter
+    #
+    #     Can't end with a hyphen or contain two consecutive hyphens
+    #
+    #   Example: `my-cluster2`
+    #
+    # @option params [Boolean] :deletion_protection
+    #   Indicates if the global cluster has deletion protection enabled. The
+    #   global cluster can't be deleted when deletion protection is enabled.
+    #
+    # @return [Types::ModifyGlobalClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ModifyGlobalClusterResult#global_cluster #global_cluster} => Types::GlobalCluster
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.modify_global_cluster({
+    #     global_cluster_identifier: "GlobalClusterIdentifier", # required
+    #     new_global_cluster_identifier: "GlobalClusterIdentifier",
+    #     deletion_protection: false,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.global_cluster.global_cluster_identifier #=> String
+    #   resp.global_cluster.global_cluster_resource_id #=> String
+    #   resp.global_cluster.global_cluster_arn #=> String
+    #   resp.global_cluster.status #=> String
+    #   resp.global_cluster.engine #=> String
+    #   resp.global_cluster.engine_version #=> String
+    #   resp.global_cluster.database_name #=> String
+    #   resp.global_cluster.storage_encrypted #=> Boolean
+    #   resp.global_cluster.deletion_protection #=> Boolean
+    #   resp.global_cluster.global_cluster_members #=> Array
+    #   resp.global_cluster.global_cluster_members[0].db_cluster_arn #=> String
+    #   resp.global_cluster.global_cluster_members[0].readers #=> Array
+    #   resp.global_cluster.global_cluster_members[0].readers[0] #=> String
+    #   resp.global_cluster.global_cluster_members[0].is_writer #=> Boolean
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/ModifyGlobalCluster AWS API Documentation
+    #
+    # @overload modify_global_cluster(params = {})
+    # @param [Hash] params ({})
+    def modify_global_cluster(params = {}, options = {})
+      req = build_request(:modify_global_cluster, params)
+      req.send_request(options)
+    end
+
     # You might need to reboot your instance, usually for maintenance
     # reasons. For example, if you make certain changes, or if you change
     # the cluster parameter group that is associated with the instance, you
@@ -3663,6 +4314,106 @@ module Aws::DocDB
       req.send_request(options)
     end
 
+    # Detaches an Amazon DocumentDB secondary cluster from a global cluster.
+    # The cluster becomes a standalone cluster with read-write capability
+    # instead of being read-only and receiving data from a primary in a
+    # different region.
+    #
+    # <note markdown="1"> This action only applies to Amazon DocumentDB clusters.
+    #
+    #  </note>
+    #
+    # @option params [required, String] :global_cluster_identifier
+    #   The cluster identifier to detach from the Amazon DocumentDB global
+    #   cluster.
+    #
+    # @option params [required, String] :db_cluster_identifier
+    #   The Amazon Resource Name (ARN) identifying the cluster that was
+    #   detached from the Amazon DocumentDB global cluster.
+    #
+    # @return [Types::RemoveFromGlobalClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::RemoveFromGlobalClusterResult#global_cluster #global_cluster} => Types::GlobalCluster
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.remove_from_global_cluster({
+    #     global_cluster_identifier: "GlobalClusterIdentifier", # required
+    #     db_cluster_identifier: "String", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.global_cluster.global_cluster_identifier #=> String
+    #   resp.global_cluster.global_cluster_resource_id #=> String
+    #   resp.global_cluster.global_cluster_arn #=> String
+    #   resp.global_cluster.status #=> String
+    #   resp.global_cluster.engine #=> String
+    #   resp.global_cluster.engine_version #=> String
+    #   resp.global_cluster.database_name #=> String
+    #   resp.global_cluster.storage_encrypted #=> Boolean
+    #   resp.global_cluster.deletion_protection #=> Boolean
+    #   resp.global_cluster.global_cluster_members #=> Array
+    #   resp.global_cluster.global_cluster_members[0].db_cluster_arn #=> String
+    #   resp.global_cluster.global_cluster_members[0].readers #=> Array
+    #   resp.global_cluster.global_cluster_members[0].readers[0] #=> String
+    #   resp.global_cluster.global_cluster_members[0].is_writer #=> Boolean
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/RemoveFromGlobalCluster AWS API Documentation
+    #
+    # @overload remove_from_global_cluster(params = {})
+    # @param [Hash] params ({})
+    def remove_from_global_cluster(params = {}, options = {})
+      req = build_request(:remove_from_global_cluster, params)
+      req.send_request(options)
+    end
+
+    # Removes a source identifier from an existing Amazon DocumentDB event
+    # notification subscription.
+    #
+    # @option params [required, String] :subscription_name
+    #   The name of the Amazon DocumentDB event notification subscription that
+    #   you want to remove a source identifier from.
+    #
+    # @option params [required, String] :source_identifier
+    #   The source identifier to be removed from the subscription, such as the
+    #   instance identifier for an instance, or the name of a security group.
+    #
+    # @return [Types::RemoveSourceIdentifierFromSubscriptionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::RemoveSourceIdentifierFromSubscriptionResult#event_subscription #event_subscription} => Types::EventSubscription
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.remove_source_identifier_from_subscription({
+    #     subscription_name: "String", # required
+    #     source_identifier: "String", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.event_subscription.customer_aws_id #=> String
+    #   resp.event_subscription.cust_subscription_id #=> String
+    #   resp.event_subscription.sns_topic_arn #=> String
+    #   resp.event_subscription.status #=> String
+    #   resp.event_subscription.subscription_creation_time #=> String
+    #   resp.event_subscription.source_type #=> String
+    #   resp.event_subscription.source_ids_list #=> Array
+    #   resp.event_subscription.source_ids_list[0] #=> String
+    #   resp.event_subscription.event_categories_list #=> Array
+    #   resp.event_subscription.event_categories_list[0] #=> String
+    #   resp.event_subscription.enabled #=> Boolean
+    #   resp.event_subscription.event_subscription_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/RemoveSourceIdentifierFromSubscription AWS API Documentation
+    #
+    # @overload remove_source_identifier_from_subscription(params = {})
+    # @param [Hash] params ({})
+    def remove_source_identifier_from_subscription(params = {}, options = {})
+      req = build_request(:remove_source_identifier_from_subscription, params)
+      req.send_request(options)
+    end
+
     # Removes metadata tags from an Amazon DocumentDB resource.
     #
     # @option params [required, String] :resource_name
@@ -3827,21 +4578,21 @@ module Aws::DocDB
     #   The tags to be assigned to the restored cluster.
     #
     # @option params [String] :kms_key_id
-    #   The AWS KMS key identifier to use when restoring an encrypted cluster
-    #   from a DB snapshot or cluster snapshot.
+    #   The KMS key identifier to use when restoring an encrypted cluster from
+    #   a DB snapshot or cluster snapshot.
     #
-    #   The AWS KMS key identifier is the Amazon Resource Name (ARN) for the
-    #   AWS KMS encryption key. If you are restoring a cluster with the same
-    #   AWS account that owns the AWS KMS encryption key used to encrypt the
-    #   new cluster, then you can use the AWS KMS key alias instead of the ARN
-    #   for the AWS KMS encryption key.
+    #   The KMS key identifier is the Amazon Resource Name (ARN) for the KMS
+    #   encryption key. If you are restoring a cluster with the same account
+    #   that owns the KMS encryption key used to encrypt the new cluster, then
+    #   you can use the KMS key alias instead of the ARN for the KMS
+    #   encryption key.
     #
     #   If you do not specify a value for the `KmsKeyId` parameter, then the
     #   following occurs:
     #
     #   * If the snapshot or cluster snapshot in `SnapshotIdentifier` is
-    #     encrypted, then the restored cluster is encrypted using the AWS KMS
-    #     key that was used to encrypt the snapshot or the cluster snapshot.
+    #     encrypted, then the restored cluster is encrypted using the KMS key
+    #     that was used to encrypt the snapshot or the cluster snapshot.
     #
     #   * If the snapshot or the cluster snapshot in `SnapshotIdentifier` is
     #     not encrypted, then the restored DB cluster is not encrypted.
@@ -3903,6 +4654,9 @@ module Aws::DocDB
     #   resp.db_cluster.master_username #=> String
     #   resp.db_cluster.preferred_backup_window #=> String
     #   resp.db_cluster.preferred_maintenance_window #=> String
+    #   resp.db_cluster.replication_source_identifier #=> String
+    #   resp.db_cluster.read_replica_identifiers #=> Array
+    #   resp.db_cluster.read_replica_identifiers[0] #=> String
     #   resp.db_cluster.db_cluster_members #=> Array
     #   resp.db_cluster.db_cluster_members[0].db_instance_identifier #=> String
     #   resp.db_cluster.db_cluster_members[0].is_cluster_writer #=> Boolean
@@ -4011,25 +4765,25 @@ module Aws::DocDB
     #   The tags to be assigned to the restored cluster.
     #
     # @option params [String] :kms_key_id
-    #   The AWS KMS key identifier to use when restoring an encrypted cluster
-    #   from an encrypted cluster.
+    #   The KMS key identifier to use when restoring an encrypted cluster from
+    #   an encrypted cluster.
     #
-    #   The AWS KMS key identifier is the Amazon Resource Name (ARN) for the
-    #   AWS KMS encryption key. If you are restoring a cluster with the same
-    #   AWS account that owns the AWS KMS encryption key used to encrypt the
-    #   new cluster, then you can use the AWS KMS key alias instead of the ARN
-    #   for the AWS KMS encryption key.
+    #   The KMS key identifier is the Amazon Resource Name (ARN) for the KMS
+    #   encryption key. If you are restoring a cluster with the same account
+    #   that owns the KMS encryption key used to encrypt the new cluster, then
+    #   you can use the KMS key alias instead of the ARN for the KMS
+    #   encryption key.
     #
     #   You can restore to a new cluster and encrypt the new cluster with an
-    #   AWS KMS key that is different from the AWS KMS key used to encrypt the
-    #   source cluster. The new DB cluster is encrypted with the AWS KMS key
-    #   identified by the `KmsKeyId` parameter.
+    #   KMS key that is different from the KMS key used to encrypt the source
+    #   cluster. The new DB cluster is encrypted with the KMS key identified
+    #   by the `KmsKeyId` parameter.
     #
     #   If you do not specify a value for the `KmsKeyId` parameter, then the
     #   following occurs:
     #
     #   * If the cluster is encrypted, then the restored cluster is encrypted
-    #     using the AWS KMS key that was used to encrypt the source cluster.
+    #     using the KMS key that was used to encrypt the source cluster.
     #
     #   * If the cluster is not encrypted, then the restored cluster is not
     #     encrypted.
@@ -4093,6 +4847,9 @@ module Aws::DocDB
     #   resp.db_cluster.master_username #=> String
     #   resp.db_cluster.preferred_backup_window #=> String
     #   resp.db_cluster.preferred_maintenance_window #=> String
+    #   resp.db_cluster.replication_source_identifier #=> String
+    #   resp.db_cluster.read_replica_identifiers #=> Array
+    #   resp.db_cluster.read_replica_identifiers[0] #=> String
     #   resp.db_cluster.db_cluster_members #=> Array
     #   resp.db_cluster.db_cluster_members[0].db_instance_identifier #=> String
     #   resp.db_cluster.db_cluster_members[0].is_cluster_writer #=> Boolean
@@ -4166,6 +4923,9 @@ module Aws::DocDB
     #   resp.db_cluster.master_username #=> String
     #   resp.db_cluster.preferred_backup_window #=> String
     #   resp.db_cluster.preferred_maintenance_window #=> String
+    #   resp.db_cluster.replication_source_identifier #=> String
+    #   resp.db_cluster.read_replica_identifiers #=> Array
+    #   resp.db_cluster.read_replica_identifiers[0] #=> String
     #   resp.db_cluster.db_cluster_members #=> Array
     #   resp.db_cluster.db_cluster_members[0].db_instance_identifier #=> String
     #   resp.db_cluster.db_cluster_members[0].is_cluster_writer #=> Boolean
@@ -4239,6 +4999,9 @@ module Aws::DocDB
     #   resp.db_cluster.master_username #=> String
     #   resp.db_cluster.preferred_backup_window #=> String
     #   resp.db_cluster.preferred_maintenance_window #=> String
+    #   resp.db_cluster.replication_source_identifier #=> String
+    #   resp.db_cluster.read_replica_identifiers #=> Array
+    #   resp.db_cluster.read_replica_identifiers[0] #=> String
     #   resp.db_cluster.db_cluster_members #=> Array
     #   resp.db_cluster.db_cluster_members[0].db_instance_identifier #=> String
     #   resp.db_cluster.db_cluster_members[0].is_cluster_writer #=> Boolean
@@ -4282,7 +5045,7 @@ module Aws::DocDB
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-docdb'
-      context[:gem_version] = '1.29.0'
+      context[:gem_version] = '1.33.0'
       Seahorse::Client::Request.new(handlers, context)
     end