aws-sdk-rds 1.134.0 → 1.138.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -28,6 +28,7 @@ require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
28
28
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
29
  require 'aws-sdk-core/plugins/http_checksum.rb'
30
30
  require 'aws-sdk-core/plugins/defaults_mode.rb'
31
+ require 'aws-sdk-core/plugins/recursion_detection.rb'
31
32
  require 'aws-sdk-core/plugins/signature_v4.rb'
32
33
  require 'aws-sdk-core/plugins/protocols/query.rb'
33
34
  require 'aws-sdk-rds/plugins/cross_region_copying.rb'
@@ -76,6 +77,7 @@ module Aws::RDS
76
77
  add_plugin(Aws::Plugins::TransferEncoding)
77
78
  add_plugin(Aws::Plugins::HttpChecksum)
78
79
  add_plugin(Aws::Plugins::DefaultsMode)
80
+ add_plugin(Aws::Plugins::RecursionDetection)
79
81
  add_plugin(Aws::Plugins::SignatureV4)
80
82
  add_plugin(Aws::Plugins::Protocols::Query)
81
83
  add_plugin(Aws::RDS::Plugins::CrossRegionCopying)
@@ -455,6 +457,9 @@ module Aws::RDS
455
457
  # * If the source type is a DB cluster snapshot, a
456
458
  # `DBClusterSnapshotIdentifier` value must be supplied.
457
459
  #
460
+ # * If the source type is an RDS Proxy, a `DBProxyName` value must be
461
+ # supplied.
462
+ #
458
463
  # @return [Types::AddSourceIdentifierToSubscriptionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
459
464
  #
460
465
  # * {Types::AddSourceIdentifierToSubscriptionResult#event_subscription #event_subscription} => Types::EventSubscription
@@ -1860,15 +1865,20 @@ module Aws::RDS
1860
1865
  end
1861
1866
 
1862
1867
  # Creates a custom DB engine version (CEV). A CEV is a binary volume
1863
- # snapshot of a database engine and specific AMI. The only supported
1864
- # engine is Oracle Database 19c Enterprise Edition with the January 2021
1865
- # or later RU/RUR.
1868
+ # snapshot of a database engine and specific AMI. The supported engines
1869
+ # are the following:
1870
+ #
1871
+ # * Oracle Database 12.1 Enterprise Edition with the January 2021 or
1872
+ # later RU/RUR
1873
+ #
1874
+ # * Oracle Database 19c Enterprise Edition with the January 2021 or
1875
+ # later RU/RUR
1866
1876
  #
1867
1877
  # Amazon RDS, which is a fully managed service, supplies the Amazon
1868
1878
  # Machine Image (AMI) and database software. The Amazon RDS database
1869
1879
  # software is preinstalled, so you need only select a DB engine and
1870
- # version, and create your database. With Amazon RDS Custom, you upload
1871
- # your database installation files in Amazon S3.
1880
+ # version, and create your database. With Amazon RDS Custom for Oracle,
1881
+ # you upload your database installation files in Amazon S3.
1872
1882
  #
1873
1883
  # When you create a custom engine version, you specify the files in a
1874
1884
  # JSON document called a CEV manifest. This document describes
@@ -1910,8 +1920,8 @@ module Aws::RDS
1910
1920
  # @option params [required, String] :engine_version
1911
1921
  # The name of your CEV. The name format is `19.customized_string `. For
1912
1922
  # example, a valid name is `19.my_cev1`. This setting is required for
1913
- # RDS Custom, but optional for Amazon RDS. The combination of `Engine`
1914
- # and `EngineVersion` is unique per customer per Region.
1923
+ # RDS Custom for Oracle, but optional for Amazon RDS. The combination of
1924
+ # `Engine` and `EngineVersion` is unique per customer per Region.
1915
1925
  #
1916
1926
  # @option params [required, String] :database_installation_files_s3_bucket_name
1917
1927
  # The name of an Amazon S3 bucket that contains database installation
@@ -2200,7 +2210,7 @@ module Aws::RDS
2200
2210
  # Constraints: Must match the name of an existing DBSubnetGroup. Must
2201
2211
  # not be default.
2202
2212
  #
2203
- # Example: `mySubnetgroup`
2213
+ # Example: `mydbsubnetgroup`
2204
2214
  #
2205
2215
  # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2206
2216
  #
@@ -2211,7 +2221,8 @@ module Aws::RDS
2211
2221
  #
2212
2222
  # * `aurora` (for MySQL 5.6-compatible Aurora)
2213
2223
  #
2214
- # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
2224
+ # * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
2225
+ # Aurora)
2215
2226
  #
2216
2227
  # * `aurora-postgresql`
2217
2228
  #
@@ -2231,7 +2242,7 @@ module Aws::RDS
2231
2242
  # "DBEngineVersions[].EngineVersion"`
2232
2243
  #
2233
2244
  # To list all of the available engine versions for MySQL 5.7-compatible
2234
- # Aurora, use the following command:
2245
+ # and MySQL 8.0-compatible Aurora, use the following command:
2235
2246
  #
2236
2247
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
2237
2248
  # "DBEngineVersions[].EngineVersion"`
@@ -2678,11 +2689,11 @@ module Aws::RDS
2678
2689
  #
2679
2690
  # This setting is required to create a Multi-AZ DB cluster.
2680
2691
  #
2681
- # Valid values: `standard | gp2 | io1`
2692
+ # Valid values: `io1`
2682
2693
  #
2683
- # If you specify `io1`, also include a value for the `Iops` parameter.
2694
+ # When specified, a value for the `Iops` parameter is required.
2684
2695
  #
2685
- # Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
2696
+ # Default: `io1`
2686
2697
  #
