aws-sdk-rds 1.80.0 → 1.81.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 8412e671c9a5bb116740036953f0b0c2d3109f99
-  data.tar.gz: 8907b7ec70f15faf1bbc94cf3cba60b68138bceb
+SHA256:
+  metadata.gz: 4e8c606af17f5430ae114d3187bbb3d6765745451dc86490217f274558eaa114
+  data.tar.gz: daaf09a3da9ccb76ceb98890d9af229a4fab4e190706924b353553b21252dbac
 SHA512:
-  metadata.gz: 82e0ff97d18b4c6263ba8cc9a0aeb3ded05ff364988c9223deb47f18e2f7f4dbe0cbf181cbb9c8904bf19cec5549c2199ef016df6166cc90f545474d7aa5dc76
-  data.tar.gz: 38c1d72cf7e555bc99ebdc451d9e30f512bab0a1edbdac584ba7dbb235b5cab9593d151fe5bada44a8ec922bea7764b1c22ac1969f083d417d6057af99d4cc3e
+  metadata.gz: 9d190c2df3961e67639b40e375d7be5834460c7e13da6fb0169b83080fc81fdfceae46afb8d1931025785d1c678304234eaa27c0a3d916d2b36d0829668a3cdc
+  data.tar.gz: 91414fa46e4c6d1abf085f83c568146f191374df33867893bf7e91fe77996343f731f463a7f6373b979418bee32e19aeb0b5f94252943c69f53ae07c14888477

data/lib/aws-sdk-rds.rb

@@ -71,6 +71,6 @@ require_relative 'aws-sdk-rds/customizations'
 # @service
 module Aws::RDS
 
-  GEM_VERSION = '1.80.0'
+  GEM_VERSION = '1.81.0'
 
 end

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

@@ -80,7 +80,8 @@ module Aws::RDS
     # Waiter polls an API operation until a resource enters a desired
     # state.
     #
-    # @note The waiting operation is performed on a copy. The original resource remains unchanged
+    # @note The waiting operation is performed on a copy. The original resource
+    #   remains unchanged.
     #
     # ## Basic Usage
     #
@@ -93,13 +94,15 @@ module Aws::RDS
     #
     # ## Example
     #
-    #     instance.wait_until(max_attempts:10, delay:5) {|instance| instance.state.name == 'running' }
+    #     instance.wait_until(max_attempts:10, delay:5) do |instance|
+    #       instance.state.name == 'running'
+    #     end
     #
     # ## Configuration
     #
     # You can configure the maximum number of polling attempts, and the
-    # delay (in seconds) between each polling attempt. The waiting condition is set
-    # by passing a block to {#wait_until}:
+    # delay (in seconds) between each polling attempt. The waiting condition is
+    # set by passing a block to {#wait_until}:
     #
     #     # poll for ~25 seconds
     #     resource.wait_until(max_attempts:5,delay:5) {|resource|...}
@@ -130,17 +133,16 @@ module Aws::RDS
     #       # resource did not enter the desired state in time
     #     end
     #
+    # @yieldparam [Resource] resource to be used in the waiting condition.
     #
-    # @yield param [Resource] resource to be used in the waiting condition
-    #
-    # @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter terminates
-    #   because the waiter has entered a state that it will not transition
-    #   out of, preventing success.
+    # @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter
+    #   terminates because the waiter has entered a state that it will not
+    #   transition out of, preventing success.
     #
     #   yet successful.
     #
-    # @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is encountered
-    #   while polling for a resource that is not expected.
+    # @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is
+    #   encountered while polling for a resource that is not expected.
     #
     # @raise [NotImplementedError] Raised when the resource does not
     #

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

@@ -116,7 +116,8 @@ module Aws::RDS
     # Waiter polls an API operation until a resource enters a desired
     # state.
     #
-    # @note The waiting operation is performed on a copy. The original resource remains unchanged
+    # @note The waiting operation is performed on a copy. The original resource
+    #   remains unchanged.
     #
     # ## Basic Usage
     #
@@ -129,13 +130,15 @@ module Aws::RDS
     #
     # ## Example
     #
-    #     instance.wait_until(max_attempts:10, delay:5) {|instance| instance.state.name == 'running' }
+    #     instance.wait_until(max_attempts:10, delay:5) do |instance|
+    #       instance.state.name == 'running'
+    #     end
     #
     # ## Configuration
     #
     # You can configure the maximum number of polling attempts, and the
-    # delay (in seconds) between each polling attempt. The waiting condition is set
-    # by passing a block to {#wait_until}:
+    # delay (in seconds) between each polling attempt. The waiting condition is
+    # set by passing a block to {#wait_until}:
     #
     #     # poll for ~25 seconds
     #     resource.wait_until(max_attempts:5,delay:5) {|resource|...}
@@ -166,17 +169,16 @@ module Aws::RDS
     #       # resource did not enter the desired state in time
     #     end
     #
+    # @yieldparam [Resource] resource to be used in the waiting condition.
     #
-    # @yield param [Resource] resource to be used in the waiting condition
-    #
-    # @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter terminates
-    #   because the waiter has entered a state that it will not transition
-    #   out of, preventing success.
+    # @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter
+    #   terminates because the waiter has entered a state that it will not
+    #   transition out of, preventing success.
     #
     #   yet successful.
     #
-    # @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is encountered
-    #   while polling for a resource that is not expected.
+    # @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is
+    #   encountered while polling for a resource that is not expected.
     #
     # @raise [NotImplementedError] Raised when the resource does not
     #

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

@@ -271,8 +271,7 @@ module Aws::RDS
     #
     #   @option options [Integer] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
-    #     safely be set
-    #     per-request on the session yielded by {#session_for}.
+    #     safely be set per-request on the session.
     #
     #   @option options [Float] :http_idle_timeout (5) The number of
     #     seconds a connection is allowed to sit idle before it is
@@ -284,7 +283,7 @@ module Aws::RDS
     #     request body.  This option has no effect unless the request has
     #     "Expect" header set to "100-continue".  Defaults to `nil` which
     #     disables this behaviour.  This value can safely be set per
-    #     request on the session yielded by {#session_for}.
+    #     request on the session.
     #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
