aws-sdk-docdb 1.19.0 → 1.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0e14101843392678903c7aeafbd500cf5eedeaa956b25a44c937449eff88fe8
-  data.tar.gz: 3e3357a4dd450cc08d6a896c77d6719f076749655d4e5cae6de2ac264de9f499
+  metadata.gz: 6bc34c81869621e6e31fd78aba6504c6db838cda12d3de6c998054170646ffcb
+  data.tar.gz: 2dd9eaf9c00f938389de17b0d3af5ed6c900e402170f4cb50c5c17f2c1b663fa
 SHA512:
-  metadata.gz: d6dacf13cb6d8b2a4919e7079cc6452d4a8a1de71546f9e406a6943cf148e8e29f1d641a0b693e50917e87a7b79b92c0c7d8e7ef10392eaab50e8ae6144c3729
-  data.tar.gz: 0b860377e4cfac76ee7566adaa5e2ab119a1909d6a1d0d0384d98a4b2c41fc4201d282fe2b6ffaf04a87621d8c61bd16ede5bda7feffdd2d8813ae027232f38f
+  metadata.gz: 0d30efd0f14f8639806953fbdd26687666880553d3c8e8674d8209c7e9a50bd931f6cbba4bb4a4a029909b0957f9142d1a12c1e2f65a262b6e8a4211d3a4aa1c
+  data.tar.gz: 918a98ad341c5e322a3cd351620efb4f0566f5449ea40573ffffb17b0bfc2382fc29d8d2d67c0687755a607456388cfc2c8698f7ad8eb45f0ab6a953aea51434

data/lib/aws-sdk-docdb.rb

@@ -7,6 +7,7 @@
 #
 # WARNING ABOUT GENERATED CODE
 
+
 require 'aws-sdk-core'
 require 'aws-sigv4'
 
@@ -45,9 +46,9 @@ require_relative 'aws-sdk-docdb/customizations'
 #
 # See {Errors} for more information.
 #
-# @service
+# @!group service
 module Aws::DocDB
 
-  GEM_VERSION = '1.19.0'
+  GEM_VERSION = '1.25.0'
 
 end

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

@@ -85,13 +85,28 @@ module Aws::DocDB
     #     * `Aws::Credentials` - Used for configuring static, non-refreshing
     #       credentials.
     #
+    #     * `Aws::SharedCredentials` - Used for loading static credentials from a
+    #       shared file, such as `~/.aws/config`.
+    #
+    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #
+    #     * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
+    #       assume a role after providing credentials via the web.
+    #
+    #     * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
+    #       access token generated from `aws login`.
+    #
+    #     * `Aws::ProcessCredentials` - Used for loading credentials from a
+    #       process that outputs to stdout.
+    #
     #     * `Aws::InstanceProfileCredentials` - Used for loading credentials
     #       from an EC2 IMDS on an EC2 instance.
     #
-    #     * `Aws::SharedCredentials` - Used for loading credentials from a
-    #       shared file, such as `~/.aws/config`.
+    #     * `Aws::ECSCredentials` - Used for loading credentials from
+    #       instances running in ECS.
     #
-    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #     * `Aws::CognitoIdentityCredentials` - Used for loading credentials
+    #       from the Cognito Identity service.
     #
     #     When `:credentials` are not configured directly, the following
     #     locations will be searched for credentials:
@@ -101,10 +116,10 @@ module Aws::DocDB
     #     * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
     #     * `~/.aws/credentials`
     #     * `~/.aws/config`
-    #     * EC2 IMDS instance profile - When used by default, the timeouts are
-    #       very aggressive. Construct and pass an instance of
-    #       `Aws::InstanceProfileCredentails` to enable retries and extended
-    #       timeouts.
+    #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
+    #       are very aggressive. Construct and pass an instance of
+    #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
+    #       enable retries and extended timeouts.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -319,7 +334,7 @@ module Aws::DocDB
     #
     # @option params [required, String] :resource_name
     #   The Amazon DocumentDB resource that the tags are added to. This value
-    #   is an Amazon Resource Name (ARN).
+    #   is an Amazon Resource Name .
     #
     # @option params [required, Array<Types::Tag>] :tags
     #   The tags to be assigned to the Amazon DocumentDB resource.