2687
2698
  # Valid for: Multi-AZ DB clusters only
2688
2699
  #
@@ -3178,7 +3189,7 @@ module Aws::RDS
3178
3189
  #
3179
3190
  # **Aurora MySQL**
3180
3191
  #
3181
- # Example: `aurora5.6`, `aurora-mysql5.7`
3192
+ # Example: `aurora5.6`, `aurora-mysql5.7`, `aurora-mysql8.0`
3182
3193
  #
3183
3194
  # **Aurora PostgreSQL**
3184
3195
  #
@@ -3213,7 +3224,8 @@ module Aws::RDS
3213
3224
  #
3214
3225
  # * `aurora` (for MySQL 5.6-compatible Aurora)
3215
3226
  #
3216
- # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
3227
+ # * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
3228
+ # Aurora)
3217
3229
  #
3218
3230
  # * `aurora-postgresql`
3219
3231
  #
@@ -3461,7 +3473,7 @@ module Aws::RDS
3461
3473
  #
3462
3474
  # ^
3463
3475
  #
3464
- # **Amazon RDS Custom**
3476
+ # **Amazon RDS Custom for Oracle**
3465
3477
  #
3466
3478
  # The Oracle System ID (SID) of the created RDS Custom DB instance. If
3467
3479
  # you don't specify a value, the default value is `ORCL`.
@@ -3476,6 +3488,10 @@ module Aws::RDS
3476
3488
  #
3477
3489
  # * It can't be a word reserved by the database engine.
3478
3490
  #
3491
+ # **Amazon RDS Custom for SQL Server**
3492
+ #
3493
+ # Not applicable. Must be null.
3494
+ #
3479
3495
  # **SQL Server**
3480
3496
  #
3481
3497
  # Not applicable. Must be null.
@@ -3541,9 +3557,11 @@ module Aws::RDS
3541
3557
  # following:
3542
3558
  #
3543
3559
  # * General Purpose (SSD) storage (gp2): Must be an integer from 40 to
3544
- # 65536.
3560
+ # 65536 for RDS Custom for Oracle, 16384 for RDS Custom for SQL
3561
+ # Server.
3545
3562
  #
3546
- # * Provisioned IOPS storage (io1): Must be an integer from 40 to 65536.
3563
+ # * Provisioned IOPS storage (io1): Must be an integer from 40 to 65536
3564
+ # for RDS Custom for Oracle, 16384 for RDS Custom for SQL Server.
3547
3565
  #
3548
3566
  # **MySQL**
3549
3567
  #
@@ -3604,21 +3622,21 @@ module Aws::RDS
3604
3622
  #
3605
3623
  # * General Purpose (SSD) storage (gp2):
3606
3624
  #
3607
- # * Enterprise and Standard editions: Must be an integer from 200 to
3625
+ # * Enterprise and Standard editions: Must be an integer from 20 to
3608
3626
  # 16384.
3609
3627
  #
3610
3628
  # * Web and Express editions: Must be an integer from 20 to 16384.
3611
3629
  #
3612
3630
  # * Provisioned IOPS storage (io1):
3613
3631
  #
3614
- # * Enterprise and Standard editions: Must be an integer from 200 to
3632
+ # * Enterprise and Standard editions: Must be an integer from 100 to
3615
3633
  # 16384.
3616
3634
  #
3617
3635
  # * Web and Express editions: Must be an integer from 100 to 16384.
3618
3636
  #
3619
3637
  # * Magnetic storage (standard):
3620
3638
  #
3621
- # * Enterprise and Standard editions: Must be an integer from 200 to
3639
+ # * Enterprise and Standard editions: Must be an integer from 20 to
3622
3640
  # 1024.
3623
3641
  #
3624
3642
  # * Web and Express editions: Must be an integer from 20 to 1024.
@@ -3644,11 +3662,18 @@ module Aws::RDS
3644
3662
  #
3645
3663
  # * `aurora` (for MySQL 5.6-compatible Aurora)
3646
3664
  #
3647
- # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
3665
+ # * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
3666
+ # Aurora)
3648
3667
  #
3649
3668
  # * `aurora-postgresql`
3650
3669
  #
3651
- # * `custom-oracle-ee (for RDS Custom instances)`
3670
+ # * `custom-oracle-ee (for RDS Custom for Oracle instances)`
3671
+ #
3672
+ # * `custom-sqlserver-ee (for RDS Custom for SQL Server instances)`
3673
+ #
3674
+ # * `custom-sqlserver-se (for RDS Custom for SQL Server instances)`
3675
+ #
3676
+ # * `custom-sqlserver-web (for RDS Custom for SQL Server instances)`
3652
3677
  #
3653
3678
  # * `mariadb`
3654
3679
  #
@@ -3743,6 +3768,10 @@ module Aws::RDS
3743
3768
  # information on Amazon Web Services Regions and Availability Zones, see
3744
3769
  # [Regions and Availability Zones][1].
3745
3770
  #
3771
+ # **Amazon Aurora**
3772
+ #
3773
+ # Not applicable. Availability Zones are managed by the DB cluster.
3774
+ #
3746
3775
  # Default: A random, system-chosen Availability Zone in the endpoint's
3747
3776
  # Amazon Web Services Region.
3748
3777
  #
@@ -3770,7 +3799,10 @@ module Aws::RDS
3770
3799
  # @option params [String] :db_subnet_group_name
3771
3800
  # A DB subnet group to associate with this DB instance.
3772
3801
  #
3773
- # If there is no DB subnet group, then it is a non-VPC DB instance.
3802
+ # Constraints: Must match the name of an existing DBSubnetGroup. Must
3803
+ # not be default.
3804
+ #
3805
+ # Example: `mydbsubnetgroup`
3774
3806
  #
