aws-sdk-rds 1.69.0 → 1.70.0

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

@@ -34,7 +34,7 @@ module Aws::RDS
     # For all database engines except Amazon Aurora, `AllocatedStorage`
     # specifies the allocated storage size in gibibytes (GiB). For Aurora,
     # `AllocatedStorage` always returns 1, because Aurora DB cluster storage
-    # size is not fixed, but instead automatically adjusts as needed.
+    # size isn't fixed, but instead automatically adjusts as needed.
     # @return [Integer]
     def allocated_storage
       data[:allocated_storage]
@@ -626,7 +626,8 @@ module Aws::RDS
     #   the DB cluster you are creating.
     # @option options [String] :db_cluster_parameter_group_name
     #   The name of the DB cluster parameter group to associate with this DB
-    #   cluster. If this argument is omitted, `default.aurora5.6` is used.
+    #   cluster. If you do not specify a value, then the default DB cluster
+    #   parameter group for the specified DB engine and version is used.
     #
     #   Constraints:
     #
@@ -763,14 +764,14 @@ module Aws::RDS
     #   cluster, then you can use the KMS key alias instead of the ARN for the
     #   KMS encryption key.
     #
-    #   If an encryption key is not specified in `KmsKeyId`\:
+    #   If an encryption key isn't specified in `KmsKeyId`\:
     #
     #   * If `ReplicationSourceIdentifier` identifies an encrypted source,
     #     then Amazon RDS will use the encryption key used to encrypt the
     #     source. Otherwise, Amazon RDS will use your default encryption key.
     #
     #   * If the `StorageEncrypted` parameter is enabled and
-    #     `ReplicationSourceIdentifier` is not specified, then Amazon RDS will
+    #     `ReplicationSourceIdentifier` isn't specified, then Amazon RDS will
     #     use your default encryption key.
     #
     #   AWS KMS creates the default encryption key for your AWS account. Your
@@ -816,6 +817,14 @@ module Aws::RDS
     #   Authenticating Requests: Using Query Parameters (AWS Signature Version
     #   4)][1] and [ Signature Version 4 Signing Process][2].
     #
+    #   <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
+    #   operation that can be executed in the source AWS Region.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html
@@ -948,9 +957,9 @@ module Aws::RDS
     # @option options [Boolean] :skip_final_snapshot
     #   A value that indicates whether to skip the creation of a final DB
     #   cluster snapshot before the DB cluster is deleted. If skip is
-    #   specified, no DB cluster snapshot is created. If skip is not
+    #   specified, no DB cluster snapshot is created. If skip isn't
     #   specified, a DB cluster snapshot is created before the DB cluster is
-    #   deleted. By default, skip is not specified, and the DB cluster
+    #   deleted. By default, skip isn't specified, and the DB cluster
     #   snapshot is created. By default, this parameter is disabled.
     #
     #   <note markdown="1"> You must specify a `FinalDBSnapshotIdentifier` parameter if
@@ -1324,7 +1333,7 @@ module Aws::RDS
     #
     #   * Must be before the latest restorable time for the DB instance
     #
-    #   * Must be specified if `UseLatestRestorableTime` parameter is not
+    #   * Must be specified if `UseLatestRestorableTime` parameter isn't
     #     provided
     #
     #   * Can't be specified if the `UseLatestRestorableTime` parameter is
@@ -1336,7 +1345,7 @@ module Aws::RDS
     #   Example: `2015-03-07T23:45:00Z`
     # @option options [Boolean] :use_latest_restorable_time
     #   A value that indicates whether to restore the DB cluster to the latest
-    #   restorable backup time. By default, the DB cluster is not restored to
+    #   restorable backup time. By default, the DB cluster isn't restored to
     #   the latest restorable backup time.
     #
     #   Constraints: Can't be specified if `RestoreToTime` parameter is
@@ -1387,10 +1396,10 @@ module Aws::RDS
     #     encrypted using the KMS key that was used to encrypt the source DB
     #     cluster.
     #
-    #   * If the DB cluster is not encrypted, then the restored DB cluster is
-    #     not encrypted.
+    #   * If the DB cluster isn't encrypted, then the restored DB cluster
+    #     isn't encrypted.
     #
