aws-sdk-docdb 1.41.0 → 1.44.0

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

@@ -513,12 +513,14 @@ module Aws::DocDB
     #
     #   * Must specify a valid cluster parameter group.
     #
-    #   * 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 Region than the
-    #     copy, specify a valid cluster parameter group ARN; for example,
+    #   * If the source cluster parameter group is in the same Amazon Web
+    #     Services 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 Amazon Web Services
+    #     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`.
     #
     # @option params [required, String] :target_db_cluster_parameter_group_identifier
@@ -581,7 +583,8 @@ 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 Region.
+    # cluster snapshot, whether encrypted or not, in the same Amazon Web
+    # Services Region.
     #
     # To cancel the copy operation after it is in progress, delete the
     # target cluster snapshot identified by
@@ -596,11 +599,11 @@ module Aws::DocDB
     #
     #   * Must specify a valid system snapshot in the *available* state.
     #
-    #   * If the source snapshot is in the same Region as the copy, specify a
-    #     valid snapshot identifier.
+    #   * If the source snapshot is in the same Amazon Web Services Region as
+    #     the copy, specify a valid snapshot identifier.
     #
-    #   * If the source snapshot is in a different Region than the copy,
-    #     specify a valid cluster snapshot ARN.
+    #   * If the source snapshot is in a different Amazon Web Services Region
+    #     than the copy, specify a valid cluster snapshot ARN.
     #
     #   Example: `my-cluster-snapshot1`
     #
@@ -623,50 +626,56 @@ module Aws::DocDB
     #   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 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 from your Amazon Web
+    #   Services 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
-    #   account, then you must specify a value for `KmsKeyId`.
+    #   Amazon Web Services account, then you must specify a value for
+    #   `KmsKeyId`.
     #
-    #   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.
+    #   To copy an encrypted cluster snapshot to another Amazon Web Services
+    #   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 Amazon Web Services Region
+    #   that they are created in, and you can't use encryption keys from one
+    #   Amazon Web Services Region in another Amazon Web Services 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 Region that contains the
-    #   source cluster snapshot to copy. You must use the `PreSignedUrl`
-    #   parameter when copying a cluster snapshot from another Region.
+    #   the`CopyDBClusterSnapshot` API action in the Amazon Web Services
+    #   Region that contains the source cluster snapshot to copy. You must use
+    #   the `PreSignedUrl` parameter when copying a cluster snapshot from
+    #   another Amazon Web Services Region.
     #
     #   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 Region.
+    #   operation that can be executed in the source Amazon Web Services
+    #   Region.
     #
     #   The presigned URL must be a valid request for the
     #   `CopyDBClusterSnapshot` API action that can be executed in the source
-    #   Region that contains the cluster snapshot to be copied. The presigned
-    #   URL request must contain the following parameter values:
+    #   Amazon Web Services 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 Region. For
-    #     example, if you are copying an encrypted cluster snapshot from the
-    #     us-east-1 Region, then your `SourceDBClusterSnapshotIdentifier`
-    #     looks something like the following:
+    #     the Amazon Resource Name (ARN) format for the source Amazon Web
+    #     Services Region. For example, if you are copying an encrypted
+    #     cluster snapshot from the us-east-1 Amazon Web Services Region, then
+    #     your `SourceDBClusterSnapshotIdentifier` looks something like the
+    #     following:
     #     `arn:aws:rds:us-east-1:12345678012:sample-cluster:sample-cluster-snapshot`.
     #
     #   * `TargetDBClusterSnapshotIdentifier` - The identifier for the new
@@ -822,7 +831,7 @@ module Aws::DocDB
     #   parameter.
     #
     #   The default is a 30-minute window selected at random from an 8-hour
-    #   block of time for each Region.
+    #   block of time for each Amazon Web Services Region.
     #
     #   Constraints:
     #
@@ -841,7 +850,8 @@ 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 Region, occurring on a random day of the week.
+    #   block of time for each Amazon Web Services Region, occurring on a
+    #   random day of the week.
     #
     #   Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
     #