3775
3807
  # @option params [String] :preferred_maintenance_window
3776
3808
  # The time range each week during which system maintenance can occur, in
@@ -3824,7 +3856,7 @@ module Aws::RDS
3824
3856
  #
3825
3857
  # * Can't be set to 0 if the DB instance is a source to read replicas
3826
3858
  #
3827
- # * Can't be set to 0 or 35 for an RDS Custom DB instance
3859
+ # * Can't be set to 0 or 35 for an RDS Custom for Oracle DB instance
3828
3860
  #
3829
3861
  # @option params [String] :preferred_backup_window
3830
3862
  # The daily time range during which automated backups are created if
@@ -3923,47 +3955,53 @@ module Aws::RDS
3923
3955
  # Not applicable. The version number of the database engine to be used
3924
3956
  # by the DB instance is managed by the DB cluster.
3925
3957
  #
3926
- # **Amazon RDS Custom**
3958
+ # **Amazon RDS Custom for Oracle**
3927
3959
  #
3928
3960
  # A custom engine version (CEV) that you have previously created. This
3929
- # setting is required for RDS Custom. The CEV name has the following
3930
- # format: `19.customized_string `. An example identifier is
3931
- # `19.my_cev1`. For more information, see [ Creating an RDS Custom DB
3932
- # instance][1] in the *Amazon RDS User Guide.*.
3961
+ # setting is required for RDS Custom for Oracle. The CEV name has the
3962
+ # following format: `19.customized_string `. An example identifier is
3963
+ # `19.my_cev1`. For more information, see [ Creating an RDS Custom for
3964
+ # Oracle DB instance][1] in the *Amazon RDS User Guide.*.
3965
+ #
3966
+ # **Amazon RDS Custom for SQL Server**
3967
+ #
3968
+ # See [RDS Custom for SQL Server general requirements][2] in the *Amazon
3969
+ # RDS User Guide.*
3933
3970
  #
3934
3971
  # **MariaDB**
3935
3972
  #
3936
- # For information, see [MariaDB on Amazon RDS Versions][2] in the
3973
+ # For information, see [MariaDB on Amazon RDS Versions][3] in the
3937
3974
  # *Amazon RDS User Guide.*
3938
3975
  #
3939
3976
  # **Microsoft SQL Server**
3940
3977
  #
3941
- # For information, see [Microsoft SQL Server Versions on Amazon RDS][3]
3978
+ # For information, see [Microsoft SQL Server Versions on Amazon RDS][4]
3942
3979
  # in the *Amazon RDS User Guide.*
3943
3980
  #
3944
3981
  # **MySQL**
3945
3982
  #
3946
- # For information, see [MySQL on Amazon RDS Versions][4] in the *Amazon
3983
+ # For information, see [MySQL on Amazon RDS Versions][5] in the *Amazon
3947
3984
  # RDS User Guide.*
3948
3985
  #
3949
3986
  # **Oracle**
3950
3987
  #
3951
- # For information, see [Oracle Database Engine Release Notes][5] in the
3988
+ # For information, see [Oracle Database Engine Release Notes][6] in the
3952
3989
  # *Amazon RDS User Guide.*
3953
3990
  #
3954
3991
  # **PostgreSQL**
3955
3992
  #
3956
3993
  # For information, see [Amazon RDS for PostgreSQL versions and
3957
- # extensions][6] in the *Amazon RDS User Guide.*
3994
+ # extensions][7] in the *Amazon RDS User Guide.*
3958
3995
  #
3959
3996
  #
3960
3997
  #
3961
3998
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-creating.html#custom-creating.create
3962
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MariaDB.html#MariaDB.Concepts.VersionMgmt
3963
- # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
3964
- # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
3965
- # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html
3966
- # [6]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
3999
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-reqs-limits.html#custom-reqs-limits.reqsMS
4000
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MariaDB.html#MariaDB.Concepts.VersionMgmt
4001
+ # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
4002
+ # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
4003
+ # [6]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html
4004
+ # [7]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
3967
4005
  #
3968
4006
  # @option params [Boolean] :auto_minor_version_upgrade
3969
4007
  # A value that indicates whether minor engine upgrades are applied
@@ -4093,9 +4131,8 @@ module Aws::RDS
4093
4131
  # A value that indicates whether the DB instance is encrypted. By
4094
4132
  # default, it isn't encrypted.
4095
4133
  #
4096
- # For RDS Custom Oracle instances, either set this parameter to `true`
4097
- # or leave it unset. If you set this parameter to `false`, RDS reports
4098
- # an error.
4134
+ # For RDS Custom instances, either set this parameter to `true` or leave
4135
+ # it unset. If you set this parameter to `false`, RDS reports an error.
4099
4136
  #
4100
4137
  # **Amazon Aurora**
4101
4138
  #
@@ -4124,11 +4161,11 @@ module Aws::RDS
4124
4161
  #
4125
4162
  # **Amazon RDS Custom**
4126
4163
  #
4127
- # A KMS key is required for RDS Custom Oracle instances. For most RDS
4128
- # engines, if you leave this parameter empty while enabling
4129
- # `StorageEncrypted`, the engine uses the default KMS key. However, RDS
4130
- # Custom for Oracle doesn't use the default key when this parameter is
4131
- # empty. You must explicitly specify a key.
4164
+ # A KMS key is required for RDS Custom instances. For most RDS engines,
4165
+ # if you leave this parameter empty while enabling `StorageEncrypted`,
4166
+ # the engine uses the default KMS key. However, RDS Custom doesn't use
4167
+ # the default key when this parameter is empty. You must explicitly
4168
+ # specify a key.
4132
4169
  #