@@ -1140,7 +1139,7 @@ module Aws::RDS
     #   encrypted DB cluster snapshot in the same AWS Region.
     #
     #   The pre-signed URL must be a valid request for the
-    #   `CopyDBSClusterSnapshot` API action that can be executed in the source
+    #   `CopyDBClusterSnapshot` API action that can be executed in the source
     #   AWS Region that contains the encrypted DB cluster snapshot to be
     #   copied. The pre-signed URL request must contain the following
     #   parameter values:
@@ -1804,7 +1803,7 @@ module Aws::RDS
     # Creates a new Amazon Aurora DB cluster.
     #
     # You can use the `ReplicationSourceIdentifier` parameter to create the
-    # DB cluster as a Read Replica of another DB cluster or Amazon RDS MySQL
+    # DB cluster as a read replica of another DB cluster or Amazon RDS MySQL
     # DB instance. For cross-region replication where the DB cluster
     # identified by `ReplicationSourceIdentifier` is encrypted, you must
     # also specify the `PreSignedUrl` parameter.
@@ -2001,7 +2000,7 @@ module Aws::RDS
     #
     # @option params [String] :replication_source_identifier
     #   The Amazon Resource Name (ARN) of the source DB instance or DB cluster
-    #   if this DB cluster is created as a Read Replica.
+    #   if this DB cluster is created as a read replica.
     #
     # @option params [Array<Types::Tag>] :tags
     #   Tags to assign to the DB cluster.
@@ -2032,9 +2031,9 @@ module Aws::RDS
     #   AWS account has a different default encryption key for each AWS
     #   Region.
     #
-    #   If you create a Read Replica of an encrypted DB cluster in another AWS
+    #   If you create a read replica of an encrypted DB 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 Read Replica
+    #   destination AWS Region. This key is used to encrypt the read replica
     #   in that AWS Region.
     #
     # @option params [String] :pre_signed_url
@@ -2057,8 +2056,8 @@ module Aws::RDS
     #     action that is called in the destination AWS Region, and the action
     #     contained in the pre-signed URL.
     #
-    #   * `DestinationRegion` - The name of the AWS Region that Aurora Read
-    #     Replica will be created in.
+    #   * `DestinationRegion` - The name of the AWS Region that Aurora read
+    #     replica will be created in.
     #
     #   * `ReplicationSourceIdentifier` - The DB cluster identifier for the
     #     encrypted DB cluster to be copied. This identifier must be in the
@@ -2124,6 +2123,12 @@ module Aws::RDS
     #   The DB engine mode of the DB cluster, either `provisioned`,
     #   `serverless`, `parallelquery`, `global`, or `multimaster`.
     #
+    #   <note markdown="1"> `global` engine mode only applies for global database clusters created
+    #   with Aurora MySQL version 5.6.10a. For higher Aurora MySQL versions,
+    #   the clusters in a global database use `provisioned` engine mode.
+    #
+    #    </note>
+    #
     #   Limitations and requirements apply to some DB engine modes. For more
     #   information, see the following sections in the *Amazon Aurora User
     #   Guide*\:
@@ -2182,12 +2187,12 @@ module Aws::RDS
     #
     #   For Amazon Aurora DB clusters, Amazon RDS can use Kerberos
     #   Authentication to authenticate users that connect to the DB cluster.
-    #   For more information, see [Using Kerberos Authentication for Aurora
-    #   MySQL][1] in the *Amazon Aurora User Guide*.
+    #   For more information, see [Kerberos Authentication][1] in the *Amazon
+    #   Aurora User Guide*.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurmysql-kerberos.html
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/kerberos-authentication.html
     #
     # @option params [String] :domain_iam_role_name
     #   Specify the name of the IAM role to be used when making API calls to
@@ -3096,7 +3101,7 @@ module Aws::RDS
     #
     #   * Must be a value from 0 to 35
     #
-    #   * Can't be set to 0 if the DB instance is a source to Read Replicas
+    #   * Can't be set to 0 if the DB instance is a source to read replicas
     #
     # @option params [String] :preferred_backup_window
     #   The daily time range during which automated backups are created if
@@ -3136,7 +3141,7 @@ module Aws::RDS
     #
     #   Default: `3306`
     #
-    #   Valid Values: `1150-65535`
+    #   Valid values: `1150-65535`
     #
     #   Type: Integer
     #
@@ -3144,7 +3149,7 @@ module Aws::RDS
     #
     #   Default: `3306`
     #
-    #   Valid Values: `1150-65535`
+    #   Valid values: `1150-65535`
     #
     #   Type: Integer
     #
@@ -3152,7 +3157,7 @@ module Aws::RDS
     #
     #   Default: `5432`
     #
-    #   Valid Values: `1150-65535`
+    #   Valid values: `1150-65535`
     #
     #   Type: Integer
     #
@@ -3160,20 +3165,20 @@ module Aws::RDS
     #
     #   Default: `1521`
     #
-    #   Valid Values: `1150-65535`
+    #   Valid values: `1150-65535`
     #
     #   **SQL Server**
     #
     #   Default: `1433`
     #
-    #   Valid Values: `1150-65535` except for `1434`, `3389`, `47001`,
-    #   `49152`, and `49152` through `49156`.
+    #   Valid values: `1150-65535` except `1234`, `1434`, `3260`, `3343`,
+    #   `3389`, `47001`, and `49152-49156`.
     #
     #   **Amazon Aurora**
     #
     #   Default: `3306`
     #
-    #   Valid Values: `1150-65535`
+    #   Valid values: `1150-65535`
     #
     #   Type: Integer
     #
@@ -3366,15 +3371,13 @@ module Aws::RDS
     #   Amazon RDS DB Instance Running Microsoft SQL Server][1] in the *Amazon
     #   RDS User Guide*.
     #
-    #   For Oracle DB instance, Amazon RDS can use Kerberos Authentication to
+    #   For Oracle DB instances, Amazon RDS can use Kerberos Authentication to
     #   authenticate users that connect to the DB instance. For more
     #   information, see [ Using Kerberos Authentication with Amazon RDS for
     #   Oracle][2] in the *Amazon RDS User Guide*.
     #
     #
     #
-    #
-    #
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
     #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
     #
