aws-sdk-docdb 1.23.0 → 1.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5d719dc4f523dd9c3850caab8ed97b6e3de356ef465ce35612f726047acaa05
-  data.tar.gz: 6418facbb94cac8c92abe036eca0cde87c98ba4df87f21dc957a39f889f611f7
+  metadata.gz: 9135f3129d8f85c62464e8e33c6c1c0f94913bd7ac876a7b4b8fec606199ec4e
+  data.tar.gz: e0a6e3b0f77e83eafe61355d95b5ac44bc739a4d20625edaf49e7672f5bba135
 SHA512:
-  metadata.gz: 933da4fbd2af467fcbdef33f236019b1ec9f894f01cdc8155aa1342cb8560712fbbab51d7da9380f6890ed00a4ee1f39319f70e333db72c888d7d6ea7e064340
-  data.tar.gz: bdd324b733838060d9e48d8e6be006c7d48cc43f24296869eabe6d5920f26bd77c817662e0dadaf1dda3a0483b79a7e3069cc1612400abf79cf8049f25e09c8c
+  metadata.gz: 9be722db8c3f714e96405be65aeabeb4ecde74ca1a0b2970dba1d0a22485754442f2fc121b83c56bbe951675b493a6dc2d68115d90622041c59cd04578ee098d
+  data.tar.gz: 93704e6bc402ba3dd2e5d21c097b6d358d3d51b739bd18365cb09e72ec6b8b6b4ee960930adc0ead77d952d8b41b5c1b3e546a3fc1a867920244d009a9a4b66e

data/lib/aws-sdk-docdb.rb

@@ -49,6 +49,6 @@ require_relative 'aws-sdk-docdb/customizations'
 # @!group service
 module Aws::DocDB
 
-  GEM_VERSION = '1.23.0'
+  GEM_VERSION = '1.28.0'
 
 end

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

@@ -29,6 +29,7 @@ require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/query.rb'
+require 'aws-sdk-docdb/plugins/cross_region_copying.rb'
 
 Aws::Plugins::GlobalConfiguration.add_identifier(:docdb)
 
@@ -75,6 +76,7 @@ module Aws::DocDB
     add_plugin(Aws::Plugins::HttpChecksum)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::Query)
+    add_plugin(Aws::DocDB::Plugins::CrossRegionCopying)
 
     # @overload initialize(options)
     #   @param [Hash] options
@@ -599,6 +601,10 @@ module Aws::DocDB
     # @option params [Array<Types::Tag>] :tags
     #   The tags to be assigned to the cluster snapshot.
     #
+    # @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.
+    #
     # @return [Types::CopyDBClusterSnapshotResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CopyDBClusterSnapshotResult#db_cluster_snapshot #db_cluster_snapshot} => Types::DBClusterSnapshot
@@ -617,6 +623,7 @@ module Aws::DocDB
     #         value: "String",
     #       },
     #     ],
+    #     source_region: "String",
     #   })
     #
     # @example Response structure
@@ -702,7 +709,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
@@ -775,24 +785,15 @@ module Aws::DocDB
     #
     #   If an encryption key is not specified in `KmsKeyId`\:
     #
-    #   * If `ReplicationSourceIdentifier` identifies an encrypted source,
-    #     then Amazon DocumentDB uses the encryption key that is used to
-    #     encrypt the source. Otherwise, Amazon DocumentDB uses your default
-    #     encryption key.
-    #
-    #   * If the `StorageEncrypted` parameter is `true` and
-    #     `ReplicationSourceIdentifier` is not specified, Amazon DocumentDB
+    #   * If the `StorageEncrypted` parameter is `true`, Amazon DocumentDB
     #     uses your default encryption key.
     #
+    #   ^
+    #
     #   AWS KMS creates the default encryption key for your AWS account. Your
     #   AWS account has a different default encryption key for each AWS
     #   Region.
     #