4133
4170
  # @option params [String] :domain
4134
4171
  # The Active Directory directory ID to create the DB instance in.
@@ -4827,7 +4864,7 @@ module Aws::RDS
4827
4864
  # * Not specify a DB subnet group. All these read replicas are created
4828
4865
  # outside of any VPC.
4829
4866
  #
4830
- # Example: `mySubnetgroup`
4867
+ # Example: `mydbsubnetgroup`
4831
4868
  #
4832
4869
  # @option params [Array<String>] :vpc_security_group_ids
4833
4870
  # A list of Amazon EC2 VPC security groups to associate with the read
@@ -5443,7 +5480,8 @@ module Aws::RDS
5443
5480
  #
5444
5481
  # * `aurora` (for MySQL 5.6-compatible Aurora)
5445
5482
  #
5446
- # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
5483
+ # * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
5484
+ # Aurora)
5447
5485
  #
5448
5486
  # * `aurora-postgresql`
5449
5487
  #
@@ -5934,10 +5972,16 @@ module Aws::RDS
5934
5972
  # The name for the DB subnet group. This value is stored as a lowercase
5935
5973
  # string.
5936
5974
  #
5937
- # Constraints: Must contain no more than 255 letters, numbers, periods,
5938
- # underscores, spaces, or hyphens. Must not be default.
5975
+ # Constraints:
5976
+ #
5977
+ # * Must contain no more than 255 letters, numbers, periods,
5978
+ # underscores, spaces, or hyphens.
5979
+ #
5980
+ # * Must not be default.
5939
5981
  #
5940
- # Example: `mySubnetgroup`
5982
+ # * First character must be a letter.
5983
+ #
5984
+ # Example: `mydbsubnetgroup`
5941
5985
  #
5942
5986
  # @option params [required, String] :db_subnet_group_description
5943
5987
  # The description for the DB subnet group.
@@ -6023,13 +6067,13 @@ module Aws::RDS
6023
6067
  # `Availability`, `Backup`.
6024
6068
  #
6025
6069
  # If you specify both the `SourceType` and `SourceIds`, such as
6026
- # `SourceType` = `db-instance` and `SourceIdentifier` = `myDBInstance1`,
6027
- # you are notified of all the `db-instance` events for the specified
6028
- # source. If you specify a `SourceType` but do not specify a
6029
- # `SourceIdentifier`, you receive notice of the events for that source
6030
- # type for all your RDS sources. If you don't specify either the
6031
- # SourceType or the `SourceIdentifier`, you are notified of events
6032
- # generated from all RDS sources belonging to your customer account.
6070
+ # `SourceType` = `db-instance` and `SourceIds` = `myDBInstance1`, you
6071
+ # are notified of all the `db-instance` events for the specified source.
6072
+ # If you specify a `SourceType` but do not specify `SourceIds`, you
6073
+ # receive notice of the events for that source type for all your RDS
6074
+ # sources. If you don't specify either the SourceType or the
6075
+ # `SourceIds`, you are notified of events generated from all RDS sources
6076
+ # belonging to your customer account.
6033
6077
  #
6034
6078
  # <note markdown="1"> RDS event notification is only available for unencrypted SNS topics.
6035
6079
  # If you specify an encrypted SNS topic, event notifications aren't
@@ -6050,21 +6094,25 @@ module Aws::RDS
6050
6094
  # @option params [String] :source_type
6051
6095
  # The type of source that is generating the events. For example, if you
6052
6096
  # want to be notified of events generated by a DB instance, you set this
6053
- # parameter to `db-instance`. If this value isn't specified, all events
6054
- # are returned.
6097
+ # parameter to `db-instance`. For RDS Proxy events, specify `db-proxy`.
6098
+ # If this value isn't specified, all events are returned.
6055
6099
  #
6056
6100
  # Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group` \|
6057
- # `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
6101
+ # `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot` \|
6102
+ # `db-proxy`
6058
6103
  #
6059
6104
  # @option params [Array<String>] :event_categories
6060
6105
  # A list of event categories for a particular source type (`SourceType`)
6061
6106
  # that you want to subscribe to. You can see a list of the categories
6062
- # for a given source type in [Events][1] in the *Amazon RDS User Guide*
6063
- # or by using the `DescribeEventCategories` operation.
6107
+ # for a given source type in the "Amazon RDS event categories and event
6108
+ # messages" section of the [ *Amazon RDS User Guide* ][1] or the [
6109
+ # *Amazon Aurora User Guide* ][2]. You can also see this list by using
6110
+ # the `DescribeEventCategories` operation.
6064
6111
  #
6065
6112
  #
6066
6113
  #
6067
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Events.html
6114
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Events.Messages.html
6115
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Events.Messages.html
6068
6116
  #
6069
6117
  # @option params [Array<String>] :source_ids
6070
6118
  # The list of identifiers of the event sources for which events are
@@ -6095,6 +6143,9 @@ module Aws::RDS
6095
6143
  # * If the source type is a DB cluster snapshot, a
6096
6144
  # `DBClusterSnapshotIdentifier` value must be supplied.
6097
6145
  #
6146
+ # * If the source type is an RDS Proxy, a `DBProxyName` value must be
6147
+ # supplied.
6148
+ #
6098
6149
  # @option params [Boolean] :enabled
6099
6150
  # A value that indicates whether to activate the subscription. If the
6100
6151
  # event notification subscription isn't activated, the subscription is
@@ -7597,12 +7648,10 @@ module Aws::RDS
7597
7648
  #
7598
7649
  # </note>