@@ -3745,19 +3748,20 @@ module Aws::RDS
       req.send_request(options)
     end
 
-    # Creates a new DB instance that acts as a Read Replica for an existing
-    # source DB instance. You can create a Read Replica for a DB instance
-    # running MySQL, MariaDB, Oracle, or PostgreSQL. For more information,
-    # see [Working with Read Replicas][1] in the *Amazon RDS User Guide*.
+    # Creates a new DB instance that acts as a read replica for an existing
+    # source DB instance. You can create a read replica for a DB instance
+    # running MySQL, MariaDB, Oracle, PostgreSQL, or SQL Server. For more
+    # information, see [Working with Read Replicas][1] in the *Amazon RDS
+    # User Guide*.
     #
-    # Amazon Aurora doesn't support this action. You must call the
+    # Amazon Aurora doesn't support this action. Call the
     # `CreateDBInstance` action to create a DB instance for an Aurora DB
     # cluster.
     #
-    # All Read Replica DB instances are created with backups disabled. All
+    # All read replica DB instances are created with backups disabled. All
     # other DB instance attributes (including DB security groups and DB
     # parameter groups) are inherited from the source DB instance, except as
-    # specified following.
+    # specified.
     #
     # Your source DB instance must have backup retention enabled.
     #
@@ -3766,47 +3770,53 @@ module Aws::RDS
     # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReadRepl.html
     #
     # @option params [required, String] :db_instance_identifier
-    #   The DB instance identifier of the Read Replica. This identifier is the
+    #   The DB instance identifier of the read replica. This identifier is the
     #   unique key that identifies a DB instance. This parameter is stored as
     #   a lowercase string.
     #
     # @option params [required, String] :source_db_instance_identifier
     #   The identifier of the DB instance that will act as the source for the
-    #   Read Replica. Each DB instance can have up to five Read Replicas.
+    #   read replica. Each DB instance can have up to five read replicas.
     #
     #   Constraints:
     #
-    #   * Must be the identifier of an existing MySQL, MariaDB, Oracle, or
-    #     PostgreSQL DB instance.
+    #   * Must be the identifier of an existing MySQL, MariaDB, Oracle,
+    #     PostgreSQL, or SQL Server DB instance.
     #
-    #   * Can specify a DB instance that is a MySQL Read Replica only if the
+    #   * Can specify a DB instance that is a MySQL read replica only if the
     #     source is running MySQL 5.6 or later.
     #
-    #   * For the limitations of Oracle Read Replicas, see [Read Replica
+    #   * For the limitations of Oracle read replicas, see [Read Replica
     #     Limitations with Oracle][1] in the *Amazon RDS User Guide*.
     #
-    #   * Can specify a DB instance that is a PostgreSQL DB instance only if
-    #     the source is running PostgreSQL 9.3.5 or later (9.4.7 and higher
-    #     for cross-region replication).
+    #   * For the limitations of SQL Server read replicas, see [Read Replica
+    #     Limitations with Microsoft SQL Server][2] in the *Amazon RDS User
+    #     Guide*.
     #
-    #   * The specified DB instance must have automatic backups enabled, its
-    #     backup retention period must be greater than 0.
+    #   * Can specify a PostgreSQL DB instance only if the source is running
+    #     PostgreSQL 9.3.5 or later (9.4.7 and higher for cross-region
+    #     replication).
     #
-    #   * If the source DB instance is in the same AWS Region as the Read
-    #     Replica, specify a valid DB instance identifier.
+    #   * The specified DB instance must have automatic backups enabled, that
+    #     is, its backup retention period must be greater than 0.
     #
-    #   * If the source DB instance is in a different AWS Region than the Read
-    #     Replica, specify a valid DB instance ARN. For more information, go
-    #     to [ Constructing an ARN for Amazon RDS][2] in the *Amazon RDS User
-    #     Guide*.
+    #   * If the source DB instance is in the same AWS Region as the read
+    #     replica, specify a valid DB instance identifier.
+    #
+    #   * If the source DB instance is in a different AWS Region from the read
+    #     replica, specify a valid DB instance ARN. For more information, see
+    #     [Constructing an ARN for Amazon RDS][3] in the *Amazon RDS User
+    #     Guide*. This doesn't apply to SQL Server, which doesn't support
+    #     cross-region replicas.
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
-    #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.ARN.html#USER_Tagging.ARN.Constructing
+    #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/SQLServer.ReadReplicas.Limitations.html
+    #   [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.ARN.html#USER_Tagging.ARN.Constructing
     #
     # @option params [String] :db_instance_class
-    #   The compute and memory capacity of the Read Replica, for example,
+    #   The compute and memory capacity of the read replica, for example,
     #   `db.m4.large`. Not all DB instance classes are available in all AWS
     #   Regions, or for all database engines. For the full list of DB instance
     #   classes, and availability for your engine, see [DB Instance Class][1]
@@ -3819,7 +3829,7 @@ module Aws::RDS
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html
     #
     # @option params [String] :availability_zone
-    #   The Availability Zone (AZ) where the Read Replica will be created.
+    #   The Availability Zone (AZ) where the read replica will be created.
     #
     #   Default: A random, system-chosen Availability Zone in the endpoint's
     #   AWS Region.
@@ -3834,18 +3844,18 @@ module Aws::RDS
     #   Valid Values: `1150-65535`
     #
     # @option params [Boolean] :multi_az
-    #   A value that indicates whether the Read Replica is in a Multi-AZ
+    #   A value that indicates whether the read replica is in a Multi-AZ
     #   deployment.
     #
-    #   You can create a Read Replica as a Multi-AZ DB instance. RDS creates a
+    #   You can create a read replica as a Multi-AZ DB instance. RDS creates a
     #   standby of your replica in another Availability Zone for failover
-    #   support for the replica. Creating your Read Replica as a Multi-AZ DB
+    #   support for the replica. Creating your read replica as a Multi-AZ DB
     #   instance is independent of whether the source database is a Multi-AZ
     #   DB instance.
     #
     # @option params [Boolean] :auto_minor_version_upgrade
     #   A value that indicates whether minor engine upgrades are applied