@@ -857,10 +867,10 @@ module Aws::DocDB
     #   The KMS key identifier for an encrypted cluster.
     #
     #   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.
+    #   encryption key. If you are creating a cluster using the same Amazon
+    #   Web Services 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`\:
     #
@@ -869,8 +879,9 @@ module Aws::DocDB
     #
     #   ^
     #
-    #   KMS creates the default encryption key for your account. Your account
-    #   has a different default encryption key for each Regions.
+    #   KMS creates the default encryption key for your Amazon Web Services
+    #   account. Your Amazon Web Services account has a different default
+    #   encryption key for each Amazon Web Services Regions.
     #
     # @option params [String] :pre_signed_url
     #   Not currently supported.
@@ -974,6 +985,7 @@ module Aws::DocDB
     #   resp.db_cluster.associated_roles #=> Array
     #   resp.db_cluster.associated_roles[0].role_arn #=> String
     #   resp.db_cluster.associated_roles[0].status #=> String
+    #   resp.db_cluster.clone_group_id #=> String
     #   resp.db_cluster.cluster_create_time #=> Time
     #   resp.db_cluster.enabled_cloudwatch_logs_exports #=> Array
     #   resp.db_cluster.enabled_cloudwatch_logs_exports[0] #=> String
@@ -1175,7 +1187,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
-    #   Region.
+    #   Amazon Web Services Region.
     #
     #   Example: `us-east-1d`
     #
@@ -1186,7 +1198,8 @@ 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 Region, occurring on a random day of the week.
+    #   block of time for each Amazon Web Services Region, occurring on a
+    #   random day of the week.
     #
     #   Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
     #
@@ -1205,6 +1218,10 @@ module Aws::DocDB
     # @option params [required, String] :db_cluster_identifier
     #   The identifier of the cluster that the instance will belong to.
     #
+    # @option params [Boolean] :copy_tags_to_snapshot
+    #   A value that indicates whether to copy tags from the DB instance to
+    #   snapshots of the DB instance. By default, tags are not copied.
+    #
     # @option params [Integer] :promotion_tier
     #   A value that specifies the order in which an Amazon DocumentDB replica
     #   is promoted to the primary instance after a failure of the existing
@@ -1214,6 +1231,27 @@ module Aws::DocDB
     #
     #   Valid values: 0-15
     #
+    # @option params [Boolean] :enable_performance_insights
+    #   A value that indicates whether to enable Performance Insights for the
+    #   DB Instance. For more information, see [Using Amazon Performance
+    #   Insights][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html
+    #
+    # @option params [String] :performance_insights_kms_key_id
+    #   The KMS key identifier for encryption of Performance Insights data.
+    #
+    #   The KMS key identifier is the key ARN, key ID, alias ARN, or alias
+    #   name for the KMS key.
+    #
+    #   If you do not specify a value for PerformanceInsightsKMSKeyId, then
+    #   Amazon DocumentDB uses your default KMS key. There is a default KMS
+    #   key for your Amazon Web Services account. Your Amazon Web Services
+    #   account has a different default KMS key for each Amazon Web Services
+    #   region.
+    #
     # @return [Types::CreateDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateDBInstanceResult#db_instance #db_instance} => Types::DBInstance
@@ -1234,7 +1272,10 @@ module Aws::DocDB
     #       },
     #     ],
     #     db_cluster_identifier: "String", # required
+    #     copy_tags_to_snapshot: false,
     #     promotion_tier: 1,
+    #     enable_performance_insights: false,
+    #     performance_insights_kms_key_id: "String",
     #   })
     #
     # @example Response structure
@@ -1294,6 +1335,7 @@ module Aws::DocDB
     #   resp.db_instance.kms_key_id #=> String
     #   resp.db_instance.dbi_resource_id #=> String
     #   resp.db_instance.ca_certificate_identifier #=> String
+    #   resp.db_instance.copy_tags_to_snapshot #=> Boolean
     #   resp.db_instance.promotion_tier #=> Integer
     #   resp.db_instance.db_instance_arn #=> String
     #   resp.db_instance.enabled_cloudwatch_logs_exports #=> Array
@@ -1309,7 +1351,8 @@ 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 Region.
+    # subnet in at least two Availability Zones in the Amazon Web Services
+    # Region.
     #
     # @option params [required, String] :db_subnet_group_name
     #   The name for the subnet group. This value is stored as a lowercase
@@ -1492,11 +1535,12 @@ module Aws::DocDB
     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.
+    # multiple Amazon Web Services 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.
     #
     #
     #
@@ -1673,6 +1717,7 @@ module Aws::DocDB
     #   resp.db_cluster.associated_roles #=> Array
     #   resp.db_cluster.associated_roles[0].role_arn #=> String
     #   resp.db_cluster.associated_roles[0].status #=> String
+    #   resp.db_cluster.clone_group_id #=> String
     #   resp.db_cluster.cluster_create_time #=> Time
     #   resp.db_cluster.enabled_cloudwatch_logs_exports #=> Array
     #   resp.db_cluster.enabled_cloudwatch_logs_exports[0] #=> String
@@ -1850,6 +1895,7 @@ module Aws::DocDB
     #   resp.db_instance.kms_key_id #=> String
     #   resp.db_instance.dbi_resource_id #=> String
     #   resp.db_instance.ca_certificate_identifier #=> String
+    #   resp.db_instance.copy_tags_to_snapshot #=> Boolean
     #   resp.db_instance.promotion_tier #=> Integer
     #   resp.db_instance.db_instance_arn #=> String
     #   resp.db_instance.enabled_cloudwatch_logs_exports #=> Array
@@ -1990,7 +2036,7 @@ module Aws::DocDB
     end
 
     # Returns a list of certificate authority (CA) certificates provided by
-    # Amazon DocumentDB for this account.
+    # Amazon DocumentDB for this Amazon Web Services account.
     #
     # @option params [String] :certificate_identifier
     #   The user-supplied certificate identifier. If this parameter is
@@ -2225,12 +2271,13 @@ 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 accounts,
+    # When you share snapshots with other Amazon Web Services accounts,
     # `DescribeDBClusterSnapshotAttributes` returns the `restore` attribute
-    # 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 accounts.
+    # and a list of IDs for the Amazon Web Services 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
+    # Amazon Web Services accounts.
     #
     # @option params [required, String] :db_cluster_snapshot_identifier
     #   The identifier for the cluster snapshot to describe the attributes
@@ -2295,13 +2342,13 @@ module Aws::DocDB
     #   the following values:
     #
     #   * `automated` - Return all cluster snapshots that Amazon DocumentDB
-    #     has automatically created for your account.
+    #     has automatically created for your Amazon Web Services account.
     #
     #   * `manual` - Return all cluster snapshots that you have manually
-    #     created for your account.
+    #     created for your Amazon Web Services account.
     #
     #   * `shared` - Return all manual cluster snapshots that have been shared
-    #     to your account.
+    #     to your Amazon Web Services account.
     #
     #   * `public` - Return all cluster snapshots that have been marked as
     #     public.
@@ -2338,13 +2385,14 @@ module Aws::DocDB
     #
     # @option params [Boolean] :include_shared
     #   Set to `true` to include shared manual cluster snapshots from other
-    #   accounts that this account has been given permission to copy or
-    #   restore, and otherwise `false`. The default is `false`.
+    #   Amazon Web Services accounts that this Amazon Web Services 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 account, and otherwise `false`. The
-    #   default is `false`.
+    #   can be copied or restored by any Amazon Web Services account, and
+    #   otherwise `false`. The default is `false`.
     #
     # @return [Types::DBClusterSnapshotMessage] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2510,6 +2558,7 @@ module Aws::DocDB
     #   resp.db_clusters[0].associated_roles #=> Array
     #   resp.db_clusters[0].associated_roles[0].role_arn #=> String
     #   resp.db_clusters[0].associated_roles[0].status #=> String
+    #   resp.db_clusters[0].clone_group_id #=> String
     #   resp.db_clusters[0].cluster_create_time #=> Time
     #   resp.db_clusters[0].enabled_cloudwatch_logs_exports #=> Array
     #   resp.db_clusters[0].enabled_cloudwatch_logs_exports[0] #=> String
@@ -2752,6 +2801,7 @@ module Aws::DocDB
     #   resp.db_instances[0].kms_key_id #=> String
     #   resp.db_instances[0].dbi_resource_id #=> String
     #   resp.db_instances[0].ca_certificate_identifier #=> String
+    #   resp.db_instances[0].copy_tags_to_snapshot #=> Boolean
     #   resp.db_instances[0].promotion_tier #=> Integer
     #   resp.db_instances[0].db_instance_arn #=> String
     #   resp.db_instances[0].enabled_cloudwatch_logs_exports #=> Array
@@ -3469,6 +3519,7 @@ module Aws::DocDB
     #   resp.db_cluster.associated_roles #=> Array
     #   resp.db_cluster.associated_roles[0].role_arn #=> String
     #   resp.db_cluster.associated_roles[0].status #=> String
+    #   resp.db_cluster.clone_group_id #=> String
     #   resp.db_cluster.cluster_create_time #=> Time
     #   resp.db_cluster.enabled_cloudwatch_logs_exports #=> Array
     #   resp.db_cluster.enabled_cloudwatch_logs_exports[0] #=> String
@@ -3607,7 +3658,7 @@ module Aws::DocDB
     #   parameter.
     #
     #   The default is a 30-minute window selected at random from an 8-hour
-    #   block of time for each Region.
+    #   block of time for each Amazon Web Services Region.
     #
     #   Constraints:
     #
@@ -3626,7 +3677,8 @@ 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 Region, occurring on a random day of the week.
+    #   block of time for each Amazon Web Services Region, occurring on a
+    #   random day of the week.
     #
     #   Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
     #
@@ -3714,6 +3766,7 @@ module Aws::DocDB
     #   resp.db_cluster.associated_roles #=> Array
     #   resp.db_cluster.associated_roles[0].role_arn #=> String
     #   resp.db_cluster.associated_roles[0].status #=> String
+    #   resp.db_cluster.clone_group_id #=> String
     #   resp.db_cluster.cluster_create_time #=> Time
     #   resp.db_cluster.enabled_cloudwatch_logs_exports #=> Array
     #   resp.db_cluster.enabled_cloudwatch_logs_exports[0] #=> String
@@ -3794,17 +3847,19 @@ module Aws::DocDB
     # Adds an attribute and values to, or removes an attribute and values
     # from, a manual cluster snapshot.
     #
-    # 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 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.
+    # To share a manual cluster snapshot with other Amazon Web Services
+    # accounts, specify `restore` as the `AttributeName`, and use the
+    # `ValuesToAdd` parameter to add a list of IDs of the Amazon Web
+    # Services 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 Amazon
+    # Web Services accounts. Do not add the `all` value for any manual
+    # cluster snapshots that contain private information that you don't
+    # want available to all Amazon Web Services accounts. If a manual
+    # cluster snapshot is encrypted, it can be shared, but only by
+    # specifying a list of authorized Amazon Web Services 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.
@@ -3812,29 +3867,31 @@ module Aws::DocDB
     # @option params [required, String] :attribute_name
     #   The name of the cluster snapshot attribute to modify.
     #
-    #   To manage authorization for other accounts to copy or restore a manual
-    #   cluster snapshot, set this value to `restore`.
+    #   To manage authorization for other Amazon Web Services 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 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 accounts.
+    #   To authorize other Amazon Web Services accounts to copy or restore a
+    #   manual cluster snapshot, set this list to include one or more Amazon
+    #   Web Services account IDs. To make the manual cluster snapshot
+    #   restorable by any Amazon Web Services 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 Amazon
+    #   Web Services 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 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`
+    #   To remove authorization for other Amazon Web Services accounts to copy
+    #   or restore a manual cluster snapshot, set this list to include one or
+    #   more Amazon Web Services account identifiers. To remove authorization
+    #   for any Amazon Web Services account to copy or restore the cluster
+    #   snapshot, set it to `all` . If you specify `all`, an Amazon Web
+    #   Services 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:
@@ -3882,7 +3939,8 @@ 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 Regions.
+    #   `db.r5.large`. Not all instance classes are available in all Amazon
+    #   Web Services Regions.
     #
     #   If you modify the instance class, an outage occurs during the change.
     #   The change is applied during the next maintenance window, unless
@@ -3946,6 +4004,10 @@ module Aws::DocDB
     #   Indicates the certificate that needs to be associated with the
     #   instance.
     #
+    # @option params [Boolean] :copy_tags_to_snapshot
+    #   A value that indicates whether to copy all tags from the DB instance
+    #   to snapshots of the DB instance. By default, tags are not copied.
+    #
     # @option params [Integer] :promotion_tier
     #   A value that specifies the order in which an Amazon DocumentDB replica
     #   is promoted to the primary instance after a failure of the existing
@@ -3955,6 +4017,27 @@ module Aws::DocDB
     #
     #   Valid values: 0-15
     #
+    # @option params [Boolean] :enable_performance_insights
+    #   A value that indicates whether to enable Performance Insights for the
+    #   DB Instance. For more information, see [Using Amazon Performance
+    #   Insights][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html
+    #
+    # @option params [String] :performance_insights_kms_key_id
+    #   The KMS key identifier for encryption of Performance Insights data.
+    #
+    #   The KMS key identifier is the key ARN, key ID, alias ARN, or alias
+    #   name for the KMS key.
+    #
+    #   If you do not specify a value for PerformanceInsightsKMSKeyId, then
+    #   Amazon DocumentDB uses your default KMS key. There is a default KMS
+    #   key for your Amazon Web Services account. Your Amazon Web Services
+    #   account has a different default KMS key for each Amazon Web Services
+    #   region.
+    #
     # @return [Types::ModifyDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ModifyDBInstanceResult#db_instance #db_instance} => Types::DBInstance
@@ -3969,7 +4052,10 @@ module Aws::DocDB
     #     auto_minor_version_upgrade: false,
     #     new_db_instance_identifier: "String",
     #     ca_certificate_identifier: "String",
+    #     copy_tags_to_snapshot: false,
     #     promotion_tier: 1,
+    #     enable_performance_insights: false,
+    #     performance_insights_kms_key_id: "String",
     #   })
     #
     # @example Response structure
@@ -4029,6 +4115,7 @@ module Aws::DocDB
     #   resp.db_instance.kms_key_id #=> String
     #   resp.db_instance.dbi_resource_id #=> String
     #   resp.db_instance.ca_certificate_identifier #=> String
+    #   resp.db_instance.copy_tags_to_snapshot #=> Boolean
     #   resp.db_instance.promotion_tier #=> Integer
     #   resp.db_instance.db_instance_arn #=> String
     #   resp.db_instance.enabled_cloudwatch_logs_exports #=> Array
@@ -4044,7 +4131,8 @@ 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 Region.
+    # one subnet in at least two Availability Zones in the Amazon Web
+    # Services Region.
     #
     # @option params [required, String] :db_subnet_group_name
     #   The name for the subnet group. This value is stored as a lowercase
@@ -4324,6 +4412,7 @@ module Aws::DocDB
     #   resp.db_instance.kms_key_id #=> String
     #   resp.db_instance.dbi_resource_id #=> String
     #   resp.db_instance.ca_certificate_identifier #=> String
+    #   resp.db_instance.copy_tags_to_snapshot #=> Boolean
     #   resp.db_instance.promotion_tier #=> Integer
     #   resp.db_instance.db_instance_arn #=> String
     #   resp.db_instance.enabled_cloudwatch_logs_exports #=> Array
@@ -4606,10 +4695,10 @@ module Aws::DocDB
     #   a DB snapshot or cluster snapshot.
     #
     #   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.
+    #   encryption key. If you are restoring a cluster with the same Amazon
+    #   Web Services 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:
@@ -4697,6 +4786,7 @@ module Aws::DocDB
     #   resp.db_cluster.associated_roles #=> Array
     #   resp.db_cluster.associated_roles[0].role_arn #=> String
     #   resp.db_cluster.associated_roles[0].status #=> String
+    #   resp.db_cluster.clone_group_id #=> String
     #   resp.db_cluster.cluster_create_time #=> Time
     #   resp.db_cluster.enabled_cloudwatch_logs_exports #=> Array
     #   resp.db_cluster.enabled_cloudwatch_logs_exports[0] #=> String
@@ -4729,6 +4819,19 @@ module Aws::DocDB
     #
     #   * Cannot end with a hyphen or contain two consecutive hyphens.
     #
+    # @option params [String] :restore_type
+    #   The type of restore to be performed. You can specify one of the
+    #   following values:
+    #
+    #   * `full-copy` - The new DB cluster is restored as a full copy of the
+    #     source DB cluster.
+    #
+    #   * `copy-on-write` - The new DB cluster is restored as a clone of the
+    #     source DB cluster.
+    #
+    #   If you don't specify a `RestoreType` value, then the new DB cluster
+    #   is restored as a full copy of the source DB cluster.
+    #
     # @option params [required, String] :source_db_cluster_identifier
     #   The identifier of the source cluster from which to restore.
     #
@@ -4793,10 +4896,10 @@ module Aws::DocDB
     #   an encrypted cluster.
     #
     #   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.
+    #   encryption key. If you are restoring a cluster with the same Amazon
+    #   Web Services 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
     #   KMS key that is different from the KMS key used to encrypt the source
@@ -4833,6 +4936,7 @@ module Aws::DocDB
     #
     #   resp = client.restore_db_cluster_to_point_in_time({
     #     db_cluster_identifier: "String", # required
+    #     restore_type: "String",
     #     source_db_cluster_identifier: "String", # required
     #     restore_to_time: Time.now,
     #     use_latest_restorable_time: false,
@@ -4890,6 +4994,7 @@ module Aws::DocDB
     #   resp.db_cluster.associated_roles #=> Array
     #   resp.db_cluster.associated_roles[0].role_arn #=> String
     #   resp.db_cluster.associated_roles[0].status #=> String
+    #   resp.db_cluster.clone_group_id #=> String
     #   resp.db_cluster.cluster_create_time #=> Time
     #   resp.db_cluster.enabled_cloudwatch_logs_exports #=> Array
     #   resp.db_cluster.enabled_cloudwatch_logs_exports[0] #=> String
@@ -4966,6 +5071,7 @@ module Aws::DocDB
     #   resp.db_cluster.associated_roles #=> Array
     #   resp.db_cluster.associated_roles[0].role_arn #=> String
     #   resp.db_cluster.associated_roles[0].status #=> String
+    #   resp.db_cluster.clone_group_id #=> String
     #   resp.db_cluster.cluster_create_time #=> Time
     #   resp.db_cluster.enabled_cloudwatch_logs_exports #=> Array
     #   resp.db_cluster.enabled_cloudwatch_logs_exports[0] #=> String
@@ -5042,6 +5148,7 @@ module Aws::DocDB
     #   resp.db_cluster.associated_roles #=> Array
     #   resp.db_cluster.associated_roles[0].role_arn #=> String
     #   resp.db_cluster.associated_roles[0].status #=> String
+    #   resp.db_cluster.clone_group_id #=> String
     #   resp.db_cluster.cluster_create_time #=> Time
     #   resp.db_cluster.enabled_cloudwatch_logs_exports #=> Array
     #   resp.db_cluster.enabled_cloudwatch_logs_exports[0] #=> String
@@ -5069,7 +5176,7 @@ module Aws::DocDB
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-docdb'
-      context[:gem_version] = '1.41.0'
+      context[:gem_version] = '1.44.0'
       Seahorse::Client::Request.new(handlers, context)
     end