7599
7650
  #
7600
- # Constraints:
7601
- #
7602
7651
  # Constraints: Must match the name of an existing DBSubnetGroup. Must
7603
7652
  # not be default.
7604
7653
  #
7605
- # Example: `mySubnetgroup`
7654
+ # Example: `mydbsubnetgroup`
7606
7655
  #
7607
7656
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
7608
7657
  #
@@ -8994,7 +9043,8 @@ module Aws::RDS
8994
9043
  #
8995
9044
  # * `aurora` (for MySQL 5.6-compatible Aurora)
8996
9045
  #
8997
- # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
9046
+ # * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
9047
+ # Aurora)
8998
9048
  #
8999
9049
  # * `aurora-postgresql`
9000
9050
  #
@@ -10800,19 +10850,23 @@ module Aws::RDS
10800
10850
  end
10801
10851
 
10802
10852
  # Displays a list of categories for all event source types, or, if
10803
- # specified, for a specified source type. You can see a list of the
10804
- # event categories and source types in [ Events][1] in the *Amazon RDS
10805
- # User Guide.*
10853
+ # specified, for a specified source type. You can also see this list in
10854
+ # the "Amazon RDS event categories and event messages" section of the
10855
+ # [ *Amazon RDS User Guide* ][1] or the [ *Amazon Aurora User Guide*
10856
+ # ][2].
10806
10857
  #
10807
10858
  #
10808
10859
  #
10809
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Events.html
10860
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Events.Messages.html
10861
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Events.Messages.html
10810
10862
  #
10811
10863
  # @option params [String] :source_type
10812
- # The type of source that is generating the events.
10864
+ # The type of source that is generating the events. For RDS Proxy
10865
+ # events, specify `db-proxy`.
10813
10866
  #
10814
10867
  # Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group` \|
10815
- # `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
10868
+ # `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot` \|
10869
+ # `db-proxy`
10816
10870
  #
10817
10871
  # @option params [Array<Types::Filter>] :filters
10818
10872
  # This parameter isn't currently supported.
@@ -10954,13 +11008,13 @@ module Aws::RDS
10954
11008
  end
10955
11009
 
10956
11010
  # Returns events related to DB instances, DB clusters, DB parameter
10957
- # groups, DB security groups, DB snapshots, and DB cluster snapshots for
10958
- # the past 14 days. Events specific to a particular DB instances, DB
10959
- # clusters, DB parameter groups, DB security groups, DB snapshots, and
10960
- # DB cluster snapshots group can be obtained by providing the name as a
10961
- # parameter.
11011
+ # groups, DB security groups, DB snapshots, DB cluster snapshots, and
11012
+ # RDS Proxies for the past 14 days. Events specific to a particular DB
11013
+ # instance, DB cluster, DB parameter group, DB security group, DB
11014
+ # snapshot, DB cluster snapshot group, or RDS Proxy can be obtained by
11015
+ # providing the name as a parameter.
10962
11016
  #
10963
- # <note markdown="1"> By default, the past hour of events are returned.
11017
+ # <note markdown="1"> By default, RDS returns events that were generated in the past hour.
10964
11018
  #
10965
11019
  # </note>
10966
11020
  #
@@ -10991,6 +11045,9 @@ module Aws::RDS
10991
11045
  # * If the source type is a DB cluster snapshot, a
10992
11046
  # `DBClusterSnapshotIdentifier` value must be supplied.
10993
11047
  #
11048
+ # * If the source type is an RDS Proxy, a `DBProxyName` value must be
11049
+ # supplied.
11050
+ #
10994
11051
  # * Can't end with a hyphen or contain two consecutive hyphens.
10995
11052
  #
10996
11053
  # @option params [String] :source_type
@@ -11076,7 +11133,7 @@ module Aws::RDS
11076
11133
  #
11077
11134
  # resp = client.describe_events({
11078
11135
  # source_identifier: "String",
11079
- # source_type: "db-instance", # accepts db-instance, db-parameter-group, db-security-group, db-snapshot, db-cluster, db-cluster-snapshot, custom-engine-version
11136
+ # 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
11080
11137
  # start_time: Time.now,
11081
11138
  # end_time: Time.now,
11082
11139
  # duration: 1,
@@ -11096,7 +11153,7 @@ module Aws::RDS
11096
11153
  # resp.marker #=> String
11097
11154
  # resp.events #=> Array
11098
11155
  # resp.events[0].source_identifier #=> String
11099
- # 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"
11156
+ # 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"
11100
11157
  # resp.events[0].message #=> String
11101
11158
  # resp.events[0].event_categories #=> Array
11102
11159
  # resp.events[0].event_categories[0] #=> String
@@ -11673,7 +11730,8 @@ module Aws::RDS
11673
11730
  #
11674
11731
  # * `aurora` (for MySQL 5.6-compatible Aurora)
11675
11732
  #
11676
- # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
11733
+ # * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
11734
+ # Aurora)
11677
11735
  #
11678
11736
  # * `aurora-postgresql`
11679
11737
  #
@@ -13136,9 +13194,9 @@ module Aws::RDS
13136
13194
  #
13137
13195
  # @option params [required, String] :engine_version
13138
13196
  # The custom engine version (CEV) that you want to modify. This option
13139
- # is required for RDS Custom, but optional for Amazon RDS. The
13140
- # combination of `Engine` and `EngineVersion` is unique per customer per
13141
- # Amazon Web Services Region.
13197
+ # is required for RDS Custom for Oracle, but optional for Amazon RDS.
13198
+ # The combination of `Engine` and `EngineVersion` is unique per customer
13199
+ # per Amazon Web Services Region.
13142
13200
  #