-    #   automatically to the Read Replica during the maintenance window.
+    #   automatically to the read replica during the maintenance window.
     #
     #   Default: Inherits from the source DB instance
     #
@@ -3857,13 +3867,18 @@ module Aws::RDS
     #   The option group the DB instance is associated with. If omitted, the
     #   option group associated with the source instance is used.
     #
+    #   <note markdown="1"> For SQL Server, you must use the option group associated with the
+    #   source instance.
+    #
+    #    </note>
+    #
     # @option params [String] :db_parameter_group_name
     #   The name of the DB parameter group to associate with this DB instance.
     #
     #   If you do not specify a value for `DBParameterGroupName`, then Amazon
     #   RDS uses the `DBParameterGroup` of source DB instance for a same
-    #   region Read Replica, or the default `DBParameterGroup` for the
-    #   specified DB engine for a cross region Read Replica.
+    #   region read replica, or the default `DBParameterGroup` for the
+    #   specified DB engine for a cross region read replica.
     #
     #   <note markdown="1"> Currently, specifying a parameter group for this operation is only
     #   supported for Oracle DB instances.
@@ -3910,25 +3925,25 @@ module Aws::RDS
     #   * The specified DB subnet group must be in the same AWS Region in
     #     which the operation is running.
     #
-    #   * All Read Replicas in one AWS Region that are created from the same
+    #   * All read replicas in one AWS Region that are created from the same
     #     source DB instance must either:&gt;
     #
-    #     * Specify DB subnet groups from the same VPC. All these Read
-    #       Replicas are created in the same VPC.
+    #     * Specify DB subnet groups from the same VPC. All these read
+    #       replicas are created in the same VPC.
     #
-    #     * Not specify a DB subnet group. All these Read Replicas are created
+    #     * Not specify a DB subnet group. All these read replicas are created
     #       outside of any VPC.
     #
     #   Example: `mySubnetgroup`
     #
     # @option params [Array<String>] :vpc_security_group_ids
-    #   A list of EC2 VPC security groups to associate with the Read Replica.
+    #   A list of EC2 VPC security groups to associate with the read replica.
     #
     #   Default: The default EC2 VPC security group for the DB subnet group's
     #   VPC.
     #
     # @option params [String] :storage_type
-    #   Specifies the storage type to be associated with the Read Replica.
+    #   Specifies the storage type to be associated with the read replica.
     #
     #   Valid values: `standard | gp2 | io1`
     #
@@ -3938,12 +3953,12 @@ module Aws::RDS
     #   Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
     #
     # @option params [Boolean] :copy_tags_to_snapshot
-    #   A value that indicates whether to copy all tags from the Read Replica
-    #   to snapshots of the Read Replica. By default, tags are not copied.
+    #   A value that indicates whether to copy all tags from the read replica
+    #   to snapshots of the read replica. By default, tags are not copied.
     #
     # @option params [Integer] :monitoring_interval
     #   The interval, in seconds, between points when Enhanced Monitoring
-    #   metrics are collected for the Read Replica. To disable collecting
+    #   metrics are collected for the read replica. To disable collecting
     #   Enhanced Monitoring metrics, specify 0. The default is 0.
     #
     #   If `MonitoringRoleArn` is specified, then you must also set
@@ -3966,22 +3981,22 @@ module Aws::RDS
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.html#USER_Monitoring.OS.IAMRole
     #
     # @option params [String] :kms_key_id
-    #   The AWS KMS key ID for an encrypted Read Replica. The KMS key ID is
+    #   The AWS KMS key ID for an encrypted read replica. The KMS key ID is
     #   the Amazon Resource Name (ARN), KMS key identifier, or the KMS key
     #   alias for the KMS encryption key.
     #
-    #   If you create an encrypted Read Replica in the same AWS Region as the
+    #   If you create an encrypted read replica in the same AWS Region as the
     #   source DB instance, then you do not have to specify a value for this
-    #   parameter. The Read Replica is encrypted with the same KMS key as the
+    #   parameter. The read replica is encrypted with the same KMS key as the
     #   source DB instance.
     #
-    #   If you create an encrypted Read Replica in a different AWS Region,
+    #   If you create an encrypted read replica in a different AWS Region,
     #   then you must specify a KMS key for the destination AWS Region. KMS
     #   encryption keys are specific to the AWS Region that they are created
     #   in, and you can't use encryption keys from one AWS Region in another
     #   AWS Region.
     #
-    #   You can't create an encrypted Read Replica from an unencrypted DB
+    #   You can't create an encrypted read replica from an unencrypted DB
     #   instance.
     #
     # @option params [String] :pre_signed_url
@@ -3989,9 +4004,9 @@ module Aws::RDS
     #   `CreateDBInstanceReadReplica` API action in the source AWS Region that
     #   contains the source DB instance.
     #
-    #   You must specify this parameter when you create an encrypted Read
-    #   Replica from another AWS Region by using the Amazon RDS API. Don't
-    #   specify `PreSignedUrl` when you are creating an encrypted Read Replica
+    #   You must specify this parameter when you create an encrypted read
+    #   replica from another AWS Region by using the Amazon RDS API. Don't
+    #   specify `PreSignedUrl` when you are creating an encrypted read replica
     #   in the same AWS Region.
     #
     #   The presigned URL must be a valid request for the
@@ -3999,7 +4014,7 @@ module Aws::RDS
     #   source AWS Region that contains the encrypted source DB instance. The
     #   presigned URL request must contain the following parameter values:
     #
-    #   * `DestinationRegion` - The AWS Region that the encrypted Read Replica
+    #   * `DestinationRegion` - The AWS Region that the encrypted read replica
     #     is created in. This AWS Region is the same one where the
     #     `CreateDBInstanceReadReplica` action is called that contains this
     #     presigned URL.
@@ -4013,7 +4028,7 @@ module Aws::RDS
     #     presigned URL must be set to the us-east-1 AWS Region.
     #
     #   * `KmsKeyId` - The AWS KMS key identifier for the key to use to
-    #     encrypt the Read Replica in the destination AWS Region. This is the
+    #     encrypt the read replica in the destination AWS Region. This is the
     #     same identifier for both the `CreateDBInstanceReadReplica` action
     #     that is called in the destination AWS Region, and the action
     #     contained in the presigned URL.