-    #   If you create a replica of an encrypted cluster in another AWS Region,
-    #   you must set `KmsKeyId` to a KMS key ID that is valid in the
-    #   destination AWS Region. This key is used to encrypt the replica in
-    #   that AWS Region.
-    #
     # @option params [String] :pre_signed_url
     #   Not currently supported.
     #
@@ -813,6 +814,10 @@ module Aws::DocDB
     #   `DeletionProtection` is disabled. `DeletionProtection` protects
     #   clusters from being accidentally deleted.
     #
+    # @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.
+    #
     # @return [Types::CreateDBClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateDBClusterResult#db_cluster #db_cluster} => Types::DBCluster
@@ -844,6 +849,7 @@ module Aws::DocDB
     #     pre_signed_url: "String",
     #     enable_cloudwatch_logs_exports: ["String"],
     #     deletion_protection: false,
+    #     source_region: "String",
     #   })
     #
     # @example Response structure
@@ -4276,7 +4282,7 @@ module Aws::DocDB
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-docdb'
-      context[:gem_version] = '1.23.0'
+      context[:gem_version] = '1.28.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -263,6 +263,7 @@ module Aws::DocDB
     CopyDBClusterSnapshotMessage.add_member(:pre_signed_url, Shapes::ShapeRef.new(shape: String, location_name: "PreSignedUrl"))
     CopyDBClusterSnapshotMessage.add_member(:copy_tags, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "CopyTags"))
     CopyDBClusterSnapshotMessage.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
+    CopyDBClusterSnapshotMessage.add_member(:source_region, Shapes::ShapeRef.new(shape: String, location_name: "SourceRegion"))
     CopyDBClusterSnapshotMessage.struct_class = Types::CopyDBClusterSnapshotMessage
 
     CopyDBClusterSnapshotResult.add_member(:db_cluster_snapshot, Shapes::ShapeRef.new(shape: DBClusterSnapshot, location_name: "DBClusterSnapshot"))
@@ -287,6 +288,7 @@ module Aws::DocDB
     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.add_member(:source_region, Shapes::ShapeRef.new(shape: String, location_name: "SourceRegion"))
     CreateDBClusterMessage.struct_class = Types::CreateDBClusterMessage
 
     CreateDBClusterParameterGroupMessage.add_member(:db_cluster_parameter_group_name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "DBClusterParameterGroupName"))

data/lib/aws-sdk-docdb/plugins/cross_region_copying.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require 'aws-sigv4'
+
+module Aws
+  module DocDB
+    module Plugins
+      # This plugin populates the `:pre_signed_url` request param for APIs
+      # that support cross region copying.
+      #
+      # This parameter is required by RDS when copying an encrypted snapshot
+      # across regions. This plugin will be skipped if the `:pre_signed_url`
+      # parameter is provided by the user.
+      class CrossRegionCopying < Seahorse::Client::Plugin
+        # @api private
+        class Handler < Seahorse::Client::Handler
+          def call(context)
+            params = context.params
+            if params.is_a?(Hash) &&
+               params[:source_region] && !params[:pre_signed_url]
+              params[:pre_signed_url] = presigned_url(context, params)
+            end
+            @handler.call(context)
+          end
+
+          private
+
+          def presigned_url(context, params)
+            # :source_region is not modeled in the api
+            source_region = params.delete(:source_region)
+            param_list = Aws::Query::ParamList.new
+            param_list.set('Action', context.operation.name)
+            param_list.set('DestinationRegion', context.config.region)
+            param_list.set('Version', context.config.api.version)
+            Aws::Query::ParamBuilder.new(param_list).apply(
+              context.operation.input,
+              params
+            )
+            signer = Aws::Sigv4::Signer.new(
+              service: 'rds',
+              region: source_region,
+              credentials_provider: context.config.credentials
+            )
+            url = Aws::Partitions::EndpointProvider.resolve(
+              signer.region, 'rds'
+            )
+            url += "?#{param_list}"
+            signer.presign_url(
+              http_method: 'GET',
+              url: url,
+              expires_in: 3600
+            ).to_s
+          end
+        end
+
+        handler(
+          Handler,
+          step: :initialize,
+          operations: [
+            :copy_db_cluster_snapshot,
+            :create_db_cluster
+          ]
+        )
+      end
+    end
+  end
+end

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