@@ -347,8 +362,8 @@ module Aws::DocDB
       req.send_request(options)
     end
 
-    # Applies a pending maintenance action to a resource (for example, to a
-    # DB instance).
+    # Applies a pending maintenance action to a resource (for example, to an
+    # Amazon DocumentDB instance).
     #
     # @option params [required, String] :resource_identifier
     #   The Amazon Resource Name (ARN) of the resource that the pending
@@ -421,7 +436,7 @@ module Aws::DocDB
     #
     #   * If the source parameter group is in a different AWS Region than the
     #     copy, specify a valid cluster parameter group ARN; for example,
-    #     `arn:aws:rds:us-east-1:123456789012:cluster-pg:custom-cluster-group1`.
+    #     `arn:aws:rds:us-east-1:123456789012:sample-cluster:sample-parameter-group`.
     #
     # @option params [required, String] :target_db_cluster_parameter_group_identifier
     #   The identifier for the copied cluster parameter group.
@@ -482,23 +497,21 @@ 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.
+    # (ARN) of the shared cluster snapshot. You can only copy a shared DB
+    # cluster snapshot, whether encrypted or not, in the same AWS Region.
     #
     # To cancel the copy operation after it is in progress, delete the
     # target cluster snapshot identified by
-    # `TargetDBClusterSnapshotIdentifier` while that DB cluster snapshot is
-    # in the *copying* status.
+    # `TargetDBClusterSnapshotIdentifier` while that cluster snapshot is in
+    # the *copying* status.
     #
     # @option params [required, String] :source_db_cluster_snapshot_identifier
     #   The identifier of the cluster snapshot to copy. This parameter is not
     #   case sensitive.
     #
-    #   You can't copy an encrypted, shared cluster snapshot from one AWS
-    #   Region to another.
-    #
     #   Constraints:
     #
-    #   * Must specify a valid system snapshot in the "available" state.
+    #   * 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.
@@ -540,8 +553,8 @@ module Aws::DocDB
     #   `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 Region in another
-    #   Region.
+    #   in, and you can't use encryption keys from one AWS Region in another
+    #   AWS Region.
     #
     #   If you copy an unencrypted cluster snapshot and specify a value for
     #   the `KmsKeyId` parameter, an error is returned.
@@ -550,32 +563,33 @@ module Aws::DocDB
     #   The URL that contains a Signature Version 4 signed request for the
     #   `CopyDBClusterSnapshot` API action in the AWS Region that contains the
     #   source cluster snapshot to copy. You must use the `PreSignedUrl`
-    #   parameter when copying an encrypted cluster snapshot from another AWS
-    #   Region.
+    #   parameter when copying a cluster snapshot from another AWS 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
+    #   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.
     #
     #   The presigned URL must be a valid request for the
-    #   `CopyDBSClusterSnapshot` API action that can be executed in the source
-    #   AWS Region that contains the encrypted DB cluster snapshot to be
-    #   copied. The presigned URL request must contain the following parameter
-    #   values:
-    #
-    #   * `KmsKeyId` - The AWS KMS key identifier for the key to use to
-    #     encrypt the copy of the cluster snapshot in the destination AWS
-    #     Region. This is the same identifier for both the
-    #     `CopyDBClusterSnapshot` action that is called in the destination AWS
-    #     Region, and the action contained in the presigned URL.
-    #
-    #   * `DestinationRegion` - The name of the AWS Region that the DB cluster
-    #     snapshot will be created in.
-    #
-    #   * `SourceDBClusterSnapshotIdentifier` - The cluster snapshot
-    #     identifier for the encrypted cluster snapshot to be copied. This
-    #     identifier must be in the Amazon Resource Name (ARN) format for the
-    #     source AWS Region. For example, if you are copying an encrypted
-    #     cluster snapshot from the us-west-2 AWS Region, then your
-    #     `SourceDBClusterSnapshotIdentifier` looks like the following
-    #     example:
-    #     `arn:aws:rds:us-west-2:123456789012:cluster-snapshot:my-cluster-snapshot-20161115`.
+    #   `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:
+    #
+    #   * `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
+    #     example, if you are copying an encrypted cluster snapshot from the
+    #     us-east-1 AWS 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
+    #     cluster snapshot to be created. This parameter isn't case
+    #     sensitive.
     #
     # @option params [Boolean] :copy_tags
     #   Set to `true` to copy all tags from the source cluster snapshot to the
