client.rb in aws-sdk-rds-1.138.0

- old
+ new

@@ -1863,14 +1863,19 @@
       req = build_request(:create_custom_availability_zone, params)
       req.send_request(options)
     end
 
     # Creates a custom DB engine version (CEV). A CEV is a binary volume
-    # snapshot of a database engine and specific AMI. The only supported
-    # engine is Oracle Database 19c Enterprise Edition with the January 2021
-    # or later RU/RUR.
+    # snapshot of a database engine and specific AMI. The supported engines
+    # are the following:
     #
+    # * Oracle Database 12.1 Enterprise Edition with the January 2021 or
+    #   later RU/RUR
+    #
+    # * Oracle Database 19c Enterprise Edition with the January 2021 or
+    #   later RU/RUR
+    #
     # Amazon RDS, which is a fully managed service, supplies the Amazon
     # Machine Image (AMI) and database software. The Amazon RDS database
     # software is preinstalled, so you need only select a DB engine and
     # version, and create your database. With Amazon RDS Custom for Oracle,
     # you upload your database installation files in Amazon S3.
@@ -2203,11 +2208,11 @@
     #   This setting is required to create a Multi-AZ DB cluster.
     #
     #   Constraints: Must match the name of an existing DBSubnetGroup. Must
     #   not be default.
     #
-    #   Example: `mySubnetgroup`
+    #   Example: `mydbsubnetgroup`
     #
     #   Valid for: Aurora DB clusters and Multi-AZ DB clusters
     #
     # @option params [required, String] :engine
     #   The name of the database engine to be used for this DB cluster.
@@ -3792,12 +3797,15 @@
     #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/RDSonVMwareUserGuide/rds-on-vmware.html
     #
     # @option params [String] :db_subnet_group_name
     #   A DB subnet group to associate with this DB instance.
     #
-    #   If there is no DB subnet group, then it is a non-VPC DB instance.
+    #   Constraints: Must match the name of an existing DBSubnetGroup. Must
+    #   not be default.
     #
+    #   Example: `mydbsubnetgroup`
+    #
     # @option params [String] :preferred_maintenance_window
     #   The time range each week during which system maintenance can occur, in
     #   Universal Coordinated Time (UTC). For more information, see [Amazon
     #   RDS Maintenance Window][1].
     #
@@ -4854,11 +4862,11 @@
     #       replicas are created in the same VPC.
     #
     #     * Not specify a DB subnet group. All these read replicas are created
     #       outside of any VPC.
     #
-    #   Example: `mySubnetgroup`
+    #   Example: `mydbsubnetgroup`
     #
     # @option params [Array<String>] :vpc_security_group_ids
     #   A list of Amazon EC2 VPC security groups to associate with the read
     #   replica.
     #
@@ -5962,15 +5970,21 @@
     #
     # @option params [required, String] :db_subnet_group_name
     #   The name for the DB subnet group. This value is stored as a lowercase
     #   string.
     #
-    #   Constraints: Must contain no more than 255 letters, numbers, periods,
-    #   underscores, spaces, or hyphens. Must not be default.
+    #   Constraints:
     #
-    #   Example: `mySubnetgroup`
+    #   * Must contain no more than 255 letters, numbers, periods,
+    #     underscores, spaces, or hyphens.
     #
+    #   * Must not be default.
+    #
+    #   * First character must be a letter.
+    #
+    #   Example: `mydbsubnetgroup`
+    #
     # @option params [required, String] :db_subnet_group_description
     #   The description for the DB subnet group.
     #
     # @option params [required, Array<String>] :subnet_ids
     #   The EC2 Subnet IDs for the DB subnet group.
@@ -7632,16 +7646,14 @@
     #
     #   <note markdown="1"> You can't delete the default subnet group.
     #
     #    </note>
     #
-    #   Constraints:
-    #
     #   Constraints: Must match the name of an existing DBSubnetGroup. Must
     #   not be default.
     #
-    #   Example: `mySubnetgroup`
+    #   Example: `mydbsubnetgroup`
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     #
     # @example Example: To delete a DB subnet group.
@@ -14323,11 +14335,11 @@
     #   This parameter doesn't apply to RDS Custom.
     #
     #   Constraints: If supplied, must match the name of an existing
     #   DBSubnetGroup.
     #
-    #   Example: `mySubnetGroup`
+    #   Example: `mydbsubnetgroup`
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html#USER_VPC.Non-VPC2VPC
     #
@@ -15849,11 +15861,11 @@
     #   string. You can't modify the default subnet group.
     #
     #   Constraints: Must match the name of an existing DBSubnetGroup. Must
     #   not be default.
     #
-    #   Example: `mySubnetgroup`
+    #   Example: `mydbsubnetgroup`
     #
     # @option params [String] :db_subnet_group_description
     #   The description for the DB subnet group.
     #
     # @option params [required, Array<String>] :subnet_ids