@@ -4021,7 +4036,7 @@ module Aws::RDS
     #   * `SourceDBInstanceIdentifier` - The DB instance identifier for the
     #     encrypted DB instance to be replicated. This identifier must be in
     #     the Amazon Resource Name (ARN) format for the source AWS Region. For
-    #     example, if you are creating an encrypted Read Replica from a DB
+    #     example, if you are creating an encrypted read replica from a DB
     #     instance in the us-west-2 AWS Region, then your
     #     `SourceDBInstanceIdentifier` looks like the following example:
     #     `arn:aws:rds:us-west-2:123456789012:instance:mysql-instance1-20161115`.
@@ -4033,9 +4048,12 @@ module Aws::RDS
     #   <note markdown="1"> 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
+    #   autogenerates a presigned URL that is a valid request for the
     #   operation that can be executed in the source AWS Region.
     #
+    #    `SourceRegion` isn't supported for SQL Server, because SQL Server on
+    #   Amazon RDS doesn't support cross-region read replicas.
+    #
     #    </note>
     #
     #
@@ -4059,7 +4077,7 @@ module Aws::RDS
     #
     # @option params [Boolean] :enable_performance_insights
     #   A value that indicates whether to enable Performance Insights for the
-    #   Read Replica.
+    #   read replica.
     #
     #   For more information, see [Using Amazon Performance Insights][1] in
     #   the *Amazon RDS User Guide*.
@@ -4118,9 +4136,16 @@ module Aws::RDS
     #   information, see [ Using Kerberos Authentication with Amazon RDS for
     #   Oracle][1] in the *Amazon RDS User Guide*.
     #
+    #   For Microsoft SQL Server DB instances, Amazon RDS can use Windows
+    #   Authentication to authenticate users that connect to the DB instance.
+    #   For more information, see [ Using Windows Authentication with an
+    #   Amazon RDS DB Instance Running Microsoft SQL Server][2] in the *Amazon
+    #   RDS User Guide*.
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
+    #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
     #
     # @option params [String] :domain_iam_role_name
     #   Specify the name of the IAM role to be used when making API calls to
@@ -5631,14 +5656,14 @@ module Aws::RDS
     # you can't delete the DB instance if both of the following conditions
     # are true:
     #
-    # * The DB cluster is a Read Replica of another Amazon Aurora DB
+    # * The DB cluster is a read replica of another Amazon Aurora DB
     #   cluster.
     #
     # * The DB instance is the only instance in the DB cluster.
     #
     # To delete a DB instance in this case, first call the
     # `PromoteReadReplicaDBCluster` API action to promote the DB cluster so
-    # it's no longer a Read Replica. After the promotion completes, then
+    # it's no longer a read replica. After the promotion completes, then
     # call the `DeleteDBInstance` API action to delete the final instance in
     # the DB cluster.
     #
@@ -5663,7 +5688,7 @@ module Aws::RDS
     #   'failed', 'incompatible-restore', or 'incompatible-network', it
     #   can only be deleted when skip is specified.
     #
-    #   Specify skip when deleting a Read Replica.
+    #   Specify skip when deleting a read replica.
     #
     #   <note markdown="1"> The FinalDBSnapshotIdentifier parameter must be specified if skip
     #   isn't specified.
@@ -5687,7 +5712,7 @@ module Aws::RDS
     #
     #   * Can't end with a hyphen or contain two consecutive hyphens.
     #
-    #   * Can't be specified when deleting a Read Replica.
+    #   * Can't be specified when deleting a read replica.
     #
     # @option params [Boolean] :delete_automated_backups
     #   A value that indicates whether to remove automated backups immediately
@@ -6559,6 +6584,8 @@ module Aws::RDS
     #   * {Types::CustomAvailabilityZoneMessage#marker #marker} => String
     #   * {Types::CustomAvailabilityZoneMessage#custom_availability_zones #custom_availability_zones} => Array&lt;Types::CustomAvailabilityZone&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_custom_availability_zones({
@@ -7254,6 +7281,12 @@ module Aws::RDS
     #   resp.db_cluster_snapshots[0].source_db_cluster_snapshot_arn #=> String
     #   resp.db_cluster_snapshots[0].iam_database_authentication_enabled #=> Boolean
     #
+    #
+    # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
+    #
+    #   * db_cluster_snapshot_available
+    #   * db_cluster_snapshot_deleted
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusterSnapshots AWS API Documentation
     #
     # @overload describe_db_cluster_snapshots(params = {})
@@ -7325,6 +7358,8 @@ module Aws::RDS
     #   * {Types::DBClusterMessage#marker #marker} => String
     #   * {Types::DBClusterMessage#db_clusters #db_clusters} => Array&lt;Types::DBCluster&gt;
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     #
     # @example Example: To list DB clusters
     #
@@ -7510,6 +7545,8 @@ module Aws::RDS
     #   * {Types::DBEngineVersionMessage#marker #marker} => String
     #   * {Types::DBEngineVersionMessage#db_engine_versions #db_engine_versions} => Array&lt;Types::DBEngineVersion&gt;
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     #
     # @example Example: To list DB engine version settings
     #
@@ -7650,6 +7687,8 @@ module Aws::RDS
     #   * {Types::DBInstanceAutomatedBackupMessage#marker #marker} => String
     #   * {Types::DBInstanceAutomatedBackupMessage#db_instance_automated_backups #db_instance_automated_backups} => Array&lt;Types::DBInstanceAutomatedBackup&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_instance_automated_backups({
@@ -7768,6 +7807,8 @@ module Aws::RDS
     #   * {Types::DBInstanceMessage#marker #marker} => String
     #   * {Types::DBInstanceMessage#db_instances #db_instances} => Array&lt;Types::DBInstance&gt;
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     #
     # @example Example: To list DB instance settings
     #
@@ -7913,6 +7954,12 @@ module Aws::RDS
     #   resp.db_instances[0].listener_endpoint.hosted_zone_id #=> String
     #   resp.db_instances[0].max_allocated_storage #=> Integer
     #
+    #
+    # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
+    #
+    #   * db_instance_available
+    #   * db_instance_deleted
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBInstances AWS API Documentation
     #
     # @overload describe_db_instances(params = {})