-    #   If `DBClusterIdentifier` refers to a DB cluster that is not encrypted,
+    #   If `DBClusterIdentifier` refers to a DB cluster that isn't encrypted,
     #   then the restore request is rejected.
     # @option options [Boolean] :enable_iam_database_authentication
     #   A value that indicates whether to enable mapping of AWS Identity and
@@ -1503,7 +1512,7 @@ module Aws::RDS
     #   A list of event categories that trigger notifications for a event
     #   notification subscription.
     # @option options [Array<Types::Filter>] :filters
-    #   This parameter is not currently supported.
+    #   This parameter isn't currently supported.
     # @return [Event::Collection]
     def events(options = {})
       batches = Enumerator.new do |y|
@@ -1638,8 +1647,8 @@ module Aws::RDS
     # @option options [Integer] :max_records
     #   The maximum number of records to include in the response. If more
     #   records exist than the specified `MaxRecords` value, a pagination
-    #   token called a marker is included in the response so that you can
-    #   retrieve the remaining results.
+    #   token called a marker is included in the response so you can retrieve
+    #   the remaining results.
     #
     #   Default: 100
     #

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

@@ -336,7 +336,7 @@ module Aws::RDS
     # @param [Hash] options ({})
     # @option options [required, String] :target_db_cluster_snapshot_identifier
     #   The identifier of the new DB cluster snapshot to create from the
-    #   source DB cluster snapshot. This parameter is not case-sensitive.
+    #   source DB cluster snapshot. This parameter isn't case-sensitive.
     #
     #   Constraints:
     #
@@ -375,7 +375,8 @@ module Aws::RDS
     #   `CopyDBClusterSnapshot` API action in the AWS Region that contains the
     #   source DB cluster snapshot to copy. The `PreSignedUrl` parameter must
     #   be used when copying an encrypted DB cluster snapshot from another AWS
-    #   Region.
+    #   Region. Don't specify `PreSignedUrl` when you are copying an
+    #   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
@@ -405,6 +406,14 @@ module Aws::RDS
     #   Authenticating Requests: Using Query Parameters (AWS Signature Version
     #   4)][1] and [ Signature Version 4 Signing Process][2].
     #
+    #   <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
+    #   operation that can be executed in the source AWS Region.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html
@@ -530,6 +539,11 @@ module Aws::RDS
     #   `aws rds describe-db-engine-versions --engine aurora-postgresql
     #   --query "DBEngineVersions[].EngineVersion"`
     #
+    #   <note markdown="1"> If you aren't using the default engine version, then you must specify
+    #   the engine version.
+    #
+    #    </note>
+    #
     #   **Aurora MySQL**
     #
     #   Example: `5.6.10a`, `5.6.mysql_aurora.1.19.2`, `5.7.12`,
@@ -576,8 +590,8 @@ module Aws::RDS
     #     encrypted, then the restored DB cluster is encrypted using the KMS
     #     key that was used to encrypt the DB snapshot or DB cluster snapshot.
     #
-    #   * If the DB snapshot or DB cluster snapshot in `SnapshotIdentifier` is
-    #     not encrypted, then the restored DB cluster is not encrypted.
+    #   * If the DB snapshot or DB cluster snapshot in `SnapshotIdentifier`
+    #     isn't encrypted, then the restored DB cluster isn't encrypted.
     # @option options [Boolean] :enable_iam_database_authentication
     #   A value that indicates whether to enable mapping of AWS Identity and
     #   Access Management (IAM) accounts to database accounts. By default,
@@ -703,7 +717,7 @@ module Aws::RDS
     #   A list of event categories that trigger notifications for a event
     #   notification subscription.
     # @option options [Array<Types::Filter>] :filters
-    #   This parameter is not currently supported.
+    #   This parameter isn't currently supported.
     # @return [Event::Collection]
     def events(options = {})
       batches = Enumerator.new do |y|

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

@@ -171,7 +171,7 @@ module Aws::RDS
     #   If specified, filters the results to include only options for the
     #   specified major engine version.
     # @option options [Array<Types::Filter>] :filters
-    #   This parameter is not currently supported.
+    #   This parameter isn't currently supported.
     # @return [OptionGroupOption::Collection]
     def option_group_options(options = {})
       batches = Enumerator.new do |y|