13143
13201
  # @option params [String] :description
13144
13202
  # An optional description of your CEV.
@@ -13469,7 +13527,7 @@ module Aws::RDS
13469
13527
  # "DBEngineVersions[].EngineVersion"`
13470
13528
  #
13471
13529
  # To list all of the available engine versions for MySQL 5.7-compatible
13472
- # Aurora, use the following command:
13530
+ # and MySQL 8.0-compatible Aurora, use the following command:
13473
13531
  #
13474
13532
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
13475
13533
  # "DBEngineVersions[].EngineVersion"`
@@ -13627,12 +13685,11 @@ module Aws::RDS
13627
13685
  # @option params [String] :storage_type
13628
13686
  # Specifies the storage type to be associated with the DB cluster.
13629
13687
  #
13630
- # Valid values: `standard | gp2 | io1`
13688
+ # Valid values: `io1`
13631
13689
  #
13632
- # If you specify `io1`, you must also include a value for the `Iops`
13633
- # parameter.
13690
+ # When specified, a value for the `Iops` parameter is required.
13634
13691
  #
13635
- # Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
13692
+ # Default: `io1`
13636
13693
  #
13637
13694
  # Valid for: Multi-AZ DB clusters only
13638
13695
  #
@@ -14256,7 +14313,7 @@ module Aws::RDS
14256
14313
  # change. The change is applied during the next maintenance window,
14257
14314
  # unless `ApplyImmediately` is enabled for this request.
14258
14315
  #
14259
- # This setting doesn't apply to RDS Custom.
14316
+ # This setting doesn't apply to RDS Custom for Oracle.
14260
14317
  #
14261
14318
  # Default: Uses existing setting
14262
14319
  #
@@ -14280,7 +14337,7 @@ module Aws::RDS
14280
14337
  # Constraints: If supplied, must match the name of an existing
14281
14338
  # DBSubnetGroup.
14282
14339
  #
14283
- # Example: `mySubnetGroup`
14340
+ # Example: `mydbsubnetgroup`
14284
14341
  #
14285
14342
  #
14286
14343
  #
@@ -14327,7 +14384,7 @@ module Aws::RDS
14327
14384
  # during the next maintenance window. Some parameter changes can cause
14328
14385
  # an outage and are applied on the next call to RebootDBInstance, or the
14329
14386
  # next failure reboot. Review the table of parameters in [Modifying a DB
14330
- # Instance][1] in the *Amazon RDS User Guide.* to see the impact of
14387
+ # Instance][1] in the *Amazon RDS User Guide* to see the impact of
14331
14388
  # enabling or disabling `ApplyImmediately` for each modified parameter
14332
14389
  # and to determine when the changes are applied.
14333
14390
  #
@@ -14427,7 +14484,7 @@ module Aws::RDS
14427
14484
  #
14428
14485
  # * It must be a value from 0 to 35. It can't be set to 0 if the DB
14429
14486
  # instance is a source to read replicas. It can't be set to 0 or 35
14430
- # for an RDS Custom DB instance.
14487
+ # for an RDS Custom for Oracle DB instance.
14431
14488
  #
14432
14489
  # * It can be specified for a MySQL read replica only if the source is
14433
14490
  # running MySQL 5.6 or later.
@@ -14514,8 +14571,8 @@ module Aws::RDS
14514
14571
  # lower. For information about valid engine versions, see
14515
14572
  # `CreateDBInstance`, or call `DescribeDBEngineVersions`.
14516
14573
  #
14517
- # In RDS Custom, this parameter is supported for read replicas only if
14518
- # they are in the `PATCH_DB_FAILURE` lifecycle.
14574
+ # In RDS Custom for Oracle, this parameter is supported for read
14575
+ # replicas only if they are in the `PATCH_DB_FAILURE` lifecycle.
14519
14576
  #
14520
14577
  # @option params [Boolean] :allow_major_version_upgrade
14521
14578
  # A value that indicates whether major version upgrades are allowed.
@@ -14777,8 +14834,6 @@ module Aws::RDS
14777
14834
  # Changes to the `PubliclyAccessible` parameter are applied immediately
14778
14835
  # regardless of the value of the `ApplyImmediately` parameter.
14779
14836
  #
14780
- # This setting doesn't apply to RDS Custom.
14781
- #
14782
14837
  # @option params [String] :monitoring_role_arn
14783
14838
  # The ARN for the IAM role that permits RDS to send enhanced monitoring
14784
14839
  # metrics to Amazon CloudWatch Logs. For example,
@@ -15272,26 +15327,36 @@ module Aws::RDS
15272
15327
  # @option params [required, Array<Types::Parameter>] :parameters
15273
15328
  # An array of parameter names, values, and the application methods for
15274
15329
  # the parameter update. At least one parameter name, value, and
15275
- # application method method must be supplied; later arguments are
15276
- # optional. A maximum of 20 parameters can be modified in a single
15277
- # request.
15330
+ # application method must be supplied; later arguments are optional. A
15331
+ # maximum of 20 parameters can be modified in a single request.
15278
15332
  #
15279
15333
  # Valid Values (for the application method): `immediate |
15280
15334
  # pending-reboot`
15281
15335
  #
15282
- # <note markdown="1"> You can use the `immediate` value with dynamic parameters only. You
15336
+ # You can use the `immediate` value with dynamic parameters only. You
15283
15337
  # can use the `pending-reboot` value for both dynamic and static
15284
15338
  # parameters.
15285
15339
  #
15286
- # When the application method is `immediate`, changes to dynamic
15340
+ # When the application method is `immediate`, changes to dynamic
15287
15341
  # parameters are applied immediately to the DB instances associated with