@@ -7965,6 +8012,8 @@ module Aws::RDS
     #   * {Types::DescribeDBLogFilesResponse#describe_db_log_files #describe_db_log_files} => Array&lt;Types::DescribeDBLogFilesDetails&gt;
     #   * {Types::DescribeDBLogFilesResponse#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 Example: To list DB log file names
     #
@@ -8054,6 +8103,8 @@ module Aws::RDS
     #   * {Types::DBParameterGroupsMessage#marker #marker} => String
     #   * {Types::DBParameterGroupsMessage#db_parameter_groups #db_parameter_groups} => Array&lt;Types::DBParameterGroup&gt;
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     #
     # @example Example: To list information about DB parameter groups
     #
@@ -8142,6 +8193,8 @@ module Aws::RDS
     #   * {Types::DBParameterGroupDetails#parameters #parameters} => Array&lt;Types::Parameter&gt;
     #   * {Types::DBParameterGroupDetails#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 Example: To list information about DB parameters
     #
@@ -8231,6 +8284,8 @@ module Aws::RDS
     #   * {Types::DescribeDBProxiesResponse#db_proxies #db_proxies} => Array&lt;Types::DBProxy&gt;
     #   * {Types::DescribeDBProxiesResponse#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_proxies({
@@ -8317,6 +8372,8 @@ module Aws::RDS
     #   * {Types::DescribeDBProxyTargetGroupsResponse#target_groups #target_groups} => Array&lt;Types::DBProxyTargetGroup&gt;
     #   * {Types::DescribeDBProxyTargetGroupsResponse#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_proxy_target_groups({
@@ -8396,6 +8453,8 @@ module Aws::RDS
     #   * {Types::DescribeDBProxyTargetsResponse#targets #targets} => Array&lt;Types::DBProxyTarget&gt;
     #   * {Types::DescribeDBProxyTargetsResponse#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_proxy_targets({
@@ -8462,6 +8521,8 @@ module Aws::RDS
     #   * {Types::DBSecurityGroupMessage#marker #marker} => String
     #   * {Types::DBSecurityGroupMessage#db_security_groups #db_security_groups} => Array&lt;Types::DBSecurityGroup&gt;
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     #
     # @example Example: To list DB security group settings
     #
@@ -8699,6 +8760,8 @@ module Aws::RDS
     #   * {Types::DBSnapshotMessage#marker #marker} => String
     #   * {Types::DBSnapshotMessage#db_snapshots #db_snapshots} => Array&lt;Types::DBSnapshot&gt;
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     #
     # @example Example: To list DB snapshot attributes
     #
@@ -8769,6 +8832,12 @@ module Aws::RDS
     #   resp.db_snapshots[0].processor_features[0].value #=> String
     #   resp.db_snapshots[0].dbi_resource_id #=> String
     #
+    #
+    # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
+    #
+    #   * db_snapshot_available
+    #   * db_snapshot_deleted
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBSnapshots AWS API Documentation
     #
     # @overload describe_db_snapshots(params = {})
@@ -8815,6 +8884,8 @@ module Aws::RDS
     #   * {Types::DBSubnetGroupMessage#marker #marker} => String
     #   * {Types::DBSubnetGroupMessage#db_subnet_groups #db_subnet_groups} => Array&lt;Types::DBSubnetGroup&gt;
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     #
     # @example Example: To list information about DB subnet groups
     #
@@ -8987,6 +9058,8 @@ module Aws::RDS
     #
     #   * {Types::DescribeEngineDefaultParametersResult#engine_defaults #engine_defaults} => Types::EngineDefaults
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     #
     # @example Example: To list default parameters for a DB engine
     #
@@ -9141,6 +9214,8 @@ module Aws::RDS
     #   * {Types::EventSubscriptionsMessage#marker #marker} => String
     #   * {Types::EventSubscriptionsMessage#event_subscriptions_list #event_subscriptions_list} => Array&lt;Types::EventSubscription&gt;
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     #
     # @example Example: To list information about DB event notification subscriptions
     #
@@ -9280,6 +9355,8 @@ module Aws::RDS
     #   * {Types::EventsMessage#marker #marker} => String
     #   * {Types::EventsMessage#events #events} => Array&lt;Types::Event&gt;
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     #
     # @example Example: To list information about events
     #
@@ -9386,6 +9463,8 @@ module Aws::RDS
     #   * {Types::ExportTasksMessage#marker #marker} => String
     #   * {Types::ExportTasksMessage#export_tasks #export_tasks} => Array&lt;Types::ExportTask&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_export_tasks({
@@ -9488,6 +9567,8 @@ module Aws::RDS
     #   * {Types::GlobalClustersMessage#marker #marker} => String
     #   * {Types::GlobalClustersMessage#global_clusters #global_clusters} => Array&lt;Types::GlobalCluster&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_global_clusters({
@@ -9568,6 +9649,8 @@ module Aws::RDS
     #   * {Types::InstallationMediaMessage#marker #marker} => String
     #   * {Types::InstallationMediaMessage#installation_media #installation_media} => Array&lt;Types::InstallationMedia&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_installation_media({
@@ -9637,6 +9720,8 @@ module Aws::RDS
     #   * {Types::OptionGroupOptionsMessage#option_group_options #option_group_options} => Array&lt;Types::OptionGroupOption&gt;
     #   * {Types::OptionGroupOptionsMessage#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 Example: To list information about DB option group options
     #
@@ -9749,6 +9834,8 @@ module Aws::RDS
     #   * {Types::OptionGroups#option_groups_list #option_groups_list} => Array&lt;Types::OptionGroup&gt;
     #   * {Types::OptionGroups#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 Example: To list information about DB option groups
     #
@@ -9868,6 +9955,8 @@ module Aws::RDS
     #   * {Types::OrderableDBInstanceOptionsMessage#orderable_db_instance_options #orderable_db_instance_options} => Array&lt;Types::OrderableDBInstanceOption&gt;
     #   * {Types::OrderableDBInstanceOptionsMessage#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 Example: To list information about orderable DB instance options
     #