@@ -688,7 +702,10 @@ module Aws::DocDB
     #   Valid values: `docdb`
     #
     # @option params [String] :engine_version
-    #   The version number of the database engine to use.
+    #   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
@@ -779,9 +796,19 @@ module Aws::DocDB
     #   destination AWS Region. This key is used to encrypt the replica in
     #   that AWS Region.
     #
+    # @option params [String] :pre_signed_url
+    #   Not currently supported.
+    #
     # @option params [Array<String>] :enable_cloudwatch_logs_exports
     #   A list of log types that need to be enabled for exporting to Amazon
-    #   CloudWatch Logs.
+    #   CloudWatch Logs. You can enable audit logs or profiler logs. For more
+    #   information, see [ Auditing Amazon DocumentDB Events][1] and [
+    #   Profiling Amazon DocumentDB Operations][2].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/documentdb/latest/developerguide/event-auditing.html
+    #   [2]: https://docs.aws.amazon.com/documentdb/latest/developerguide/profiling.html
     #
     # @option params [Boolean] :deletion_protection
     #   Specifies whether this cluster can be deleted. If `DeletionProtection`
@@ -817,6 +844,7 @@ module Aws::DocDB
     #     ],
     #     storage_encrypted: false,
     #     kms_key_id: "String",
+    #     pre_signed_url: "String",
     #     enable_cloudwatch_logs_exports: ["String"],
     #     deletion_protection: false,
     #   })
@@ -875,24 +903,26 @@ module Aws::DocDB
     # Creates a new cluster parameter group.
     #
     # Parameters in a cluster parameter group apply to all of the instances
-    # in a DB cluster.
+    # in a cluster.
     #
     # A cluster parameter group is initially created with the default
     # parameters for the database engine used by instances in the cluster.
-    # To provide custom values for any of the parameters, you must modify
-    # the group after you create it. After you create a DB cluster parameter
-    # group, you must associate it with your cluster. For the new DB cluster
-    # parameter group and associated settings to take effect, you must then
-    # reboot the instances in the cluster without failover.
+    # In Amazon DocumentDB, you cannot make modifications directly to the
+    # `default.docdb3.6` cluster parameter group. If your Amazon DocumentDB
+    # cluster is using the default cluster parameter group and you want to
+    # modify a value in it, you must first [ create a new parameter
+    # group][1] or [ copy an existing parameter group][2], modify it, and
+    # then apply the modified parameter group to your cluster. For the new
+    # cluster parameter group and associated settings to take effect, you
+    # must then reboot the instances in the cluster without failover. For
+    # more information, see [ Modifying Amazon DocumentDB Cluster Parameter
+    # Groups][3].
+    #
     #
-    # After you create a cluster parameter group, you should wait at least 5
-    # minutes before creating your first cluster that uses that cluster
-    # parameter group as the default parameter group. This allows Amazon
-    # DocumentDB to fully complete the create action before the cluster
-    # parameter group is used as the default for a new cluster. This step is
-    # especially important for parameters that are critical when creating
-    # the default database for a cluster, such as the character set for the
-    # default database defined by the `character_set_database` parameter.
+    #
+    # [1]: https://docs.aws.amazon.com/documentdb/latest/developerguide/cluster_parameter_group-create.html
+    # [2]: https://docs.aws.amazon.com/documentdb/latest/developerguide/cluster_parameter_group-copy.html
+    # [3]: https://docs.aws.amazon.com/documentdb/latest/developerguide/cluster_parameter_group-modify.html
     #
     # @option params [required, String] :db_cluster_parameter_group_name
     #   The name of the cluster parameter group.
@@ -1061,10 +1091,6 @@ module Aws::DocDB
     #
     #   Example: `us-east-1d`
     #