15288
- # the parameter group. When the application method is `pending-reboot`,
15289
- # changes to dynamic and static parameters are applied after a reboot
15290
- # without failover to the DB instances associated with the parameter
15291
- # group.
15342
+ # the parameter group.
15343
+ #
15344
+ # When the application method is `pending-reboot`, changes to dynamic
15345
+ # and static parameters are applied after a reboot without failover to
15346
+ # the DB instances associated with the parameter group.
15347
+ #
15348
+ # <note markdown="1"> You can't use `pending-reboot` with dynamic parameters on RDS for SQL
15349
+ # Server DB instances. Use `immediate`.
15292
15350
  #
15293
15351
  # </note>
15294
15352
  #
15353
+ # For more information on modifying DB parameters, see [Working with DB
15354
+ # parameter groups][1] in the *Amazon RDS User Guide*.
15355
+ #
15356
+ #
15357
+ #
15358
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html
15359
+ #
15295
15360
  # @return [Types::DBParameterGroupNameMessage] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
15296
15361
  #
15297
15362
  # * {Types::DBParameterGroupNameMessage#db_parameter_group_name #db_parameter_group_name} => String
@@ -15798,7 +15863,7 @@ module Aws::RDS
15798
15863
  # Constraints: Must match the name of an existing DBSubnetGroup. Must
15799
15864
  # not be default.
15800
15865
  #
15801
- # Example: `mySubnetgroup`
15866
+ # Example: `mydbsubnetgroup`
15802
15867
  #
15803
15868
  # @option params [String] :db_subnet_group_description
15804
15869
  # The description for the DB subnet group.
@@ -15884,11 +15949,12 @@ module Aws::RDS
15884
15949
  # @option params [String] :source_type
15885
15950
  # The type of source that is generating the events. For example, if you
15886
15951
  # want to be notified of events generated by a DB instance, you would
15887
- # set this parameter to db-instance. If this value isn't specified, all
15888
- # events are returned.
15952
+ # set this parameter to db-instance. For RDS Proxy events, specify
15953
+ # `db-proxy`. If this value isn't specified, all events are returned.
15889
15954
  #
15890
15955
  # Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group` \|
15891
- # `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
15956
+ # `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot` \|
15957
+ # `db-proxy`
15892
15958
  #
15893
15959
  # @option params [Array<String>] :event_categories
15894
15960
  # A list of event categories for a source type (`SourceType`) that you
@@ -16019,7 +16085,8 @@ module Aws::RDS
16019
16085
  # '*[]|[?SupportsGlobalDatabases == `true`].[EngineVersion]' ``
16020
16086
  #
16021
16087
  # To list all of the available engine versions for `aurora-mysql` (for
16022
- # MySQL 5.7-compatible Aurora), use the following command:
16088
+ # MySQL 5.7-compatible and MySQL 8.0-compatible Aurora), use the
16089
+ # following command:
16023
16090
  #
16024
16091
  # `` aws rds describe-db-engine-versions --engine aurora-mysql --query
16025
16092
  # '*[]|[?SupportsGlobalDatabases == `true`].[EngineVersion]' ``
@@ -17636,14 +17703,14 @@ module Aws::RDS
17636
17703
  # Constraints: If supplied, must match the name of an existing
17637
17704
  # DBSubnetGroup.
17638
17705
  #
17639
- # Example: `mySubnetgroup`
17706
+ # Example: `mydbsubnetgroup`
17640
17707
  #
17641
17708
  # @option params [required, String] :engine
17642
17709
  # The name of the database engine to be used for this DB cluster.
17643
17710
  #
17644
17711
  # Valid Values: `aurora` (for MySQL 5.6-compatible Aurora),
17645
- # `aurora-mysql` (for MySQL 5.7-compatible Aurora), and
17646
- # `aurora-postgresql`
17712
+ # `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
17713
+ # Aurora), and `aurora-postgresql`
17647
17714
  #
17648
17715
  # @option params [String] :engine_version
17649
17716
  # The version number of the database engine to use.
@@ -17655,7 +17722,8 @@ module Aws::RDS
17655
17722
  # "DBEngineVersions[].EngineVersion"`
17656
17723
  #
17657
17724
  # To list all of the available engine versions for `aurora-mysql` (for
17658
- # MySQL 5.7-compatible Aurora), use the following command:
17725
+ # MySQL 5.7-compatible and MySQL 8.0-compatible Aurora), use the
17726
+ # following command:
17659
17727
  #
17660
17728
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
17661
17729
  # "DBEngineVersions[].EngineVersion"`
@@ -17669,7 +17737,7 @@ module Aws::RDS
17669
17737
  # **Aurora MySQL**
17670
17738
  #
17671
17739
  # Example: `5.6.10a`, `5.6.mysql_aurora.1.19.2`, `5.7.12`,
17672
- # `5.7.mysql_aurora.2.04.5`
17740
+ # `5.7.mysql_aurora.2.04.5`, `8.0.mysql_aurora.3.01.0`
17673
17741
  #
17674
17742
  # **Aurora PostgreSQL**
17675
17743
  #
@@ -18116,7 +18184,7 @@ module Aws::RDS
18116
18184
  # "DBEngineVersions[].EngineVersion"`
18117
18185
  #
18118
18186
  # To list all of the available engine versions for MySQL 5.7-compatible
18119
- # Aurora, use the following command:
18187
+ # and MySQL 8.0-compatible Aurora, use the following command:
18120
18188
  #
18121
18189
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
18122
18190
  # "DBEngineVersions[].EngineVersion"`
@@ -18182,7 +18250,7 @@ module Aws::RDS
18182
18250
  # Constraints: If supplied, must match the name of an existing DB subnet