@@ -10107,6 +10196,8 @@ module Aws::RDS
     #   * {Types::ReservedDBInstanceMessage#marker #marker} => String
     #   * {Types::ReservedDBInstanceMessage#reserved_db_instances #reserved_db_instances} => Array&lt;Types::ReservedDBInstance&gt;
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     #
     # @example Example: To list information about reserved DB instances
     #
@@ -10239,6 +10330,8 @@ module Aws::RDS
     #   * {Types::ReservedDBInstancesOfferingMessage#marker #marker} => String
     #   * {Types::ReservedDBInstancesOfferingMessage#reserved_db_instances_offerings #reserved_db_instances_offerings} => Array&lt;Types::ReservedDBInstancesOffering&gt;
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     #
     # @example Example: To list information about reserved DB instance offerings
     #
@@ -10303,7 +10396,7 @@ module Aws::RDS
     end
 
     # Returns a list of the source AWS Regions where the current AWS Region
-    # can create a Read Replica or copy a DB snapshot from. This API action
+    # can create a read replica or copy a DB snapshot from. This API action
     # supports pagination.
     #
     # @option params [String] :region_name
@@ -10534,6 +10627,8 @@ module Aws::RDS
     #   * {Types::DownloadDBLogFilePortionDetails#marker #marker} => String
     #   * {Types::DownloadDBLogFilePortionDetails#additional_data_pending #additional_data_pending} => Boolean
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     #
     # @example Example: To list information about DB log files
     #
@@ -11956,13 +12051,13 @@ module Aws::RDS
     #
     #   * Must be a value from 0 to 35
     #
-    #   * Can be specified for a MySQL Read Replica only if the source is
+    #   * Can be specified for a MySQL read replica only if the source is
     #     running MySQL 5.6 or later
     #
-    #   * Can be specified for a PostgreSQL Read Replica only if the source is
+    #   * Can be specified for a PostgreSQL read replica only if the source is
     #     running PostgreSQL 9.3.5
     #
-    #   * Can't be set to 0 if the DB instance is a source to Read Replicas
+    #   * Can't be set to 0 if the DB instance is a source to read replicas
     #
     # @option params [String] :preferred_backup_window
     #   The daily time range during which automated backups are created if
@@ -12073,7 +12168,7 @@ module Aws::RDS
     #   performance degradation. While the migration takes place, nightly
     #   backups for the instance are suspended. No other Amazon RDS operations
     #   can take place for the instance, including modifying the instance,
-    #   rebooting the instance, deleting the instance, creating a Read Replica
+    #   rebooting the instance, deleting the instance, creating a read replica
     #   for the instance, and creating a DB snapshot of the instance.
     #
     #   Constraints: For MariaDB, MySQL, Oracle, and PostgreSQL, the value
@@ -12133,7 +12228,7 @@ module Aws::RDS
     #   performance degradation. While the migration takes place, nightly
     #   backups for the instance are suspended. No other Amazon RDS operations
     #   can take place for the instance, including modifying the instance,
-    #   rebooting the instance, deleting the instance, creating a Read Replica
+    #   rebooting the instance, deleting the instance, creating a read replica
     #   for the instance, and creating a DB snapshot of the instance.
     #
     #   Valid values: `standard | gp2 | io1`
@@ -12209,19 +12304,19 @@ module Aws::RDS
     #
     #   Default: `3306`
     #
-    #   Valid Values: `1150-65535`
+    #   Valid values: `1150-65535`
     #
     #   **MariaDB**
     #
     #   Default: `3306`
     #
-    #   Valid Values: `1150-65535`
+    #   Valid values: `1150-65535`
     #
     #   **PostgreSQL**
     #
     #   Default: `5432`
     #
-    #   Valid Values: `1150-65535`
+    #   Valid values: `1150-65535`
     #
     #   Type: Integer
     #
@@ -12229,20 +12324,20 @@ module Aws::RDS
     #
     #   Default: `1521`
     #
-    #   Valid Values: `1150-65535`
+    #   Valid values: `1150-65535`
     #
     #   **SQL Server**
     #
     #   Default: `1433`
     #
-    #   Valid Values: `1150-65535` except for `1434`, `3389`, `47001`,
-    #   `49152`, and `49152` through `49156`.
+    #   Valid values: `1150-65535` except `1234`, `1434`, `3260`, `3343`,
+    #   `3389`, `47001`, and `49152-49156`.
     #
     #   **Amazon Aurora**
     #
     #   Default: `3306`
     #
-    #   Valid Values: `1150-65535`
+    #   Valid values: `1150-65535`
     #
     # @option params [Boolean] :publicly_accessible
     #   A value that indicates whether the DB instance is publicly accessible.
@@ -12874,8 +12969,8 @@ module Aws::RDS
       req.send_request(options)
     end
 
-    # Updates a manual DB snapshot, which can be encrypted or not encrypted,
-    # with a new engine version.
+    # Updates a manual DB snapshot with a new engine version. The snapshot
+    # can be encrypted or unencrypted, but not shared or public.
     #
     # Amazon RDS supports upgrading DB snapshots for MySQL, Oracle, and
     # PostgreSQL.
@@ -13454,16 +13549,16 @@ module Aws::RDS
       req.send_request(options)
     end
 
-    # Promotes a Read Replica DB instance to a standalone DB instance.
+    # Promotes a read replica DB instance to a standalone DB instance.
     #
     # <note markdown="1"> * Backup duration is a function of the amount of changes to the
-    #   database since the previous backup. If you plan to promote a Read
-    #   Replica to a standalone instance, we recommend that you enable
+    #   database since the previous backup. If you plan to promote a read
+    #   replica to a standalone instance, we recommend that you enable
     #   backups and complete at least one backup prior to promotion. In
-    #   addition, a Read Replica cannot be promoted to a standalone instance
+    #   addition, a read replica cannot be promoted to a standalone instance
     #   when it is in the `backing-up` status. If you have enabled backups
-    #   on your Read Replica, configure the automated backup window so that
-    #   daily backups do not interfere with Read Replica promotion.
+    #   on your read replica, configure the automated backup window so that
+    #   daily backups do not interfere with read replica promotion.
     #
     # * This command doesn't apply to Aurora MySQL and Aurora PostgreSQL.
     #