-    #   Constraint: The `AvailabilityZone` parameter can't be specified if
-    #   the `MultiAZ` parameter is set to `true`. The specified Availability
-    #   Zone must be in the same AWS Region as the current endpoint.
-    #
     # @option params [String] :preferred_maintenance_window
     #   The time range each week during which system maintenance can occur, in
     #   Universal Coordinated Time (UTC).
@@ -1621,6 +1647,8 @@ module Aws::DocDB
     #   * {Types::CertificateMessage#certificates #certificates} => Array&lt;Types::Certificate&gt;
     #   * {Types::CertificateMessage#marker #marker} => String
     #
+    # 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_certificates({
@@ -1693,6 +1721,8 @@ module Aws::DocDB
     #   * {Types::DBClusterParameterGroupsMessage#marker #marker} => String
     #   * {Types::DBClusterParameterGroupsMessage#db_cluster_parameter_groups #db_cluster_parameter_groups} => Array&lt;Types::DBClusterParameterGroup&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_db_cluster_parameter_groups({
@@ -1766,6 +1796,8 @@ module Aws::DocDB
     #   * {Types::DBClusterParameterGroupDetails#parameters #parameters} => Array&lt;Types::Parameter&gt;
     #   * {Types::DBClusterParameterGroupDetails#marker #marker} => String
     #
+    # 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_db_cluster_parameters({
@@ -1934,6 +1966,8 @@ module Aws::DocDB
     #   * {Types::DBClusterSnapshotMessage#marker #marker} => String
     #   * {Types::DBClusterSnapshotMessage#db_cluster_snapshots #db_cluster_snapshots} => Array&lt;Types::DBClusterSnapshot&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_db_cluster_snapshots({
@@ -2110,7 +2144,7 @@ module Aws::DocDB
     # @option params [String] :engine_version
     #   The database engine version to return.
     #
-    #   Example: `5.1.49`
+    #   Example: `3.6.0`
     #
     # @option params [String] :db_parameter_group_family
     #   The name of a specific parameter group family to return details for.
@@ -2775,6 +2809,8 @@ module Aws::DocDB
     #   * {Types::PendingMaintenanceActionsMessage#pending_maintenance_actions #pending_maintenance_actions} => Array&lt;Types::ResourcePendingMaintenanceActions&gt;
     #   * {Types::PendingMaintenanceActionsMessage#marker #marker} => String
     #
+    # 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_pending_maintenance_actions({
@@ -4243,7 +4279,7 @@ module Aws::DocDB
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-docdb'
-      context[:gem_version] = '1.19.0'
+      context[:gem_version] = '1.25.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -284,6 +284,7 @@ module Aws::DocDB
     CreateDBClusterMessage.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
     CreateDBClusterMessage.add_member(:storage_encrypted, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "StorageEncrypted"))
     CreateDBClusterMessage.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: String, location_name: "KmsKeyId"))
+    CreateDBClusterMessage.add_member(:pre_signed_url, Shapes::ShapeRef.new(shape: String, location_name: "PreSignedUrl"))
     CreateDBClusterMessage.add_member(:enable_cloudwatch_logs_exports, Shapes::ShapeRef.new(shape: LogTypeList, location_name: "EnableCloudwatchLogsExports"))
     CreateDBClusterMessage.add_member(:deletion_protection, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "DeletionProtection"))
     CreateDBClusterMessage.struct_class = Types::CreateDBClusterMessage
@@ -1208,6 +1209,12 @@ module Aws::DocDB
         o.input = Shapes::ShapeRef.new(shape: DescribeCertificatesMessage)
         o.output = Shapes::ShapeRef.new(shape: CertificateMessage)
         o.errors << Shapes::ShapeRef.new(shape: CertificateNotFoundFault)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_records",
