aws-sdk-rds 1.158.0 → 1.159.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8e186d04149b250192c3d9ba9411e0fdd98df46f8b22d8577b00b4515bf6a7ad
-  data.tar.gz: 26658f6fe17e7508f75ea2f70fcbd0288384f09794df3bc0a9f26112b592e12d
+  metadata.gz: f6ccd836131c67f7bccab927d6f2e1a1bcdf4cfa1f18ebdee1e3d6cd03e1e76c
+  data.tar.gz: 3d4e46ae22d3f8ee83727c2fd62f7d079363f77615b19082279265a44e3eecd2
 SHA512:
-  metadata.gz: 6380d4878ccb2fa2b7670372f4b46899dc912067b17208eed0f76f45b00253d2a4425b10c54d8c60217119247976d5bb5844c51cc3016bed6270ccc2e12d87e8
-  data.tar.gz: 197df34651d0be8eb3be089c752067586c8eb3cbdb9e0fa154ed59928ef672e14dc8204d501b0267b646893552996f7359930fc3cb146ac84223a272e233d4d7
+  metadata.gz: a1230ccc9f46122d10bbcb2461fbaec11608453afbb1ff9edb6a27eb0e6fb2c6c7c499171f4a7301d25be4db1b1a42af1aac32889a7b2df75f1c66c3803df95c
+  data.tar.gz: a1cd670ddb5c1d98cdbfb0c8c8a22b3b4ef0d9e68c7841ae9054e7b62211a650cedd2353fe21e4e845c356be9e372db0c27a2869eaa1b5b142f55d9ddb10dff5

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.159.0 (2022-11-14)
+------------------
+
+* Feature - This release adds support for restoring an RDS Multi-AZ DB cluster snapshot to a Single-AZ deployment or a Multi-AZ DB instance deployment.
+
 1.158.0 (2022-11-01)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.158.0
+1.159.0

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

@@ -4520,6 +4520,8 @@ module Aws::RDS
     # @option params [Integer] :storage_throughput
     #   Specifies the storage throughput value for the DB instance.
     #
+    #   This setting applies only to the `gp3` storage type.
+    #
     #   This setting doesn't apply to RDS Custom or Amazon Aurora.
     #
     # @return [Types::CreateDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -15289,6 +15291,8 @@ module Aws::RDS
     # @option params [Integer] :storage_throughput
     #   Specifies the storage throughput value for the DB instance.
     #
+    #   This setting applies only to the `gp3` storage type.
+    #
     #   This setting doesn't apply to RDS Custom or Amazon Aurora.
     #
     # @return [Types::ModifyDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -19666,13 +19670,18 @@ module Aws::RDS
     #
     #   Example: `my-snapshot-id`
     #
-    # @option params [required, String] :db_snapshot_identifier
+    # @option params [String] :db_snapshot_identifier
     #   The identifier for the DB snapshot to restore from.
     #
     #   Constraints:
     #
     #   * Must match the identifier of an existing DBSnapshot.
     #
+    #   * Can't be specified when `DBClusterSnapshotIdentifier` is specified.
+    #
+    #   * Must be specified when `DBClusterSnapshotIdentifier` isn't
+    #     specified.
+    #
     #   * If you are restoring from a shared manual DB snapshot, the
     #     `DBSnapshotIdentifier` must be the ARN of the shared DB snapshot.
     #
@@ -20051,6 +20060,36 @@ module Aws::RDS
     #
     #   This setting doesn't apply to RDS Custom or Amazon Aurora.
     #