@@ -13475,7 +13570,7 @@ module Aws::RDS
     #
     #   Constraints:
     #
-    #   * Must match the identifier of an existing Read Replica DB instance.
+    #   * Must match the identifier of an existing read replica DB instance.
     #
     #   ^
     #
@@ -13492,7 +13587,7 @@ module Aws::RDS
     #
     #   * Must be a value from 0 to 35.
     #
-    #   * Can't be set to 0 if the DB instance is a source to Read Replicas.
+    #   * Can't be set to 0 if the DB instance is a source to read replicas.
     #
     # @option params [String] :preferred_backup_window
     #   The daily time range during which automated backups are created if
@@ -13672,19 +13767,19 @@ module Aws::RDS
       req.send_request(options)
     end
 
-    # Promotes a Read Replica DB cluster to a standalone DB cluster.
+    # Promotes a read replica DB cluster to a standalone DB cluster.
     #
     # <note markdown="1"> This action only applies to Aurora DB clusters.
     #
     #  </note>
     #
     # @option params [required, String] :db_cluster_identifier
-    #   The identifier of the DB cluster Read Replica to promote. This
+    #   The identifier of the DB cluster read replica to promote. This
     #   parameter isn't case-sensitive.
     #
     #   Constraints:
     #
-    #   * Must match the identifier of an existing DBCluster Read Replica.
+    #   * Must match the identifier of an existing DB cluster read replica.
     #
     #   ^
     #
@@ -14846,12 +14941,12 @@ module Aws::RDS
     #
     #   For Amazon Aurora DB clusters, Amazon RDS can use Kerberos
     #   Authentication to authenticate users that connect to the DB cluster.
-    #   For more information, see [Using Kerberos Authentication for Aurora
-    #   MySQL][1] in the *Amazon Aurora User Guide*.
+    #   For more information, see [Kerberos Authentication][1] in the *Amazon
+    #   Aurora User Guide*.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurmysql-kerberos.html
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/kerberos-authentication.html
     #
     # @option params [String] :domain_iam_role_name
     #   Specify the name of the IAM role to be used when making API calls to
@@ -14990,24 +15085,24 @@ module Aws::RDS
     end
 
     # Creates a new DB cluster from a DB snapshot or DB cluster snapshot.
+    # This action only applies to Aurora DB clusters.
     #
-    # If a DB snapshot is specified, the target DB cluster is created from
-    # the source DB snapshot with a default configuration and default
-    # security group.
+    # The target DB cluster is created from the source snapshot with a
+    # default configuration. If you don't specify a security group, the new
+    # DB cluster is associated with the default security group.
     #
-    # If a DB cluster snapshot is specified, the target DB cluster is
-    # created from the source DB cluster restore point with the same
-    # configuration as the original source DB cluster. If you don't specify
-    # a security group, the new DB cluster is associated with the default
-    # security group.
+    # <note markdown="1"> This action only restores the DB cluster, not the DB instances for
+    # that DB cluster. You must invoke the `CreateDBInstance` action to
+    # create DB instances for the restored DB cluster, specifying the
+    # identifier of the restored DB cluster in `DBClusterIdentifier`. You
+    # can create DB instances only after the `RestoreDBClusterFromSnapshot`
+    # action has completed and the DB cluster is available.
+    #
+    #  </note>
     #
     # For more information on Amazon Aurora, see [ What Is Amazon
     # Aurora?][1] in the *Amazon Aurora User Guide.*
     #
-    # <note markdown="1"> This action only applies to Aurora DB clusters.
-    #
-    #  </note>
-    #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
@@ -15572,12 +15667,12 @@ module Aws::RDS
     #
     #   For Amazon Aurora DB clusters, Amazon RDS can use Kerberos
     #   Authentication to authenticate users that connect to the DB cluster.
-    #   For more information, see [Using Kerberos Authentication for Aurora
-    #   MySQL][1] in the *Amazon Aurora User Guide*.
+    #   For more information, see [Kerberos Authentication][1] in the *Amazon
+    #   Aurora User Guide*.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurmysql-kerberos.html
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/kerberos-authentication.html
     #
     # @option params [String] :domain_iam_role_name
     #   Specify the name of the IAM role to be used when making API calls to
@@ -18284,7 +18379,7 @@ module Aws::RDS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-rds'
-      context[:gem_version] = '1.80.0'
+      context[:gem_version] = '1.81.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 
@@ -18350,14 +18445,14 @@ module Aws::RDS
     # The following table lists the valid waiter names, the operations they call,
     # and the default `:delay` and `:max_attempts` values.
     #
-    # | waiter_name                   | params                           | :delay   | :max_attempts |
-    # | ----------------------------- | -------------------------------- | -------- | ------------- |
-    # | db_cluster_snapshot_available | {#describe_db_cluster_snapshots} | 30       | 60            |
-    # | db_cluster_snapshot_deleted   | {#describe_db_cluster_snapshots} | 30       | 60            |
-    # | db_instance_available         | {#describe_db_instances}         | 30       | 60            |
-    # | db_instance_deleted           | {#describe_db_instances}         | 30       | 60            |
-    # | db_snapshot_available         | {#describe_db_snapshots}         | 30       | 60            |
-    # | db_snapshot_deleted           | {#describe_db_snapshots}         | 30       | 60            |
+    # | waiter_name                   | params                                 | :delay   | :max_attempts |
+    # | ----------------------------- | -------------------------------------- | -------- | ------------- |
+    # | db_cluster_snapshot_available | {Client#describe_db_cluster_snapshots} | 30       | 60            |
+    # | db_cluster_snapshot_deleted   | {Client#describe_db_cluster_snapshots} | 30       | 60            |
+    # | db_instance_available         | {Client#describe_db_instances}         | 30       | 60            |
+    # | db_instance_deleted           | {Client#describe_db_instances}         | 30       | 60            |
+    # | db_snapshot_available         | {Client#describe_db_snapshots}         | 30       | 60            |
+    # | db_snapshot_deleted           | {Client#describe_db_snapshots}         | 30       | 60            |
     #
     # @raise [Errors::FailureStateError] Raised when the waiter terminates
     #   because the waiter has entered a state that it will not transition