+          tokens: {
+            "marker" => "marker"
+          }
+        )
       end)
 
       api.add_operation(:describe_db_cluster_parameter_groups, Seahorse::Model::Operation.new.tap do |o|
@@ -1217,6 +1224,12 @@ module Aws::DocDB
         o.input = Shapes::ShapeRef.new(shape: DescribeDBClusterParameterGroupsMessage)
         o.output = Shapes::ShapeRef.new(shape: DBClusterParameterGroupsMessage)
         o.errors << Shapes::ShapeRef.new(shape: DBParameterGroupNotFoundFault)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_records",
+          tokens: {
+            "marker" => "marker"
+          }
+        )
       end)
 
       api.add_operation(:describe_db_cluster_parameters, Seahorse::Model::Operation.new.tap do |o|
@@ -1226,6 +1239,12 @@ module Aws::DocDB
         o.input = Shapes::ShapeRef.new(shape: DescribeDBClusterParametersMessage)
         o.output = Shapes::ShapeRef.new(shape: DBClusterParameterGroupDetails)
         o.errors << Shapes::ShapeRef.new(shape: DBParameterGroupNotFoundFault)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_records",
+          tokens: {
+            "marker" => "marker"
+          }
+        )
       end)
 
       api.add_operation(:describe_db_cluster_snapshot_attributes, Seahorse::Model::Operation.new.tap do |o|
@@ -1244,6 +1263,12 @@ module Aws::DocDB
         o.input = Shapes::ShapeRef.new(shape: DescribeDBClusterSnapshotsMessage)
         o.output = Shapes::ShapeRef.new(shape: DBClusterSnapshotMessage)
         o.errors << Shapes::ShapeRef.new(shape: DBClusterSnapshotNotFoundFault)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_records",
+          tokens: {
+            "marker" => "marker"
+          }
+        )
       end)
 
       api.add_operation(:describe_db_clusters, Seahorse::Model::Operation.new.tap do |o|
@@ -1356,6 +1381,12 @@ module Aws::DocDB
         o.input = Shapes::ShapeRef.new(shape: DescribePendingMaintenanceActionsMessage)
         o.output = Shapes::ShapeRef.new(shape: PendingMaintenanceActionsMessage)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundFault)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_records",