+    # @option params [String] :db_cluster_snapshot_identifier
+    #   The identifier for the RDS for MySQL Multi-AZ DB cluster snapshot to
+    #   restore from.
+    #
+    #   For more information on Multi-AZ DB clusters, see [ Multi-AZ
+    #   deployments with two readable standby DB instances][1] in the *Amazon
+    #   RDS User Guide*.
+    #
+    #   Constraints:
+    #
+    #   * Must match the identifier of an existing Multi-AZ DB cluster
+    #     snapshot.
+    #
+    #   * Can't be specified when `DBSnapshotIdentifier` is specified.
+    #
+    #   * Must be specified when `DBSnapshotIdentifier` isn't specified.
+    #
+    #   * If you are restoring from a shared manual Multi-AZ DB cluster
+    #     snapshot, the `DBClusterSnapshotIdentifier` must be the ARN of the
+    #     shared snapshot.
+    #
+    #   * Can't be the identifier of an Aurora DB cluster snapshot.
+    #
+    #   * Can't be the identifier of an RDS for PostgreSQL Multi-AZ DB
+    #     cluster snapshot.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
+    #
     # @return [Types::RestoreDBInstanceFromDBSnapshotResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::RestoreDBInstanceFromDBSnapshotResult#db_instance #db_instance} => Types::DBInstance
@@ -20154,7 +20193,7 @@ module Aws::RDS
     #
     #   resp = client.restore_db_instance_from_db_snapshot({
     #     db_instance_identifier: "String", # required
-    #     db_snapshot_identifier: "String", # required
+    #     db_snapshot_identifier: "String",
     #     db_instance_class: "String",
     #     port: 1,
     #     availability_zone: "String",
@@ -20196,6 +20235,7 @@ module Aws::RDS
     #     backup_target: "String",
     #     network_type: "String",
     #     storage_throughput: 1,
+    #     db_cluster_snapshot_identifier: "String",
     #   })
     #
     # @example Response structure
@@ -23149,7 +23189,7 @@ module Aws::RDS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-rds'
-      context[:gem_version] = '1.158.0'
+      context[:gem_version] = '1.159.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -3105,7 +3105,7 @@ module Aws::RDS
     RestoreDBClusterToPointInTimeResult.struct_class = Types::RestoreDBClusterToPointInTimeResult
 
     RestoreDBInstanceFromDBSnapshotMessage.add_member(:db_instance_identifier, Shapes::ShapeRef.new(shape: String, required: true, location_name: "DBInstanceIdentifier"))
-    RestoreDBInstanceFromDBSnapshotMessage.add_member(:db_snapshot_identifier, Shapes::ShapeRef.new(shape: String, required: true, location_name: "DBSnapshotIdentifier"))
+    RestoreDBInstanceFromDBSnapshotMessage.add_member(:db_snapshot_identifier, Shapes::ShapeRef.new(shape: String, location_name: "DBSnapshotIdentifier"))
     RestoreDBInstanceFromDBSnapshotMessage.add_member(:db_instance_class, Shapes::ShapeRef.new(shape: String, location_name: "DBInstanceClass"))
     RestoreDBInstanceFromDBSnapshotMessage.add_member(:port, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "Port"))
     RestoreDBInstanceFromDBSnapshotMessage.add_member(:availability_zone, Shapes::ShapeRef.new(shape: String, location_name: "AvailabilityZone"))
@@ -3137,6 +3137,7 @@ module Aws::RDS
     RestoreDBInstanceFromDBSnapshotMessage.add_member(:backup_target, Shapes::ShapeRef.new(shape: String, location_name: "BackupTarget"))
     RestoreDBInstanceFromDBSnapshotMessage.add_member(:network_type, Shapes::ShapeRef.new(shape: String, location_name: "NetworkType"))
     RestoreDBInstanceFromDBSnapshotMessage.add_member(:storage_throughput, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "StorageThroughput"))
+    RestoreDBInstanceFromDBSnapshotMessage.add_member(:db_cluster_snapshot_identifier, Shapes::ShapeRef.new(shape: String, location_name: "DBClusterSnapshotIdentifier"))
     RestoreDBInstanceFromDBSnapshotMessage.struct_class = Types::RestoreDBInstanceFromDBSnapshotMessage
 
     RestoreDBInstanceFromDBSnapshotResult.add_member(:db_instance, Shapes::ShapeRef.new(shape: DBInstance, location_name: "DBInstance"))