@@ -209,7 +209,7 @@ module Aws::RDS
     #   The name of the option group to describe. Can't be supplied together
     #   with EngineName or MajorEngineVersion.
     # @option options [Array<Types::Filter>] :filters
-    #   This parameter is not currently supported.
+    #   This parameter isn't currently supported.
     # @option options [String] :major_engine_version
     #   Filters the list of option groups to only include groups associated
     #   with a specific database engine version. If specified, then EngineName
@@ -275,7 +275,7 @@ module Aws::RDS
     #
     #   ^
     # @option options [Array<Types::Filter>] :filters
-    #   This parameter is not currently supported.
+    #   This parameter isn't currently supported.
     # @option options [Boolean] :default_only
     #   A value that indicates whether only the default version of the
     #   specified engine or engine and major version combination is returned.

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

@@ -59,7 +59,7 @@ module Aws::RDS
     end
 
     # The default character set for new instances of this engine version, if
-    # the `CharacterSetName` parameter of the CreateDBInstance API is not
+    # the `CharacterSetName` parameter of the CreateDBInstance API isn't
     # specified.
     # @return [Types::CharacterSet]
     def default_character_set
@@ -286,7 +286,7 @@ module Aws::RDS
     #   })
     # @param [Hash] options ({})
     # @option options [Array<Types::Filter>] :filters
-    #   This parameter is not currently supported.
+    #   This parameter isn't currently supported.
     # @return [OptionGroupOption::Collection]
     def option_group_options(options = {})
       batches = Enumerator.new do |y|
@@ -326,7 +326,7 @@ module Aws::RDS
     #   The name of the option group to describe. Can't be supplied together
     #   with EngineName or MajorEngineVersion.
     # @option options [Array<Types::Filter>] :filters
-    #   This parameter is not currently supported.
+    #   This parameter isn't currently supported.
     # @return [OptionGroup::Collection]
     def option_groups(options = {})
       batches = Enumerator.new do |y|

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

@@ -256,7 +256,7 @@ module Aws::RDS
       data[:publicly_accessible]
     end
 
-    # The status of a Read Replica. If the instance is not a Read Replica,
+    # The status of a Read Replica. If the instance isn't a Read Replica,
     # this is blank.
     # @return [Array<Types::DBInstanceStatusInfo>]
     def status_infos
@@ -679,7 +679,7 @@ module Aws::RDS
     #   **MySQL**
     #
     #   The name of the database to create when the DB instance is created. If
-    #   this parameter is not specified, no database is created in the DB
+    #   this parameter isn't specified, no database is created in the DB
     #   instance.
     #
     #   Constraints:
@@ -691,7 +691,7 @@ module Aws::RDS
     #   **MariaDB**
     #
     #   The name of the database to create when the DB instance is created. If
-    #   this parameter is not specified, no database is created in the DB
+    #   this parameter isn't specified, no database is created in the DB
     #   instance.
     #
     #   Constraints:
@@ -703,7 +703,7 @@ module Aws::RDS
     #   **PostgreSQL**
     #
     #   The name of the database to create when the DB instance is created. If
-    #   this parameter is not specified, the default "postgres" database is
+    #   this parameter isn't specified, the default "postgres" database is
     #   created in the DB instance.
     #
     #   Constraints:
@@ -736,7 +736,7 @@ module Aws::RDS
     #   **Amazon Aurora**
     #
     #   The name of the database to create when the primary instance of the DB
-    #   cluster is created. If this parameter is not specified, no database is
+    #   cluster is created. If this parameter isn't specified, no database is
     #   created in the DB instance.
     #
     #   Constraints:
@@ -1035,8 +1035,8 @@ module Aws::RDS
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#Concepts.DBMaintenance
     # @option options [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 the
-    #   default `DBParameterGroup` for the specified DB engine is used.
+    #   If you do not specify a value, then the default DB parameter group for
+    #   the specified DB engine and version is used.
     #
     #   Constraints:
     #
@@ -1230,15 +1230,15 @@ module Aws::RDS
     #   A value that indicates whether the DB instance is publicly accessible.
     #   When the DB instance is publicly accessible, it is an Internet-facing
     #   instance with a publicly resolvable DNS name, which resolves to a
-    #   public IP address. When the DB instance is not publicly accessible, it
+    #   public IP address. When the DB instance isn't publicly accessible, it
     #   is an internal instance with a DNS name that resolves to a private IP
     #   address.
     #
     #   Default: The default behavior varies depending on whether
     #   `DBSubnetGroupName` is specified.
     #
-    #   If `DBSubnetGroupName` is not specified, and `PubliclyAccessible` is
-    #   not specified, the following applies:
+    #   If `DBSubnetGroupName` isn't specified, and `PubliclyAccessible`
+    #   isn't specified, the following applies:
     #
     #   * If the default VPC in the target region doesn’t have an Internet
     #     gateway attached to it, the DB instance is private.
@@ -1246,7 +1246,7 @@ module Aws::RDS
     #   * If the default VPC in the target region has an Internet gateway
     #     attached to it, the DB instance is public.
     #
-    #   If `DBSubnetGroupName` is specified, and `PubliclyAccessible` is not
+    #   If `DBSubnetGroupName` is specified, and `PubliclyAccessible` isn't
     #   specified, the following applies:
     #
     #   * If the subnets are part of a VPC that doesn’t have an Internet
@@ -1275,7 +1275,7 @@ module Aws::RDS
     #   the device.
     # @option options [Boolean] :storage_encrypted
     #   A value that indicates whether the DB instance is encrypted. By
-    #   default, it is not encrypted.
+    #   default, it isn't encrypted.
     #
     #   **Amazon Aurora**
     #
@@ -1571,6 +1571,11 @@ module Aws::RDS
     #   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.
+    #
+    #    </note>
+    #
     #   Constraints:
     #
     #   * Must be 1 to 255 letters, numbers, or hyphens.
@@ -1582,7 +1587,7 @@ module Aws::RDS
     #   A value that indicates whether the DB instance is publicly accessible.
     #   When the DB instance is publicly accessible, it is an Internet-facing
     #   instance with a publicly resolvable DNS name, which resolves to a
-    #   public IP address. When the DB instance is not publicly accessible, it
+    #   public IP address. When the DB instance isn't publicly accessible, it
     #   is an internal instance with a DNS name that resolves to a private IP
     #   address. For more information, see CreateDBInstance.
     # @option options [Array<Types::Tag>] :tags
@@ -1595,7 +1600,7 @@ module Aws::RDS
     # @option options [String] :db_subnet_group_name
     #   Specifies a DB subnet group for the DB instance. The new DB instance
     #   is created in the VPC associated with the DB subnet group. If no DB
-    #   subnet group is specified, then the new DB instance is not created in
+    #   subnet group is specified, then the new DB instance isn't created in
     #   a VPC.
     #
     #   Constraints:
@@ -1681,10 +1686,9 @@ module Aws::RDS
     #   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. You can
-    #   specify the `--source-region` option instead of this parameter when
-    #   you create an encrypted Read Replica from another AWS Region by using
-    #   the AWS CLI.
+    #   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
     #   `CreateDBInstanceReadReplica` API action that can be executed in the
@@ -1722,6 +1726,14 @@ module Aws::RDS
     #   [Authenticating Requests: Using Query Parameters (AWS Signature
     #   Version 4)][1] and [Signature Version 4 Signing Process][2].
     #
+    #   <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
+    #   operation that can be executed in the source AWS Region.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html
@@ -1870,8 +1882,8 @@ module Aws::RDS
     # @option options [Boolean] :skip_final_snapshot
     #   A value that indicates whether to skip the creation of a final DB
     #   snapshot before the DB instance is deleted. If skip is specified, no
-    #   DB snapshot is created. If skip is not specified, a DB snapshot is
-    #   created before the DB instance is deleted. By default, skip is not
+    #   DB snapshot is created. If skip isn't specified, a DB snapshot is
+    #   created before the DB instance is deleted. By default, skip isn't
     #   specified, and the DB snapshot is created.
     #
     #   Note that when a DB instance is in a failure state and has a status of
@@ -1880,8 +1892,8 @@ module Aws::RDS
     #
     #   Specify skip when deleting a Read Replica.
     #
-    #   <note markdown="1"> The FinalDBSnapshotIdentifier parameter must be specified if skip is
-    #   not specified.
+    #   <note markdown="1"> The FinalDBSnapshotIdentifier parameter must be specified if skip
+    #   isn't specified.
     #
     #    </note>
     # @option options [String] :final_db_snapshot_identifier
@@ -2001,7 +2013,7 @@ module Aws::RDS
     # @option options [String] :db_subnet_group_name
     #   The new DB subnet group for the DB instance. You can use this
     #   parameter to move your DB instance to a different VPC. If your DB
-    #   instance is not in a VPC, you can also use this parameter to move your
+    #   instance isn't in a VPC, you can also use this parameter to move your
     #   DB instance into a VPC. For more information, see [Updating the VPC
     #   for a DB Instance][1] in the *Amazon RDS User Guide.*
     #
@@ -2411,7 +2423,7 @@ module Aws::RDS
     #   A value that indicates whether the DB instance is publicly accessible.
     #   When the DB instance is publicly accessible, it is an Internet-facing
     #   instance with a publicly resolvable DNS name, which resolves to a
-    #   public IP address. When the DB instance is not publicly accessible, it
+    #   public IP address. When the DB instance isn't publicly accessible, it
     #   is an internal instance with a DNS name that resolves to a private IP
     #   address.
     #
@@ -2584,7 +2596,7 @@ module Aws::RDS
     #   A value that indicates whether the reboot is conducted through a
     #   Multi-AZ failover.
     #
-    #   Constraint: You can't enable force failover if the instance is not
+    #   Constraint: You can't enable force failover if the instance isn't
     #   configured for Multi-AZ.
     # @return [DBInstance]
     def reboot(options = {})
@@ -2668,7 +2680,7 @@ module Aws::RDS
     #   Example: `2009-09-07T23:45:00Z`
     # @option options [Boolean] :use_latest_restorable_time
     #   A value that indicates whether the DB instance is restored from the
-    #   latest backup time. By default, the DB instance is not restored from
+    #   latest backup time. By default, the DB instance isn't restored from
     #   the latest backup time.
     #
     #   Constraints: Can't be specified if the `RestoreTime` parameter is
@@ -2717,7 +2729,7 @@ module Aws::RDS
     #   A value that indicates whether the DB instance is publicly accessible.
     #   When the DB instance is publicly accessible, it is an Internet-facing
     #   instance with a publicly resolvable DNS name, which resolves to a
-    #   public IP address. When the DB instance is not publicly accessible, it
+    #   public IP address. When the DB instance isn't publicly accessible, it
     #   is an internal instance with a DNS name that resolves to a private IP
     #   address. For more information, see CreateDBInstance.
     # @option options [Boolean] :auto_minor_version_upgrade
@@ -2733,7 +2745,7 @@ module Aws::RDS
     # @option options [String] :db_name
     #   The database name for the restored DB instance.
     #
-    #   <note markdown="1"> This parameter is not used for the MySQL or MariaDB engines.
+    #   <note markdown="1"> This parameter isn't used for the MySQL or MariaDB engines.
     #
     #    </note>
     # @option options [String] :engine
@@ -2774,7 +2786,7 @@ module Aws::RDS
     #
     #   **SQL Server**
     #
-    #   Setting the IOPS value for the SQL Server database engine is not
+    #   Setting the IOPS value for the SQL Server database engine isn't
     #   supported.
     # @option options [String] :option_group_name
     #   The name of the option group to be used for the restored DB instance.
@@ -3012,7 +3024,7 @@ module Aws::RDS
     #   A list of event categories that trigger notifications for a event
     #   notification subscription.
     # @option options [Array<Types::Filter>] :filters
-    #   This parameter is not currently supported.
+    #   This parameter isn't currently supported.
     # @return [Event::Collection]
     def events(options = {})
       batches = Enumerator.new do |y|
@@ -3061,7 +3073,7 @@ module Aws::RDS
     #   Filters the available log files for files larger than the specified
     #   size.
     # @option options [Array<Types::Filter>] :filters
-    #   This parameter is not currently supported.
+    #   This parameter isn't currently supported.
     # @return [DBLogFile::Collection]
     def log_files(options = {})
       batches = Enumerator.new do |y|