@@ -17689,11 +17701,11 @@
     #   A DB subnet group to associate with the restored DB cluster.
     #
     #   Constraints: If supplied, must match the name of an existing
     #   DBSubnetGroup.
     #
-    #   Example: `mySubnetgroup`
+    #   Example: `mydbsubnetgroup`
     #
     # @option params [required, String] :engine
     #   The name of the database engine to be used for this DB cluster.
     #
     #   Valid Values: `aurora` (for MySQL 5.6-compatible Aurora),
@@ -18236,11 +18248,11 @@
     #   The name of the DB subnet group to use for the new DB cluster.
     #
     #   Constraints: If supplied, must match the name of an existing DB subnet
     #   group.
     #
-    #   Example: `mySubnetgroup`
+    #   Example: `mydbsubnetgroup`
     #
     #   Valid for: Aurora DB clusters and Multi-AZ DB clusters
     #
     # @option params [String] :database_name
     #   The database name for the restored DB cluster.
@@ -18782,11 +18794,11 @@
     #   The DB subnet group name to use for the new DB cluster.
     #
     #   Constraints: If supplied, must match the name of an existing
     #   DBSubnetGroup.
     #
-    #   Example: `mySubnetgroup`
+    #   Example: `mydbsubnetgroup`
     #
     #   Valid for: Aurora DB clusters and Multi-AZ DB clusters
     #
     # @option params [String] :option_group_name
     #   The name of the option group for the new DB cluster.
@@ -19290,11 +19302,11 @@
     #   The DB subnet group name to use for the new instance.
     #
     #   Constraints: If supplied, must match the name of an existing
     #   DBSubnetGroup.
     #
-    #   Example: `mySubnetgroup`
+    #   Example: `mydbsubnetgroup`
     #
     # @option params [Boolean] :multi_az
     #   A value that indicates whether the DB instance is a Multi-AZ
     #   deployment.
     #
@@ -19457,13 +19469,26 @@
     #
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
     #
     # @option params [Boolean] :copy_tags_to_snapshot
     #   A value that indicates whether to copy all tags from the restored DB
-    #   instance to snapshots of the DB instance. By default, tags are not
-    #   copied.
+    #   instance to snapshots of the DB instance.
     #
+    #   In most cases, tags aren't copied by default. However, when you
+    #   restore a DB instance from a DB snapshot, RDS checks whether you
+    #   specify new tags. If yes, the new tags are added to the restored DB
+    #   instance. If there are no new tags, RDS looks for the tags from the
+    #   source DB instance for the DB snapshot, and then adds those tags to
+    #   the restored DB instance.
+    #
+    #   For more information, see [ Copying tags to DB instance snapshots][1]
+    #   in the *Amazon RDS User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html#USER_Tagging.CopyTags
+    #
     # @option params [String] :domain_iam_role_name
     #   Specify the name of the IAM role to be used when making API calls to
     #   the Directory Service.
     #
     #   This setting doesn't apply to RDS Custom.
@@ -19570,12 +19595,11 @@
     #
     #   * The instance profile name and the associated IAM role name must
     #     start with the prefix `AWSRDSCustom`.
     #
     #   For the list of permissions required for the IAM role, see [ Configure
-    #   IAM and your VPC][1] in the *Amazon Relational Database Service User
-    #   Guide*.
+    #   IAM and your VPC][1] in the *Amazon RDS User Guide*.
     #
     #   This setting is required for RDS Custom.
     #
     #
     #
@@ -19994,10 +20018,15 @@
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html
     #
     # @option params [String] :db_subnet_group_name
     #   A DB subnet group to associate with this DB instance.
     #
+    #   Constraints: If supplied, must match the name of an existing
+    #   DBSubnetGroup.
+    #
+    #   Example: `mydbsubnetgroup`
+    #
     # @option params [String] :preferred_maintenance_window
     #   The time range each week during which system maintenance can occur, in
     #   Universal Coordinated Time (UTC). For more information, see [Amazon
     #   RDS Maintenance Window][1] in the *Amazon RDS User Guide.*
     #
@@ -20583,11 +20612,11 @@
     #   The DB subnet group name to use for the new instance.
     #
     #   Constraints: If supplied, must match the name of an existing
     #   DBSubnetGroup.
     #
-    #   Example: `mySubnetgroup`
+    #   Example: `mydbsubnetgroup`
     #
     # @option params [Boolean] :multi_az
     #   A value that indicates whether the DB instance is a Multi-AZ
     #   deployment.
     #
@@ -22355,10 +22384,10 @@
         operation: config.api.operation(operation_name),
         client: self,
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-rds'
-      context[:gem_version] = '1.137.0'
+      context[:gem_version] = '1.138.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 
     # Polls an API operation until a resource enters a desired state.
     #