@@ -5139,6 +5140,7 @@ module Aws::RDS
         o.errors << Shapes::ShapeRef.new(shape: DBParameterGroupNotFoundFault)
         o.errors << Shapes::ShapeRef.new(shape: BackupPolicyNotFoundFault)
         o.errors << Shapes::ShapeRef.new(shape: NetworkTypeNotSupported)
+        o.errors << Shapes::ShapeRef.new(shape: DBClusterSnapshotNotFoundFault)
       end)
 
       api.add_operation(:restore_db_instance_from_s3, Seahorse::Model::Operation.new.tap do |o|

data/lib/aws-sdk-rds/db_instance.rb

@@ -726,6 +726,8 @@ module Aws::RDS
     end
 
     # Specifies the storage throughput for the DB instance.
+    #
+    # This setting applies only to the `gp3` storage type.
     # @return [Integer]
     def storage_throughput
       data[:storage_throughput]
@@ -1968,6 +1970,8 @@ module Aws::RDS
     # @option options [Integer] :storage_throughput
     #   Specifies the storage throughput value for the DB instance.
     #
+    #   This setting applies only to the `gp3` storage type.
+    #
     #   This setting doesn't apply to RDS Custom or Amazon Aurora.
     # @return [DBInstance]
     def create(options = {})
@@ -3445,6 +3449,8 @@ module Aws::RDS
     # @option options [Integer] :storage_throughput
     #   Specifies the storage throughput value for the DB instance.
     #
+    #   This setting applies only to the `gp3` storage type.
+    #
     #   This setting doesn't apply to RDS Custom or Amazon Aurora.
     # @return [DBInstance]
     def modify(options = {})

data/lib/aws-sdk-rds/db_snapshot.rb

@@ -660,6 +660,7 @@ module Aws::RDS
     #     backup_target: "String",
     #     network_type: "String",
     #     storage_throughput: 1,
+    #     db_cluster_snapshot_identifier: "String",
     #   })
     # @param [Hash] options ({})
     # @option options [required, String] :db_instance_identifier
@@ -1019,6 +1020,35 @@ module Aws::RDS
     #   Specifies the storage throughput value for the DB instance.
     #
     #   This setting doesn't apply to RDS Custom or Amazon Aurora.
+    # @option options [String] :db_cluster_snapshot_identifier
+    #   The identifier for the RDS for MySQL Multi-AZ DB cluster snapshot to
+    #   restore from.
+    #
+    #   For more information on Multi-AZ DB clusters, see [ Multi-AZ
+    #   deployments with two readable standby DB instances][1] in the *Amazon
+    #   RDS User Guide*.
+    #
+    #   Constraints:
+    #
+    #   * Must match the identifier of an existing Multi-AZ DB cluster
+    #     snapshot.
+    #
+    #   * Can't be specified when `DBSnapshotIdentifier` is specified.
+    #
+    #   * Must be specified when `DBSnapshotIdentifier` isn't specified.
+    #
+    #   * If you are restoring from a shared manual Multi-AZ DB cluster
+    #     snapshot, the `DBClusterSnapshotIdentifier` must be the ARN of the
+    #     shared snapshot.
+    #
+    #   * Can't be the identifier of an Aurora DB cluster snapshot.
+    #
+    #   * Can't be the identifier of an RDS for PostgreSQL Multi-AZ DB
+    #     cluster snapshot.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
     # @return [DBInstance]
     def restore(options = {})
       options = options.merge(db_snapshot_identifier: @snapshot_id)

data/lib/aws-sdk-rds/resource.rb

@@ -2045,6 +2045,8 @@ module Aws::RDS
     # @option options [Integer] :storage_throughput
     #   Specifies the storage throughput value for the DB instance.
     #
+    #   This setting applies only to the `gp3` storage type.
+    #
     #   This setting doesn't apply to RDS Custom or Amazon Aurora.
     # @return [DBInstance]
     def create_db_instance(options = {})

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

@@ -4224,6 +4224,8 @@ module Aws::RDS
     # @!attribute [rw] storage_throughput
     #   Specifies the storage throughput value for the DB instance.
     #
+    #   This setting applies only to the `gp3` storage type.
+    #
     #   This setting doesn't apply to RDS Custom or Amazon Aurora.
     #   @return [Integer]
     #
@@ -7970,6 +7972,8 @@ module Aws::RDS
     #
     # @!attribute [rw] storage_throughput
     #   Specifies the storage throughput for the DB instance.
+    #
+    #   This setting applies only to the `gp3` storage type.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBInstance AWS API Documentation
@@ -16687,6 +16691,8 @@ module Aws::RDS
     # @!attribute [rw] storage_throughput
     #   Specifies the storage throughput value for the DB instance.
     #
+    #   This setting applies only to the `gp3` storage type.
+    #
     #   This setting doesn't apply to RDS Custom or Amazon Aurora.
     #   @return [Integer]
     #
@@ -21322,7 +21328,7 @@ module Aws::RDS
     #
     #       {
     #         db_instance_identifier: "String", # required
-    #         db_snapshot_identifier: "String", # required
+    #         db_snapshot_identifier: "String",
     #         db_instance_class: "String",
     #         port: 1,
     #         availability_zone: "String",
@@ -21364,6 +21370,7 @@ module Aws::RDS
     #         backup_target: "String",
     #         network_type: "String",
     #         storage_throughput: 1,
+    #         db_cluster_snapshot_identifier: "String",
     #       }
     #
     # @!attribute [rw] db_instance_identifier
@@ -21388,6 +21395,12 @@ module Aws::RDS
     #
     #   * Must match the identifier of an existing DBSnapshot.
     #
+    #   * Can't be specified when `DBClusterSnapshotIdentifier` is
+    #     specified.
+    #
+    #   * Must be specified when `DBClusterSnapshotIdentifier` isn't
+    #     specified.
+    #
     #   * If you are restoring from a shared manual DB snapshot, the
     #     `DBSnapshotIdentifier` must be the ARN of the shared DB snapshot.
     #   @return [String]
@@ -21803,6 +21816,37 @@ module Aws::RDS
     #   This setting doesn't apply to RDS Custom or Amazon Aurora.
     #   @return [Integer]
     #
+    # @!attribute [rw] db_cluster_snapshot_identifier
+    #   The identifier for the RDS for MySQL Multi-AZ DB cluster snapshot to
+    #   restore from.
+    #
+    #   For more information on Multi-AZ DB clusters, see [ Multi-AZ
+    #   deployments with two readable standby DB instances][1] in the
+    #   *Amazon RDS User Guide*.
+    #
+    #   Constraints:
+    #
+    #   * Must match the identifier of an existing Multi-AZ DB cluster
+    #     snapshot.
+    #
+    #   * Can't be specified when `DBSnapshotIdentifier` is specified.
+    #
+    #   * Must be specified when `DBSnapshotIdentifier` isn't specified.
+    #
+    #   * If you are restoring from a shared manual Multi-AZ DB cluster
+    #     snapshot, the `DBClusterSnapshotIdentifier` must be the ARN of the
+    #     shared snapshot.
+    #
+    #   * Can't be the identifier of an Aurora DB cluster snapshot.
+    #
+    #   * Can't be the identifier of an RDS for PostgreSQL Multi-AZ DB
+    #     cluster snapshot.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromDBSnapshotMessage AWS API Documentation
     #
     class RestoreDBInstanceFromDBSnapshotMessage < Struct.new(
@@ -21838,7 +21882,8 @@ module Aws::RDS
       :custom_iam_instance_profile,
       :backup_target,
       :network_type,
-      :storage_throughput)
+      :storage_throughput,
+      :db_cluster_snapshot_identifier)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-rds.rb

@@ -78,6 +78,6 @@ require_relative 'aws-sdk-rds/customizations'
 # @!group service
 module Aws::RDS
 
-  GEM_VERSION = '1.158.0'
+  GEM_VERSION = '1.159.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-rds
 version: !ruby/object:Gem::Version
-  version: 1.158.0
+  version: 1.159.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-11-01 00:00:00.000000000 Z
+date: 2022-11-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sigv4