@@ -334,6 +334,7 @@ module Aws::DocDB
     #             value: "String",
     #           },
     #         ],
+    #         source_region: "String",
     #       }
     #
     # @!attribute [rw] source_db_cluster_snapshot_identifier
@@ -438,6 +439,11 @@ module Aws::DocDB
     #   The tags to be assigned to the cluster snapshot.
     #   @return [Array<Types::Tag>]
     #
+    # @!attribute [rw] source_region
+    #   The source region of the snapshot. This is only needed when the
+    #   shapshot is encrypted and in a different region.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/CopyDBClusterSnapshotMessage AWS API Documentation
     #
     class CopyDBClusterSnapshotMessage < Struct.new(
@@ -446,7 +452,8 @@ module Aws::DocDB
       :kms_key_id,
       :pre_signed_url,
       :copy_tags,
-      :tags)
+      :tags,
+      :source_region)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -493,6 +500,7 @@ module Aws::DocDB
     #         pre_signed_url: "String",
     #         enable_cloudwatch_logs_exports: ["String"],
     #         deletion_protection: false,
+    #         source_region: "String",
     #       }
     #
     # @!attribute [rw] availability_zones
@@ -553,7 +561,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
@@ -634,23 +645,14 @@ module Aws::DocDB
     #
     #   If an encryption key is not specified in `KmsKeyId`\:
     #
-    #   * If `ReplicationSourceIdentifier` identifies an encrypted source,
-    #     then Amazon DocumentDB uses the encryption key that is used to
-    #     encrypt the source. Otherwise, Amazon DocumentDB uses your default
-    #     encryption key.
-    #
-    #   * If the `StorageEncrypted` parameter is `true` and
-    #     `ReplicationSourceIdentifier` is not specified, Amazon DocumentDB
+    #   * If the `StorageEncrypted` parameter is `true`, Amazon DocumentDB
     #     uses your default encryption key.
     #
+    #   ^
+    #
     #   AWS KMS creates the default encryption key for your AWS account.
     #   Your AWS account has a different default encryption key for each AWS
     #   Region.
-    #
-    #   If you create a replica of an encrypted cluster in another AWS
-    #   Region, you must set `KmsKeyId` to a KMS key ID that is valid in the
-    #   destination AWS Region. This key is used to encrypt the replica in
-    #   that AWS Region.
     #   @return [String]
     #
     # @!attribute [rw] pre_signed_url
@@ -677,6 +679,11 @@ module Aws::DocDB
     #   deleted.
     #   @return [Boolean]
     #
+    # @!attribute [rw] source_region
+    #   The source region of the snapshot. This is only needed when the
+    #   shapshot is encrypted and in a different region.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/docdb-2014-10-31/CreateDBClusterMessage AWS API Documentation
     #
     class CreateDBClusterMessage < Struct.new(
@@ -698,7 +705,8 @@ module Aws::DocDB
       :kms_key_id,
       :pre_signed_url,
       :enable_cloudwatch_logs_exports,
-      :deletion_protection)
+      :deletion_protection,
+      :source_region)
       SENSITIVE = []
       include Aws::Structure
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-docdb
 version: !ruby/object:Gem::Version
-  version: 1.23.0
+  version: 1.28.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-15 00:00:00.000000000 Z
+date: 2021-02-02 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.112.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.112.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement
@@ -57,6 +57,7 @@ files:
 - lib/aws-sdk-docdb/client_api.rb
 - lib/aws-sdk-docdb/customizations.rb
 - lib/aws-sdk-docdb/errors.rb
+- lib/aws-sdk-docdb/plugins/cross_region_copying.rb
 - lib/aws-sdk-docdb/resource.rb
 - lib/aws-sdk-docdb/types.rb
 - lib/aws-sdk-docdb/waiters.rb