+          tokens: {
+            "marker" => "marker"
+          }
+        )
       end)
 
       api.add_operation(:failover_db_cluster, Seahorse::Model::Operation.new.tap do |o|

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

@@ -27,7 +27,7 @@ module Aws::DocDB
     #
     # @!attribute [rw] resource_name
     #   The Amazon DocumentDB resource that the tags are added to. This
-    #   value is an Amazon Resource Name (ARN).
+    #   value is an Amazon Resource Name .
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -267,7 +267,7 @@ module Aws::DocDB
     #   * If the source parameter group is in a different AWS Region than
     #     the copy, specify a valid cluster parameter group ARN; for
     #     example,
-    #     `arn:aws:rds:us-east-1:123456789012:cluster-pg:custom-cluster-group1`.
+    #     `arn:aws:rds:us-east-1:123456789012:sample-cluster:sample-parameter-group`.
     #   @return [String]
     #
     # @!attribute [rw] target_db_cluster_parameter_group_identifier
@@ -340,12 +340,9 @@ module Aws::DocDB
     #   The identifier of the cluster snapshot to copy. This parameter is
     #   not case sensitive.
     #
-    #   You can't copy an encrypted, shared cluster snapshot from one AWS
-    #   Region to another.
-    #
     #   Constraints:
     #
-    #   * Must specify a valid system snapshot in the "available" state.
+    #   * 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.
@@ -389,8 +386,8 @@ module Aws::DocDB
     #   `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 Region in another
-    #   Region.
+    #   in, and you can't use encryption keys from one AWS Region in
+    #   another AWS Region.
     #
     #   If you copy an unencrypted cluster snapshot and specify a value for
     #   the `KmsKeyId` parameter, an error is returned.
@@ -400,32 +397,35 @@ module Aws::DocDB
     #   The URL that contains a Signature Version 4 signed request for the
     #   `CopyDBClusterSnapshot` API action in the AWS Region that contains
     #   the source cluster snapshot to copy. You must use the `PreSignedUrl`
-    #   parameter when copying an encrypted cluster snapshot from another
-    #   AWS Region.
+    #   parameter when copying a cluster snapshot from another AWS 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
+    #   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.
     #
     #   The presigned URL must be a valid request for the
-    #   `CopyDBSClusterSnapshot` API action that can be executed in the
-    #   source AWS Region that contains the encrypted DB cluster snapshot to
-    #   be copied. The presigned URL request must contain the following
-    #   parameter values:
-    #
-    #   * `KmsKeyId` - The AWS KMS key identifier for the key to use to
-    #     encrypt the copy of the cluster snapshot in the destination AWS
-    #     Region. This is the same identifier for both the
-    #     `CopyDBClusterSnapshot` action that is called in the destination
-    #     AWS Region, and the action contained in the presigned URL.
-    #
-    #   * `DestinationRegion` - The name of the AWS Region that the DB
-    #     cluster snapshot will be created in.
-    #
-    #   * `SourceDBClusterSnapshotIdentifier` - The cluster snapshot
-    #     identifier for the encrypted cluster snapshot to be copied. This
-    #     identifier must be in the Amazon Resource Name (ARN) format for
-    #     the source AWS Region. For example, if you are copying an
-    #     encrypted cluster snapshot from the us-west-2 AWS Region, then
-    #     your `SourceDBClusterSnapshotIdentifier` looks like the following
-    #     example:
-    #     `arn:aws:rds:us-west-2:123456789012:cluster-snapshot:my-cluster-snapshot-20161115`.
+    #   `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:
+    #
+    #   * `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 example, if you are copying an encrypted cluster
+    #     snapshot from the us-east-1 AWS 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
+    #     cluster snapshot to be created. This parameter isn't case
+    #     sensitive.
     #   @return [String]
     #
     # @!attribute [rw] copy_tags
@@ -490,6 +490,7 @@ module Aws::DocDB
     #         ],
     #         storage_encrypted: false,
     #         kms_key_id: "String",
+    #         pre_signed_url: "String",
     #         enable_cloudwatch_logs_exports: ["String"],
     #         deletion_protection: false,
     #       }
@@ -552,7 +553,10 @@ module Aws::DocDB
     #   @return [String]
     #
     # @!attribute [rw] engine_version
-    #   The version number of the database engine to use.
+    #   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.
     #   @return [String]
     #
     # @!attribute [rw] port
@@ -652,9 +656,20 @@ module Aws::DocDB
     #   that AWS Region.
     #   @return [String]
     #
+    # @!attribute [rw] pre_signed_url
+    #   Not currently supported.
+    #   @return [String]
+    #
     # @!attribute [rw] enable_cloudwatch_logs_exports
     #   A list of log types that need to be enabled for exporting to Amazon
-    #   CloudWatch Logs.
+    #   CloudWatch Logs. You can enable audit logs or profiler logs. For
+    #   more information, see [ Auditing Amazon DocumentDB Events][1] and [
+    #   Profiling Amazon DocumentDB Operations][2].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/documentdb/latest/developerguide/event-auditing.html
+    #   [2]: https://docs.aws.amazon.com/documentdb/latest/developerguide/profiling.html
     #   @return [Array<String>]
     #
     # @!attribute [rw] deletion_protection
@@ -684,6 +699,7 @@ module Aws::DocDB
       :tags,
       :storage_encrypted,
       :kms_key_id,
+      :pre_signed_url,
       :enable_cloudwatch_logs_exports,
       :deletion_protection)
       SENSITIVE = []
@@ -893,10 +909,6 @@ module Aws::DocDB
     #   endpoint's AWS Region.
     #
     #   Example: `us-east-1d`
-    #
-    #   Constraint: The `AvailabilityZone` parameter can't be specified if
-    #   the `MultiAZ` parameter is set to `true`. The specified Availability
-    #   Zone must be in the same AWS Region as the current endpoint.
     #   @return [String]
     #
     # @!attribute [rw] preferred_maintenance_window
@@ -2724,7 +2736,7 @@ module Aws::DocDB
     # @!attribute [rw] engine_version
     #   The database engine version to return.
     #
-    #   Example: `5.1.49`
+    #   Example: `3.6.0`
     #   @return [String]
     #
     # @!attribute [rw] db_parameter_group_family

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-docdb
 version: !ruby/object:Gem::Version
-  version: 1.19.0
+  version: 1.25.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-06-23 00:00:00.000000000 Z
+date: 2020-09-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.99.0
+        version: 3.109.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.99.0
+        version: 3.109.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement