aws-sdk-rds 1.134.0 → 1.138.0

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

@@ -28,6 +28,7 @@ require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
+require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/query.rb'
 require 'aws-sdk-rds/plugins/cross_region_copying.rb'
@@ -76,6 +77,7 @@ module Aws::RDS
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
     add_plugin(Aws::Plugins::DefaultsMode)
+    add_plugin(Aws::Plugins::RecursionDetection)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::Query)
     add_plugin(Aws::RDS::Plugins::CrossRegionCopying)
@@ -455,6 +457,9 @@ module Aws::RDS
     #   * If the source type is a DB cluster snapshot, a
     #     `DBClusterSnapshotIdentifier` value must be supplied.
     #
+    #   * If the source type is an RDS Proxy, a `DBProxyName` value must be
+    #     supplied.
+    #
     # @return [Types::AddSourceIdentifierToSubscriptionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::AddSourceIdentifierToSubscriptionResult#event_subscription #event_subscription} => Types::EventSubscription
@@ -1860,15 +1865,20 @@ module Aws::RDS
     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, you upload
-    # your database installation files in Amazon S3.
+    # version, and create your database. With Amazon RDS Custom for Oracle,
+    # you upload your database installation files in Amazon S3.
     #
     # When you create a custom engine version, you specify the files in a
     # JSON document called a CEV manifest. This document describes
@@ -1910,8 +1920,8 @@ module Aws::RDS
     # @option params [required, String] :engine_version
     #   The name of your CEV. The name format is `19.customized_string `. For
     #   example, a valid name is `19.my_cev1`. This setting is required for
-    #   RDS Custom, but optional for Amazon RDS. The combination of `Engine`
-    #   and `EngineVersion` is unique per customer per Region.
+    #   RDS Custom for Oracle, but optional for Amazon RDS. The combination of
+    #   `Engine` and `EngineVersion` is unique per customer per Region.
     #
     # @option params [required, String] :database_installation_files_s3_bucket_name
     #   The name of an Amazon S3 bucket that contains database installation
@@ -2200,7 +2210,7 @@ module Aws::RDS
     #   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
     #
@@ -2211,7 +2221,8 @@ module Aws::RDS
     #
     #   * `aurora` (for MySQL 5.6-compatible Aurora)
     #
-    #   * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
+    #   * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
+    #     Aurora)
     #
     #   * `aurora-postgresql`
     #
@@ -2231,7 +2242,7 @@ module Aws::RDS
     #   "DBEngineVersions[].EngineVersion"`
     #
     #   To list all of the available engine versions for MySQL 5.7-compatible
-    #   Aurora, use the following command:
+    #   and MySQL 8.0-compatible Aurora, use the following command:
     #
     #   `aws rds describe-db-engine-versions --engine aurora-mysql --query
     #   "DBEngineVersions[].EngineVersion"`
@@ -2678,11 +2689,11 @@ module Aws::RDS
     #
     #   This setting is required to create a Multi-AZ DB cluster.
     #
-    #   Valid values: `standard | gp2 | io1`
+    #   Valid values: `io1`
     #
-    #   If you specify `io1`, also include a value for the `Iops` parameter.
+    #   When specified, a value for the `Iops` parameter is required.
     #
-    #   Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
+    #   Default: `io1`
     #
     #   Valid for: Multi-AZ DB clusters only
     #
@@ -3178,7 +3189,7 @@ module Aws::RDS
     #
     #   **Aurora MySQL**
     #
-    #   Example: `aurora5.6`, `aurora-mysql5.7`
+    #   Example: `aurora5.6`, `aurora-mysql5.7`, `aurora-mysql8.0`
     #
     #   **Aurora PostgreSQL**
     #
@@ -3213,7 +3224,8 @@ module Aws::RDS
     #
     #   * `aurora` (for MySQL 5.6-compatible Aurora)
     #
-    #   * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
+    #   * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
+    #     Aurora)
     #
     #   * `aurora-postgresql`
     #
@@ -3461,7 +3473,7 @@ module Aws::RDS
     #
     #   ^
     #
-    #   **Amazon RDS Custom**
+    #   **Amazon RDS Custom for Oracle**
     #
     #   The Oracle System ID (SID) of the created RDS Custom DB instance. If
     #   you don't specify a value, the default value is `ORCL`.
@@ -3476,6 +3488,10 @@ module Aws::RDS
     #
     #   * It can't be a word reserved by the database engine.
     #
+    #   **Amazon RDS Custom for SQL Server**
+    #
+    #   Not applicable. Must be null.
+    #
     #   **SQL Server**
     #
     #   Not applicable. Must be null.
@@ -3541,9 +3557,11 @@ module Aws::RDS
     #   following:
     #
     #   * General Purpose (SSD) storage (gp2): Must be an integer from 40 to
-    #     65536.
+    #     65536 for RDS Custom for Oracle, 16384 for RDS Custom for SQL
+    #     Server.
     #
-    #   * Provisioned IOPS storage (io1): Must be an integer from 40 to 65536.
+    #   * Provisioned IOPS storage (io1): Must be an integer from 40 to 65536
+    #     for RDS Custom for Oracle, 16384 for RDS Custom for SQL Server.
     #
     #   **MySQL**
     #
@@ -3604,21 +3622,21 @@ module Aws::RDS
     #
     #   * General Purpose (SSD) storage (gp2):
     #
-    #     * Enterprise and Standard editions: Must be an integer from 200 to
+    #     * Enterprise and Standard editions: Must be an integer from 20 to
     #       16384.
     #
     #     * Web and Express editions: Must be an integer from 20 to 16384.
     #
     #   * Provisioned IOPS storage (io1):
     #
-    #     * Enterprise and Standard editions: Must be an integer from 200 to
+    #     * Enterprise and Standard editions: Must be an integer from 100 to
     #       16384.
     #
     #     * Web and Express editions: Must be an integer from 100 to 16384.
     #
     #   * Magnetic storage (standard):
     #
-    #     * Enterprise and Standard editions: Must be an integer from 200 to
+    #     * Enterprise and Standard editions: Must be an integer from 20 to
     #       1024.
     #
     #     * Web and Express editions: Must be an integer from 20 to 1024.
@@ -3644,11 +3662,18 @@ module Aws::RDS
     #
     #   * `aurora` (for MySQL 5.6-compatible Aurora)
     #
-    #   * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
+    #   * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
+    #     Aurora)
     #
     #   * `aurora-postgresql`
     #
-    #   * `custom-oracle-ee (for RDS Custom instances)`
+    #   * `custom-oracle-ee (for RDS Custom for Oracle instances)`
+    #
+    #   * `custom-sqlserver-ee (for RDS Custom for SQL Server instances)`
+    #
+    #   * `custom-sqlserver-se (for RDS Custom for SQL Server instances)`
+    #
+    #   * `custom-sqlserver-web (for RDS Custom for SQL Server instances)`
     #
     #   * `mariadb`
     #
@@ -3743,6 +3768,10 @@ module Aws::RDS
     #   information on Amazon Web Services Regions and Availability Zones, see
     #   [Regions and Availability Zones][1].
     #
+    #   **Amazon Aurora**
+    #
+    #   Not applicable. Availability Zones are managed by the DB cluster.
+    #
     #   Default: A random, system-chosen Availability Zone in the endpoint's
     #   Amazon Web Services Region.
     #
@@ -3770,7 +3799,10 @@ module Aws::RDS
     # @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
@@ -3824,7 +3856,7 @@ module Aws::RDS
     #
     #   * Can't be set to 0 if the DB instance is a source to read replicas
     #
-    #   * Can't be set to 0 or 35 for an RDS Custom DB instance
+    #   * Can't be set to 0 or 35 for an RDS Custom for Oracle DB instance
     #
     # @option params [String] :preferred_backup_window
     #   The daily time range during which automated backups are created if
@@ -3923,47 +3955,53 @@ module Aws::RDS
     #   Not applicable. The version number of the database engine to be used
     #   by the DB instance is managed by the DB cluster.
     #
-    #   **Amazon RDS Custom**
+    #   **Amazon RDS Custom for Oracle**
     #
     #   A custom engine version (CEV) that you have previously created. This
-    #   setting is required for RDS Custom. The CEV name has the following
-    #   format: `19.customized_string `. An example identifier is
-    #   `19.my_cev1`. For more information, see [ Creating an RDS Custom DB
-    #   instance][1] in the *Amazon RDS User Guide.*.
+    #   setting is required for RDS Custom for Oracle. The CEV name has the
+    #   following format: `19.customized_string `. An example identifier is
+    #   `19.my_cev1`. For more information, see [ Creating an RDS Custom for
+    #   Oracle DB instance][1] in the *Amazon RDS User Guide.*.
+    #
+    #   **Amazon RDS Custom for SQL Server**
+    #
+    #   See [RDS Custom for SQL Server general requirements][2] in the *Amazon
+    #   RDS User Guide.*
     #
     #   **MariaDB**
     #
-    #   For information, see [MariaDB on Amazon RDS Versions][2] in the
+    #   For information, see [MariaDB on Amazon RDS Versions][3] in the
     #   *Amazon RDS User Guide.*
     #
     #   **Microsoft SQL Server**
     #
-    #   For information, see [Microsoft SQL Server Versions on Amazon RDS][3]
+    #   For information, see [Microsoft SQL Server Versions on Amazon RDS][4]
     #   in the *Amazon RDS User Guide.*
     #
     #   **MySQL**
     #
-    #   For information, see [MySQL on Amazon RDS Versions][4] in the *Amazon
+    #   For information, see [MySQL on Amazon RDS Versions][5] in the *Amazon
     #   RDS User Guide.*
     #
     #   **Oracle**
     #
-    #   For information, see [Oracle Database Engine Release Notes][5] in the
+    #   For information, see [Oracle Database Engine Release Notes][6] in the
     #   *Amazon RDS User Guide.*
     #
     #   **PostgreSQL**
     #
     #   For information, see [Amazon RDS for PostgreSQL versions and
-    #   extensions][6] in the *Amazon RDS User Guide.*
+    #   extensions][7] in the *Amazon RDS User Guide.*
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-creating.html#custom-creating.create
-    #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MariaDB.html#MariaDB.Concepts.VersionMgmt
-    #   [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
-    #   [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
-    #   [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html
-    #   [6]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
+    #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-reqs-limits.html#custom-reqs-limits.reqsMS
+    #   [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MariaDB.html#MariaDB.Concepts.VersionMgmt
+    #   [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
+    #   [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
+    #   [6]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html
+    #   [7]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
     #
     # @option params [Boolean] :auto_minor_version_upgrade
     #   A value that indicates whether minor engine upgrades are applied
@@ -4093,9 +4131,8 @@ module Aws::RDS
     #   A value that indicates whether the DB instance is encrypted. By
     #   default, it isn't encrypted.
     #
-    #   For RDS Custom Oracle instances, either set this parameter to `true`
-    #   or leave it unset. If you set this parameter to `false`, RDS reports
-    #   an error.
+    #   For RDS Custom instances, either set this parameter to `true` or leave
+    #   it unset. If you set this parameter to `false`, RDS reports an error.
     #
     #   **Amazon Aurora**
     #
@@ -4124,11 +4161,11 @@ module Aws::RDS
     #
     #   **Amazon RDS Custom**
     #
-    #   A KMS key is required for RDS Custom Oracle instances. For most RDS
-    #   engines, if you leave this parameter empty while enabling
-    #   `StorageEncrypted`, the engine uses the default KMS key. However, RDS
-    #   Custom for Oracle doesn't use the default key when this parameter is
-    #   empty. You must explicitly specify a key.
+    #   A KMS key is required for RDS Custom instances. For most RDS engines,
+    #   if you leave this parameter empty while enabling `StorageEncrypted`,
+    #   the engine uses the default KMS key. However, RDS Custom doesn't use
+    #   the default key when this parameter is empty. You must explicitly
+    #   specify a key.
     #
     # @option params [String] :domain
     #   The Active Directory directory ID to create the DB instance in.
@@ -4827,7 +4864,7 @@ module Aws::RDS
     #     * 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
@@ -5443,7 +5480,8 @@ module Aws::RDS
     #
     #   * `aurora` (for MySQL 5.6-compatible Aurora)
     #
-    #   * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
+    #   * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
+    #     Aurora)
     #
     #   * `aurora-postgresql`
     #
@@ -5934,10 +5972,16 @@ module Aws::RDS
     #   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:
+    #
+    #   * Must contain no more than 255 letters, numbers, periods,
+    #     underscores, spaces, or hyphens.
+    #
+    #   * Must not be default.
     #
-    #   Example: `mySubnetgroup`
+    #   * First character must be a letter.
+    #
+    #   Example: `mydbsubnetgroup`
     #
     # @option params [required, String] :db_subnet_group_description
     #   The description for the DB subnet group.
@@ -6023,13 +6067,13 @@ module Aws::RDS
     # `Availability`, `Backup`.
     #
     # If you specify both the `SourceType` and `SourceIds`, such as
-    # `SourceType` = `db-instance` and `SourceIdentifier` = `myDBInstance1`,
-    # you are notified of all the `db-instance` events for the specified
-    # source. If you specify a `SourceType` but do not specify a
-    # `SourceIdentifier`, you receive notice of the events for that source
-    # type for all your RDS sources. If you don't specify either the
-    # SourceType or the `SourceIdentifier`, you are notified of events
-    # generated from all RDS sources belonging to your customer account.
+    # `SourceType` = `db-instance` and `SourceIds` = `myDBInstance1`, you
+    # are notified of all the `db-instance` events for the specified source.
+    # If you specify a `SourceType` but do not specify `SourceIds`, you
+    # receive notice of the events for that source type for all your RDS
+    # sources. If you don't specify either the SourceType or the
+    # `SourceIds`, you are notified of events generated from all RDS sources
+    # belonging to your customer account.
     #
     # <note markdown="1"> RDS event notification is only available for unencrypted SNS topics.
     # If you specify an encrypted SNS topic, event notifications aren't
@@ -6050,21 +6094,25 @@ module Aws::RDS
     # @option params [String] :source_type
     #   The type of source that is generating the events. For example, if you
     #   want to be notified of events generated by a DB instance, you set this
-    #   parameter to `db-instance`. If this value isn't specified, all events
-    #   are returned.
+    #   parameter to `db-instance`. For RDS Proxy events, specify `db-proxy`.
+    #   If this value isn't specified, all events are returned.
     #
     #   Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group` \|
-    #   `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
+    #   `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot` \|
+    #   `db-proxy`
     #
     # @option params [Array<String>] :event_categories
     #   A list of event categories for a particular source type (`SourceType`)
     #   that you want to subscribe to. You can see a list of the categories
-    #   for a given source type in [Events][1] in the *Amazon RDS User Guide*
-    #   or by using the `DescribeEventCategories` operation.
+    #   for a given source type in the "Amazon RDS event categories and event
+    #   messages" section of the [ *Amazon RDS User Guide* ][1] or the [
+    #   *Amazon Aurora User Guide* ][2]. You can also see this list by using
+    #   the `DescribeEventCategories` operation.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Events.html
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Events.Messages.html
+    #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Events.Messages.html
     #
     # @option params [Array<String>] :source_ids
     #   The list of identifiers of the event sources for which events are
@@ -6095,6 +6143,9 @@ module Aws::RDS
     #   * If the source type is a DB cluster snapshot, a
     #     `DBClusterSnapshotIdentifier` value must be supplied.
     #
+    #   * If the source type is an RDS Proxy, a `DBProxyName` value must be
+    #     supplied.
+    #
     # @option params [Boolean] :enabled
     #   A value that indicates whether to activate the subscription. If the
     #   event notification subscription isn't activated, the subscription is
@@ -7597,12 +7648,10 @@ module Aws::RDS
     #
     #    </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}.
     #
@@ -8994,7 +9043,8 @@ module Aws::RDS
     #
     #   * `aurora` (for MySQL 5.6-compatible Aurora)
     #
-    #   * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
+    #   * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
+    #     Aurora)
     #
     #   * `aurora-postgresql`
     #
@@ -10800,19 +10850,23 @@ module Aws::RDS
     end
 
     # Displays a list of categories for all event source types, or, if
-    # specified, for a specified source type. You can see a list of the
-    # event categories and source types in [ Events][1] in the *Amazon RDS
-    # User Guide.*
+    # specified, for a specified source type. You can also see this list in
+    # the "Amazon RDS event categories and event messages" section of the
+    # [ *Amazon RDS User Guide* ][1] or the [ *Amazon Aurora User Guide*
+    # ][2].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Events.html
+    # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Events.Messages.html
+    # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Events.Messages.html
     #
     # @option params [String] :source_type
-    #   The type of source that is generating the events.
+    #   The type of source that is generating the events. For RDS Proxy
+    #   events, specify `db-proxy`.
     #
     #   Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group` \|
-    #   `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
+    #   `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot` \|
+    #   `db-proxy`
     #
     # @option params [Array<Types::Filter>] :filters
     #   This parameter isn't currently supported.
@@ -10954,13 +11008,13 @@ module Aws::RDS
     end
 
     # Returns events related to DB instances, DB clusters, DB parameter
-    # groups, DB security groups, DB snapshots, and DB cluster snapshots for
-    # the past 14 days. Events specific to a particular DB instances, DB
-    # clusters, DB parameter groups, DB security groups, DB snapshots, and
-    # DB cluster snapshots group can be obtained by providing the name as a
-    # parameter.
+    # groups, DB security groups, DB snapshots, DB cluster snapshots, and
+    # RDS Proxies for the past 14 days. Events specific to a particular DB
+    # instance, DB cluster, DB parameter group, DB security group, DB
+    # snapshot, DB cluster snapshot group, or RDS Proxy can be obtained by
+    # providing the name as a parameter.
     #
-    # <note markdown="1"> By default, the past hour of events are returned.
+    # <note markdown="1"> By default, RDS returns events that were generated in the past hour.
     #
     #  </note>
     #
@@ -10991,6 +11045,9 @@ module Aws::RDS
     #   * If the source type is a DB cluster snapshot, a
     #     `DBClusterSnapshotIdentifier` value must be supplied.
     #
+    #   * If the source type is an RDS Proxy, a `DBProxyName` value must be
+    #     supplied.
+    #
     #   * Can't end with a hyphen or contain two consecutive hyphens.
     #
     # @option params [String] :source_type
@@ -11076,7 +11133,7 @@ module Aws::RDS
     #
     #   resp = client.describe_events({
     #     source_identifier: "String",
-    #     source_type: "db-instance", # accepts db-instance, db-parameter-group, db-security-group, db-snapshot, db-cluster, db-cluster-snapshot, custom-engine-version
+    #     source_type: "db-instance", # accepts db-instance, db-parameter-group, db-security-group, db-snapshot, db-cluster, db-cluster-snapshot, custom-engine-version, db-proxy
     #     start_time: Time.now,
     #     end_time: Time.now,
     #     duration: 1,
@@ -11096,7 +11153,7 @@ module Aws::RDS
     #   resp.marker #=> String
     #   resp.events #=> Array
     #   resp.events[0].source_identifier #=> String
-    #   resp.events[0].source_type #=> String, one of "db-instance", "db-parameter-group", "db-security-group", "db-snapshot", "db-cluster", "db-cluster-snapshot", "custom-engine-version"
+    #   resp.events[0].source_type #=> String, one of "db-instance", "db-parameter-group", "db-security-group", "db-snapshot", "db-cluster", "db-cluster-snapshot", "custom-engine-version", "db-proxy"
     #   resp.events[0].message #=> String
     #   resp.events[0].event_categories #=> Array
     #   resp.events[0].event_categories[0] #=> String
@@ -11673,7 +11730,8 @@ module Aws::RDS
     #
     #   * `aurora` (for MySQL 5.6-compatible Aurora)
     #
-    #   * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
+    #   * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
+    #     Aurora)
     #
     #   * `aurora-postgresql`
     #
@@ -13136,9 +13194,9 @@ module Aws::RDS
     #
     # @option params [required, String] :engine_version
     #   The custom engine version (CEV) that you want to modify. This option
-    #   is required for RDS Custom, but optional for Amazon RDS. The
-    #   combination of `Engine` and `EngineVersion` is unique per customer per
-    #   Amazon Web Services Region.
+    #   is required for RDS Custom for Oracle, but optional for Amazon RDS.
+    #   The combination of `Engine` and `EngineVersion` is unique per customer
+    #   per Amazon Web Services Region.
     #
     # @option params [String] :description
     #   An optional description of your CEV.
@@ -13469,7 +13527,7 @@ module Aws::RDS
     #   "DBEngineVersions[].EngineVersion"`
     #
     #   To list all of the available engine versions for MySQL 5.7-compatible
-    #   Aurora, use the following command:
+    #   and MySQL 8.0-compatible Aurora, use the following command:
     #
     #   `aws rds describe-db-engine-versions --engine aurora-mysql --query
     #   "DBEngineVersions[].EngineVersion"`
@@ -13627,12 +13685,11 @@ module Aws::RDS
     # @option params [String] :storage_type
     #   Specifies the storage type to be associated with the DB cluster.
     #
-    #   Valid values: `standard | gp2 | io1`
+    #   Valid values: `io1`
     #
-    #   If you specify `io1`, you must also include a value for the `Iops`
-    #   parameter.
+    #   When specified, a value for the `Iops` parameter is required.
     #
-    #   Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
+    #   Default: `io1`
     #
     #   Valid for: Multi-AZ DB clusters only
     #
@@ -14256,7 +14313,7 @@ module Aws::RDS
     #   change. The change is applied during the next maintenance window,
     #   unless `ApplyImmediately` is enabled for this request.
     #
-    #   This setting doesn't apply to RDS Custom.
+    #   This setting doesn't apply to RDS Custom for Oracle.
     #
     #   Default: Uses existing setting
     #
@@ -14280,7 +14337,7 @@ module Aws::RDS
     #   Constraints: If supplied, must match the name of an existing
     #   DBSubnetGroup.
     #
-    #   Example: `mySubnetGroup`
+    #   Example: `mydbsubnetgroup`
     #
     #
     #
@@ -14327,7 +14384,7 @@ module Aws::RDS
     #   during the next maintenance window. Some parameter changes can cause
     #   an outage and are applied on the next call to RebootDBInstance, or the
     #   next failure reboot. Review the table of parameters in [Modifying a DB
-    #   Instance][1] in the *Amazon RDS User Guide.* to see the impact of
+    #   Instance][1] in the *Amazon RDS User Guide* to see the impact of
     #   enabling or disabling `ApplyImmediately` for each modified parameter
     #   and to determine when the changes are applied.
     #
@@ -14427,7 +14484,7 @@ module Aws::RDS
     #
     #   * It must be a value from 0 to 35. It can't be set to 0 if the DB
     #     instance is a source to read replicas. It can't be set to 0 or 35
-    #     for an RDS Custom DB instance.
+    #     for an RDS Custom for Oracle DB instance.
     #
     #   * It can be specified for a MySQL read replica only if the source is
     #     running MySQL 5.6 or later.
@@ -14514,8 +14571,8 @@ module Aws::RDS
     #   lower. For information about valid engine versions, see
     #   `CreateDBInstance`, or call `DescribeDBEngineVersions`.
     #
-    #   In RDS Custom, this parameter is supported for read replicas only if
-    #   they are in the `PATCH_DB_FAILURE` lifecycle.
+    #   In RDS Custom for Oracle, this parameter is supported for read
+    #   replicas only if they are in the `PATCH_DB_FAILURE` lifecycle.
     #
     # @option params [Boolean] :allow_major_version_upgrade
     #   A value that indicates whether major version upgrades are allowed.
@@ -14777,8 +14834,6 @@ module Aws::RDS
     #   Changes to the `PubliclyAccessible` parameter are applied immediately
     #   regardless of the value of the `ApplyImmediately` parameter.
     #
-    #   This setting doesn't apply to RDS Custom.
-    #
     # @option params [String] :monitoring_role_arn
     #   The ARN for the IAM role that permits RDS to send enhanced monitoring
     #   metrics to Amazon CloudWatch Logs. For example,
@@ -15272,26 +15327,36 @@ module Aws::RDS
     # @option params [required, Array<Types::Parameter>] :parameters
     #   An array of parameter names, values, and the application methods for
     #   the parameter update. At least one parameter name, value, and
-    #   application method method must be supplied; later arguments are
-    #   optional. A maximum of 20 parameters can be modified in a single
-    #   request.
+    #   application method must be supplied; later arguments are optional. A
+    #   maximum of 20 parameters can be modified in a single request.
     #
     #   Valid Values (for the application method): `immediate |
     #   pending-reboot`
     #
-    #   <note markdown="1"> You can use the `immediate` value with dynamic parameters only. You
+    #   You can use the `immediate` value with dynamic parameters only. You
     #   can use the `pending-reboot` value for both dynamic and static
     #   parameters.
     #
-    #    When the application method is `immediate`, changes to dynamic
+    #   When the application method is `immediate`, changes to dynamic
     #   parameters are applied immediately to the DB instances associated with
-    #   the parameter group. When the application method is `pending-reboot`,
-    #   changes to dynamic and static parameters are applied after a reboot
-    #   without failover to the DB instances associated with the parameter
-    #   group.
+    #   the parameter group.
+    #
+    #   When the application method is `pending-reboot`, changes to dynamic
+    #   and static parameters are applied after a reboot without failover to
+    #   the DB instances associated with the parameter group.
+    #
+    #   <note markdown="1"> You can't use `pending-reboot` with dynamic parameters on RDS for SQL
+    #   Server DB instances. Use `immediate`.
     #
     #    </note>
     #
+    #   For more information on modifying DB parameters, see [Working with DB
+    #   parameter groups][1] in the *Amazon RDS User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html
+    #
     # @return [Types::DBParameterGroupNameMessage] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DBParameterGroupNameMessage#db_parameter_group_name #db_parameter_group_name} => String
@@ -15798,7 +15863,7 @@ module Aws::RDS
     #   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.
@@ -15884,11 +15949,12 @@ module Aws::RDS
     # @option params [String] :source_type
     #   The type of source that is generating the events. For example, if you
     #   want to be notified of events generated by a DB instance, you would
-    #   set this parameter to db-instance. If this value isn't specified, all
-    #   events are returned.
+    #   set this parameter to db-instance. For RDS Proxy events, specify
+    #   `db-proxy`. If this value isn't specified, all events are returned.
     #
     #   Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group` \|
-    #   `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
+    #   `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot` \|
+    #   `db-proxy`
     #
     # @option params [Array<String>] :event_categories
     #   A list of event categories for a source type (`SourceType`) that you
@@ -16019,7 +16085,8 @@ module Aws::RDS
     #   '*[]|[?SupportsGlobalDatabases == `true`].[EngineVersion]' ``
     #
     #   To list all of the available engine versions for `aurora-mysql` (for
-    #   MySQL 5.7-compatible Aurora), use the following command:
+    #   MySQL 5.7-compatible and MySQL 8.0-compatible Aurora), use the
+    #   following command:
     #
     #   `` aws rds describe-db-engine-versions --engine aurora-mysql --query
     #   '*[]|[?SupportsGlobalDatabases == `true`].[EngineVersion]' ``
@@ -17636,14 +17703,14 @@ module Aws::RDS
     #   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),
-    #   `aurora-mysql` (for MySQL 5.7-compatible Aurora), and
-    #   `aurora-postgresql`
+    #   `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
+    #   Aurora), and `aurora-postgresql`
     #
     # @option params [String] :engine_version
     #   The version number of the database engine to use.
@@ -17655,7 +17722,8 @@ module Aws::RDS
     #   "DBEngineVersions[].EngineVersion"`
     #
     #   To list all of the available engine versions for `aurora-mysql` (for
-    #   MySQL 5.7-compatible Aurora), use the following command:
+    #   MySQL 5.7-compatible and MySQL 8.0-compatible Aurora), use the
+    #   following command:
     #
     #   `aws rds describe-db-engine-versions --engine aurora-mysql --query
     #   "DBEngineVersions[].EngineVersion"`
@@ -17669,7 +17737,7 @@ module Aws::RDS
     #   **Aurora MySQL**
     #
     #   Example: `5.6.10a`, `5.6.mysql_aurora.1.19.2`, `5.7.12`,
-    #   `5.7.mysql_aurora.2.04.5`
+    #   `5.7.mysql_aurora.2.04.5`, `8.0.mysql_aurora.3.01.0`
     #
     #   **Aurora PostgreSQL**
     #
@@ -18116,7 +18184,7 @@ module Aws::RDS
     #   "DBEngineVersions[].EngineVersion"`
     #
     #   To list all of the available engine versions for MySQL 5.7-compatible
-    #   Aurora, use the following command:
+    #   and MySQL 8.0-compatible Aurora, use the following command:
     #
     #   `aws rds describe-db-engine-versions --engine aurora-mysql --query
     #   "DBEngineVersions[].EngineVersion"`
@@ -18182,7 +18250,7 @@ module Aws::RDS
     #   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
     #
@@ -18365,12 +18433,11 @@ module Aws::RDS
     #   Specifies the storage type to be associated with the each DB instance
     #   in the Multi-AZ DB cluster.
     #
-    #   Valid values: `standard | gp2 | io1`
+    #   Valid values: `io1`
     #
-    #   If you specify `io1`, you must also include a value for the `Iops`
-    #   parameter.
+    #   When specified, a value for the `Iops` parameter is required.
     #
-    #   Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
+    #   Default: `io1`
     #
     #   Valid for: Aurora DB clusters and Multi-AZ DB clusters
     #
@@ -18729,7 +18796,7 @@ module Aws::RDS
     #   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
     #
@@ -18912,11 +18979,11 @@ module Aws::RDS
     #   Specifies the storage type to be associated with the each DB instance
     #   in the Multi-AZ DB cluster.
     #
-    #   Valid values: `standard | gp2 | io1`
+    #   Valid values: `io1`
     #
-    #   If you specify `io1`, also include a value for the `Iops` parameter.
+    #   When specified, a value for the `Iops` parameter is required.
     #
-    #   Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
+    #   Default: `io1`
     #
     #   Valid for: Multi-AZ DB clusters only
     #
@@ -19237,7 +19304,7 @@ module Aws::RDS
     #   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
@@ -19404,8 +19471,21 @@ module Aws::RDS
     #
     # @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
@@ -19517,8 +19597,7 @@ module Aws::RDS
     #     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.
     #
@@ -19941,6 +20020,11 @@ module Aws::RDS
     # @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
@@ -20530,7 +20614,7 @@ module Aws::RDS
     #   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
@@ -22302,7 +22386,7 @@ module Aws::RDS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-rds'
-      context[:gem_version] = '1.134.0'
+      context[:gem_version] = '1.138.0'
       Seahorse::Client::Request.new(handlers, context)
     end