18183
18251
  # group.
18184
18252
  #
18185
- # Example: `mySubnetgroup`
18253
+ # Example: `mydbsubnetgroup`
18186
18254
  #
18187
18255
  # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18188
18256
  #
@@ -18365,12 +18433,11 @@ module Aws::RDS
18365
18433
  # Specifies the storage type to be associated with the each DB instance
18366
18434
  # in the Multi-AZ DB cluster.
18367
18435
  #
18368
- # Valid values: `standard | gp2 | io1`
18436
+ # Valid values: `io1`
18369
18437
  #
18370
- # If you specify `io1`, you must also include a value for the `Iops`
18371
- # parameter.
18438
+ # When specified, a value for the `Iops` parameter is required.
18372
18439
  #
18373
- # Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
18440
+ # Default: `io1`
18374
18441
  #
18375
18442
  # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18376
18443
  #
@@ -18729,7 +18796,7 @@ module Aws::RDS
18729
18796
  # Constraints: If supplied, must match the name of an existing
18730
18797
  # DBSubnetGroup.
18731
18798
  #
18732
- # Example: `mySubnetgroup`
18799
+ # Example: `mydbsubnetgroup`
18733
18800
  #
18734
18801
  # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18735
18802
  #
@@ -18912,11 +18979,11 @@ module Aws::RDS
18912
18979
  # Specifies the storage type to be associated with the each DB instance
18913
18980
  # in the Multi-AZ DB cluster.
18914
18981
  #
18915
- # Valid values: `standard | gp2 | io1`
18982
+ # Valid values: `io1`
18916
18983
  #
18917
- # If you specify `io1`, also include a value for the `Iops` parameter.
18984
+ # When specified, a value for the `Iops` parameter is required.
18918
18985
  #
18919
- # Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
18986
+ # Default: `io1`
18920
18987
  #
18921
18988
  # Valid for: Multi-AZ DB clusters only
18922
18989
  #
@@ -19237,7 +19304,7 @@ module Aws::RDS
19237
19304
  # Constraints: If supplied, must match the name of an existing
19238
19305
  # DBSubnetGroup.
19239
19306
  #
19240
- # Example: `mySubnetgroup`
19307
+ # Example: `mydbsubnetgroup`
19241
19308
  #
19242
19309
  # @option params [Boolean] :multi_az
19243
19310
  # A value that indicates whether the DB instance is a Multi-AZ
@@ -19404,8 +19471,21 @@ module Aws::RDS
19404
19471
  #
19405
19472
  # @option params [Boolean] :copy_tags_to_snapshot
19406
19473
  # A value that indicates whether to copy all tags from the restored DB
19407
- # instance to snapshots of the DB instance. By default, tags are not
19408
- # copied.
19474
+ # instance to snapshots of the DB instance.
19475
+ #
19476
+ # In most cases, tags aren't copied by default. However, when you
19477
+ # restore a DB instance from a DB snapshot, RDS checks whether you
19478
+ # specify new tags. If yes, the new tags are added to the restored DB
19479
+ # instance. If there are no new tags, RDS looks for the tags from the
19480
+ # source DB instance for the DB snapshot, and then adds those tags to
19481
+ # the restored DB instance.
19482
+ #
19483
+ # For more information, see [ Copying tags to DB instance snapshots][1]
19484
+ # in the *Amazon RDS User Guide*.
19485
+ #
19486
+ #
19487
+ #
19488
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html#USER_Tagging.CopyTags
19409
19489
  #
19410
19490
  # @option params [String] :domain_iam_role_name
19411
19491
  # Specify the name of the IAM role to be used when making API calls to
@@ -19517,8 +19597,7 @@ module Aws::RDS
19517
19597
  # start with the prefix `AWSRDSCustom`.
19518
19598
  #
19519
19599
  # For the list of permissions required for the IAM role, see [ Configure
19520
- # IAM and your VPC][1] in the *Amazon Relational Database Service User
19521
- # Guide*.
19600
+ # IAM and your VPC][1] in the *Amazon RDS User Guide*.
19522
19601
  #
19523
19602
  # This setting is required for RDS Custom.
19524
19603
  #
@@ -19941,6 +20020,11 @@ module Aws::RDS
19941
20020
  # @option params [String] :db_subnet_group_name
19942
20021
  # A DB subnet group to associate with this DB instance.
19943
20022
  #
20023
+ # Constraints: If supplied, must match the name of an existing
20024
+ # DBSubnetGroup.
20025
+ #
20026
+ # Example: `mydbsubnetgroup`
20027
+ #
19944
20028
  # @option params [String] :preferred_maintenance_window
19945
20029
  # The time range each week during which system maintenance can occur, in
19946
20030
  # Universal Coordinated Time (UTC). For more information, see [Amazon
@@ -20530,7 +20614,7 @@ module Aws::RDS
20530
20614
  # Constraints: If supplied, must match the name of an existing
20531
20615
  # DBSubnetGroup.
20532
20616
  #
20533
- # Example: `mySubnetgroup`
20617
+ # Example: `mydbsubnetgroup`
20534
20618
  #
20535
20619
  # @option params [Boolean] :multi_az
20536
20620
  # A value that indicates whether the DB instance is a Multi-AZ
@@ -22302,7 +22386,7 @@ module Aws::RDS
22302
22386
  params: params,
22303
22387
  config: config)
22304
22388
  context[:gem_name] = 'aws-sdk-rds'
22305
- context[:gem_version] = '1.134.0'
22389
+ context[:gem_version] = '1.138.0'
22306
22390
  Seahorse::Client::Request.new(handlers, context)
22307
22391
  end
22308
22392