aws-sdk-rds 1.130.0 → 1.134.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
27
27
  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
+ require 'aws-sdk-core/plugins/defaults_mode.rb'
30
31
  require 'aws-sdk-core/plugins/signature_v4.rb'
31
32
  require 'aws-sdk-core/plugins/protocols/query.rb'
32
33
  require 'aws-sdk-rds/plugins/cross_region_copying.rb'
@@ -74,6 +75,7 @@ module Aws::RDS
74
75
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
75
76
  add_plugin(Aws::Plugins::TransferEncoding)
76
77
  add_plugin(Aws::Plugins::HttpChecksum)
78
+ add_plugin(Aws::Plugins::DefaultsMode)
77
79
  add_plugin(Aws::Plugins::SignatureV4)
78
80
  add_plugin(Aws::Plugins::Protocols::Query)
79
81
  add_plugin(Aws::RDS::Plugins::CrossRegionCopying)
@@ -121,7 +123,9 @@ module Aws::RDS
121
123
  # * EC2/ECS IMDS instance profile - When used by default, the timeouts
122
124
  # are very aggressive. Construct and pass an instance of
123
125
  # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
124
- # enable retries and extended timeouts.
126
+ # enable retries and extended timeouts. Instance profile credential
127
+ # fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
128
+ # to true.
125
129
  #
126
130
  # @option options [required, String] :region
127
131
  # The AWS region to connect to. The configured `:region` is
@@ -175,6 +179,10 @@ module Aws::RDS
175
179
  # Used only in `standard` and adaptive retry modes. Specifies whether to apply
176
180
  # a clock skew correction and retry requests with skewed client clocks.
177
181
  #
182
+ # @option options [String] :defaults_mode ("legacy")
183
+ # See {Aws::DefaultsModeConfiguration} for a list of the
184
+ # accepted modes and the configuration defaults that are included.
185
+ #
178
186
  # @option options [Boolean] :disable_host_prefix_injection (false)
179
187
  # Set to true to disable SDK automatically adding host prefix
180
188
  # to default service endpoint when available.
@@ -297,7 +305,7 @@ module Aws::RDS
297
305
  # seconds to wait when opening a HTTP session before raising a
298
306
  # `Timeout::Error`.
299
307
  #
300
- # @option options [Integer] :http_read_timeout (60) The default
308
+ # @option options [Float] :http_read_timeout (60) The default
301
309
  # number of seconds to wait for response data. This value can
302
310
  # safely be set per-request on the session.
303
311
  #
@@ -313,6 +321,9 @@ module Aws::RDS
313
321
  # disables this behaviour. This value can safely be set per
314
322
  # request on the session.
315
323
  #
324
+ # @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
325
+ # in seconds.
326
+ #
316
327
  # @option options [Boolean] :http_wire_trace (false) When `true`,
317
328
  # HTTP debug output will be sent to the `:logger`.
318
329
  #
@@ -338,25 +349,15 @@ module Aws::RDS
338
349
 
339
350
  # @!group API Operations
340
351
 
341
- # Associates an Identity and Access Management (IAM) role from an Amazon
342
- # Aurora DB cluster. For more information, see [Authorizing Amazon
343
- # Aurora MySQL to Access Other Amazon Web Services Services on Your
344
- # Behalf][1] in the *Amazon Aurora User Guide*.
345
- #
346
- # <note markdown="1"> This action only applies to Aurora DB clusters.
347
- #
348
- # </note>
349
- #
350
- #
351
- #
352
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Integrating.Authorizing.html
352
+ # Associates an Identity and Access Management (IAM) role with a DB
353
+ # cluster.
353
354
  #
354
355
  # @option params [required, String] :db_cluster_identifier
355
356
  # The name of the DB cluster to associate the IAM role with.
356
357
  #
357
358
  # @option params [required, String] :role_arn
358
359
  # The Amazon Resource Name (ARN) of the IAM role to associate with the
359
- # Aurora DB cluster, for example,
360
+ # Aurora DB cluster, for example
360
361
  # `arn:aws:iam::123456789012:role/AuroraAccessRole`.
361
362
  #
362
363
  # @option params [String] :feature_name
@@ -652,7 +653,7 @@ module Aws::RDS
652
653
  # authorization. First, EC2 or VPC security groups can be added to the
653
654
  # DBSecurityGroup if the application using the database is running on
654
655
  # EC2 or VPC instances. Second, IP ranges are available if the
655
- # application accessing your database is running on the Internet.
656
+ # application accessing your database is running on the internet.
656
657
  # Required parameters for this API are one of CIDR range,
657
658
  # EC2SecurityGroupId for VPC, or (EC2SecurityGroupOwnerId and either
658
659
  # EC2SecurityGroupName or EC2SecurityGroupId for non-VPC).
@@ -911,10 +912,6 @@ module Aws::RDS
911
912
 
912
913
  # Copies the specified DB cluster parameter group.
913
914
  #
914
- # <note markdown="1"> This action only applies to Aurora DB clusters.
915
- #
916
- # </note>
917
- #
918
915
  # @option params [required, String] :source_db_cluster_parameter_group_identifier
919
916
  # The identifier or Amazon Resource Name (ARN) for the source DB cluster
920
917
  # parameter group. For information about creating an ARN, see [
@@ -1084,14 +1081,19 @@ module Aws::RDS
1084
1081
  # DB cluster snapshot identified by `TargetDBClusterSnapshotIdentifier`
1085
1082
  # while that DB cluster snapshot is in "copying" status.
1086
1083
  #
1087
- # For more information on copying encrypted DB cluster snapshots from
1088
- # one Amazon Web Services Region to another, see [ Copying a
1089
- # Snapshot][3] in the *Amazon Aurora User Guide.*
1084
+ # For more information on copying encrypted Amazon Aurora DB cluster
1085
+ # snapshots from one Amazon Web Services Region to another, see [
1086
+ # Copying a Snapshot][3] in the *Amazon Aurora User Guide.*
1090
1087
  #
1091
- # For more information on Amazon Aurora, see [ What Is Amazon
1092
- # Aurora?][4] in the *Amazon Aurora User Guide.*
1088
+ # For more information on Amazon Aurora DB clusters, see [ What is
1089
+ # Amazon Aurora?][4] in the *Amazon Aurora User Guide.*
1093
1090
  #
1094
- # <note markdown="1"> This action only applies to Aurora DB clusters.
1091
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
1092
+ # deployments with two readable standby DB instances][5] in the *Amazon
1093
+ # RDS User Guide.*
1094
+ #
1095
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
1096
+ # change.
1095
1097
  #
1096
1098
  # </note>
1097
1099
  #
@@ -1101,6 +1103,7 @@ module Aws::RDS
1101
1103
  # [2]: https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html
1102
1104
  # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_CopySnapshot.html
1103
1105
  # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
1106
+ # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
1104
1107
  #
1105
1108
  # @option params [required, String] :source_db_cluster_snapshot_identifier
1106
1109
  # The identifier of the DB cluster snapshot to copy. This parameter
@@ -1666,6 +1669,7 @@ module Aws::RDS
1666
1669
  # resp.db_snapshot.tag_list[0].key #=> String
1667
1670
  # resp.db_snapshot.tag_list[0].value #=> String
1668
1671
  # resp.db_snapshot.original_snapshot_create_time #=> Time
1672
+ # resp.db_snapshot.snapshot_target #=> String
1669
1673
  #
1670
1674
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyDBSnapshot AWS API Documentation
1671
1675
  #
@@ -1858,15 +1862,13 @@ module Aws::RDS
1858
1862
  # Creates a custom DB engine version (CEV). A CEV is a binary volume
1859
1863
  # snapshot of a database engine and specific AMI. The only supported
1860
1864
  # engine is Oracle Database 19c Enterprise Edition with the January 2021
1861
- # or later RU/RUR. For more information, see [ Amazon RDS Custom
1862
- # requirements and limitations][1] in the *Amazon RDS User Guide*.
1865
+ # or later RU/RUR.
1863
1866
  #
1864
1867
  # Amazon RDS, which is a fully managed service, supplies the Amazon
1865
1868
  # Machine Image (AMI) and database software. The Amazon RDS database
1866
1869
  # software is preinstalled, so you need only select a DB engine and
1867
1870
  # version, and create your database. With Amazon RDS Custom, you upload
1868
- # your database installation files in Amazon S3. For more information,
1869
- # see [ Preparing to create a CEV][2] in the *Amazon RDS User Guide*.
1871
+ # your database installation files in Amazon S3.
1870
1872
  #
1871
1873
  # When you create a custom engine version, you specify the files in a
1872
1874
  # JSON document called a CEV manifest. This document describes
@@ -1894,14 +1896,12 @@ module Aws::RDS
1894
1896
  #
1895
1897
  # </note>
1896
1898
  #
1897
- # For more information, see [ Creating a CEV][3] in the *Amazon RDS User
1899
+ # For more information, see [ Creating a CEV][1] in the *Amazon RDS User
1898
1900
  # Guide*.
1899
1901
  #
1900
1902
  #
1901
1903
  #
1902
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.preparing.manifest
1903
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.html#custom-cev.preparing
1904
- # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.create
1904
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.create
1905
1905
  #
1906
1906
  # @option params [required, String] :engine
1907
1907
  # The database engine to use for your custom engine version (CEV). The
@@ -2091,30 +2091,41 @@ module Aws::RDS
2091
2091
  req.send_request(options)
2092
2092
  end
2093
2093
 
2094
- # Creates a new Amazon Aurora DB cluster.
2094
+ # Creates a new Amazon Aurora DB cluster or Multi-AZ DB cluster.
2095
2095
  #
2096
- # You can use the `ReplicationSourceIdentifier` parameter to create the
2097
- # DB cluster as a read replica of another DB cluster or Amazon RDS MySQL
2098
- # or PostgreSQL DB instance. For cross-region replication where the DB
2099
- # cluster identified by `ReplicationSourceIdentifier` is encrypted, you
2100
- # must also specify the `PreSignedUrl` parameter.
2096
+ # You can use the `ReplicationSourceIdentifier` parameter to create an
2097
+ # Amazon Aurora DB cluster as a read replica of another DB cluster or
2098
+ # Amazon RDS MySQL or PostgreSQL DB instance. For cross-Region
2099
+ # replication where the DB cluster identified by
2100
+ # `ReplicationSourceIdentifier` is encrypted, also specify the
2101
+ # `PreSignedUrl` parameter.
2101
2102
  #
2102
- # For more information on Amazon Aurora, see [ What Is Amazon
2103
+ # For more information on Amazon Aurora, see [ What is Amazon
2103
2104
  # Aurora?][1] in the *Amazon Aurora User Guide.*
2104
2105
  #
2105
- # <note markdown="1"> This action only applies to Aurora DB clusters.
2106
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
2107
+ # deployments with two readable standby DB instances][2] in the *Amazon
2108
+ # RDS User Guide.*
2109
+ #
2110
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
2111
+ # change.
2106
2112
  #
2107
2113
  # </note>
2108
2114
  #
2109
2115
  #
2110
2116
  #
2111
2117
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
2118
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
2112
2119
  #
2113
2120
  # @option params [Array<String>] :availability_zones
2114
- # A list of Availability Zones (AZs) where instances in the DB cluster
2115
- # can be created. For information on Amazon Web Services Regions and
2116
- # Availability Zones, see [Choosing the Regions and Availability
2117
- # Zones][1] in the *Amazon Aurora User Guide*.
2121
+ # A list of Availability Zones (AZs) where DB instances in the DB
2122
+ # cluster can be created.
2123
+ #
2124
+ # For information on Amazon Web Services Regions and Availability Zones,
2125
+ # see [Choosing the Regions and Availability Zones][1] in the *Amazon
2126
+ # Aurora User Guide*.
2127
+ #
2128
+ # Valid for: Aurora DB clusters only
2118
2129
  #
2119
2130
  #
2120
2131
  #
@@ -2131,15 +2142,21 @@ module Aws::RDS
2131
2142
  #
2132
2143
  # ^
2133
2144
  #
2145
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2146
+ #
2134
2147
  # @option params [String] :character_set_name
2135
2148
  # A value that indicates that the DB cluster should be associated with
2136
2149
  # the specified CharacterSet.
2137
2150
  #
2151
+ # Valid for: Aurora DB clusters only
2152
+ #
2138
2153
  # @option params [String] :database_name
2139
2154
  # The name for your database of up to 64 alphanumeric characters. If you
2140
2155
  # do not provide a name, Amazon RDS doesn't create a database in the DB
2141
2156
  # cluster you are creating.
2142
2157
  #
2158
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2159
+ #
2143
2160
  # @option params [required, String] :db_cluster_identifier
2144
2161
  # The DB cluster identifier. This parameter is stored as a lowercase
2145
2162
  # string.
@@ -2154,6 +2171,8 @@ module Aws::RDS
2154
2171
  #
2155
2172
  # Example: `my-cluster1`
2156
2173
  #
2174
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2175
+ #
2157
2176
  # @option params [String] :db_cluster_parameter_group_name
2158
2177
  # The name of the DB cluster parameter group to associate with this DB
2159
2178
  # cluster. If you do not specify a value, then the default DB cluster
@@ -2166,60 +2185,121 @@ module Aws::RDS
2166
2185
  #
2167
2186
  # ^
2168
2187
  #
2188
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2189
+ #
2169
2190
  # @option params [Array<String>] :vpc_security_group_ids
2170
2191
  # A list of EC2 VPC security groups to associate with this DB cluster.
2171
2192
  #
2193
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2194
+ #
2172
2195
  # @option params [String] :db_subnet_group_name
2173
2196
  # A DB subnet group to associate with this DB cluster.
2174
2197
  #
2198
+ # This setting is required to create a Multi-AZ DB cluster.
2199
+ #
2175
2200
  # Constraints: Must match the name of an existing DBSubnetGroup. Must
2176
2201
  # not be default.
2177
2202
  #
2178
2203
  # Example: `mySubnetgroup`
2179
2204
  #
2205
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2206
+ #
2180
2207
  # @option params [required, String] :engine
2181
2208
  # The name of the database engine to be used for this DB cluster.
2182
2209
  #
2183
- # Valid Values: `aurora` (for MySQL 5.6-compatible Aurora),
2184
- # `aurora-mysql` (for MySQL 5.7-compatible Aurora), and
2185
- # `aurora-postgresql`
2210
+ # Valid Values:
2211
+ #
2212
+ # * `aurora` (for MySQL 5.6-compatible Aurora)
2213
+ #
2214
+ # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
2215
+ #
2216
+ # * `aurora-postgresql`
2217
+ #
2218
+ # * `mysql`
2219
+ #
2220
+ # * `postgres`
2221
+ #
2222
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2186
2223
  #
2187
2224
  # @option params [String] :engine_version
2188
2225
  # The version number of the database engine to use.
2189
2226
  #
2190
- # To list all of the available engine versions for `aurora` (for MySQL
2191
- # 5.6-compatible Aurora), use the following command:
2227
+ # To list all of the available engine versions for MySQL 5.6-compatible
2228
+ # Aurora, use the following command:
2192
2229
  #
2193
2230
  # `aws rds describe-db-engine-versions --engine aurora --query
2194
2231
  # "DBEngineVersions[].EngineVersion"`
2195
2232
  #
2196
- # To list all of the available engine versions for `aurora-mysql` (for
2197
- # MySQL 5.7-compatible Aurora), use the following command:
2233
+ # To list all of the available engine versions for MySQL 5.7-compatible
2234
+ # Aurora, use the following command:
2198
2235
  #
2199
2236
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
2200
2237
  # "DBEngineVersions[].EngineVersion"`
2201
2238
  #
2202
- # To list all of the available engine versions for `aurora-postgresql`,
2239
+ # To list all of the available engine versions for Aurora PostgreSQL,
2203
2240
  # use the following command:
2204
2241
  #
2205
2242
  # `aws rds describe-db-engine-versions --engine aurora-postgresql
2206
2243
  # --query "DBEngineVersions[].EngineVersion"`
2207
2244
  #
2245
+ # To list all of the available engine versions for RDS for MySQL, use
2246
+ # the following command:
2247
+ #
2248
+ # `aws rds describe-db-engine-versions --engine mysql --query
2249
+ # "DBEngineVersions[].EngineVersion"`
2250
+ #
2251
+ # To list all of the available engine versions for RDS for PostgreSQL,
2252
+ # use the following command:
2253
+ #
2254
+ # `aws rds describe-db-engine-versions --engine postgres --query
2255
+ # "DBEngineVersions[].EngineVersion"`
2256
+ #
2208
2257
  # **Aurora MySQL**
2209
2258
  #
2210
- # Example: `5.6.10a`, `5.6.mysql_aurora.1.19.2`, `5.7.12`,
2211
- # `5.7.mysql_aurora.2.04.5`
2259
+ # For information, see [MySQL on Amazon RDS Versions][1] in the *Amazon
2260
+ # Aurora User Guide.*
2212
2261
  #
2213
2262
  # **Aurora PostgreSQL**
2214
2263
  #
2215
- # Example: `9.6.3`, `10.7`
2264
+ # For information, see [Amazon Aurora PostgreSQL releases and engine
2265
+ # versions][2] in the *Amazon Aurora User Guide.*
2266
+ #
2267
+ # **MySQL**
2268
+ #
2269
+ # For information, see [MySQL on Amazon RDS Versions][3] in the *Amazon
2270
+ # RDS User Guide.*
2271
+ #
2272
+ # **PostgreSQL**
2273
+ #
2274
+ # For information, see [Amazon RDS for PostgreSQL versions and
2275
+ # extensions][4] in the *Amazon RDS User Guide.*
2276
+ #
2277
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2278
+ #
2279
+ #
2280
+ #
2281
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Updates.html
2282
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Updates.20180305.html
2283
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
2284
+ # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
2216
2285
  #
2217
2286
  # @option params [Integer] :port
2218
2287
  # The port number on which the instances in the DB cluster accept
2219
2288
  # connections.
2220
2289
  #
2221
- # Default: `3306` if engine is set as aurora or `5432` if set to
2222
- # aurora-postgresql.
2290
+ # **RDS for MySQL and Aurora MySQL**
2291
+ #
2292
+ # Default: `3306`
2293
+ #
2294
+ # Valid values: `1150-65535`
2295
+ #
2296
+ # **RDS for PostgreSQL and Aurora PostgreSQL**
2297
+ #
2298
+ # Default: `5432`
2299
+ #
2300
+ # Valid values: `1150-65535`
2301
+ #
2302
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2223
2303
  #
2224
2304
  # @option params [String] :master_username
2225
2305
  # The name of the master user for the DB cluster.
@@ -2232,19 +2312,22 @@ module Aws::RDS
2232
2312
  #
2233
2313
  # * Can't be a reserved word for the chosen database engine.
2234
2314
  #
2315
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2316
+ #
2235
2317
  # @option params [String] :master_user_password
2236
2318
  # The password for the master database user. This password can contain
2237
2319
  # any printable ASCII character except "/", """, or "@".
2238
2320
  #
2239
2321
  # Constraints: Must contain from 8 to 41 characters.
2240
2322
  #
2323
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2324
+ #
2241
2325
  # @option params [String] :option_group_name
2242
2326
  # A value that indicates that the DB cluster should be associated with
2243
2327
  # the specified option group.
2244
2328
  #
2245
- # Permanent options can't be removed from an option group. The option
2246
- # group can't be removed from a DB cluster once it is associated with a
2247
- # DB cluster.
2329
+ # DB clusters are associated with a default option group that can't be
2330
+ # modified.
2248
2331
  #
2249
2332
  # @option params [String] :preferred_backup_window
2250
2333
  # The daily time range during which automated backups are created if
@@ -2266,6 +2349,8 @@ module Aws::RDS
2266
2349
  #
2267
2350
  # * Must be at least 30 minutes.
2268
2351
  #
2352
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2353
+ #
2269
2354
  #
2270
2355
  #
2271
2356
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Managing.Backups.html#Aurora.Managing.Backups.BackupWindow
@@ -2286,6 +2371,8 @@ module Aws::RDS
2286
2371
  #
2287
2372
  # Constraints: Minimum 30-minute window.
2288
2373
  #
2374
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2375
+ #
2289
2376
  #
2290
2377
  #
2291
2378
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#AdjustingTheMaintenanceWindow.Aurora
@@ -2294,12 +2381,18 @@ module Aws::RDS
2294
2381
  # The Amazon Resource Name (ARN) of the source DB instance or DB cluster
2295
2382
  # if this DB cluster is created as a read replica.
2296
2383
  #
2384
+ # Valid for: Aurora DB clusters only
2385
+ #
2297
2386
  # @option params [Array<Types::Tag>] :tags
2298
2387
  # Tags to assign to the DB cluster.
2299
2388
  #
2389
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2390
+ #
2300
2391
  # @option params [Boolean] :storage_encrypted
2301
2392
  # A value that indicates whether the DB cluster is encrypted.
2302
2393
  #
2394
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2395
+ #
2303
2396
  # @option params [String] :kms_key_id
2304
2397
  # The Amazon Web Services KMS key identifier for an encrypted DB
2305
2398
  # cluster.
@@ -2329,12 +2422,14 @@ module Aws::RDS
2329
2422
  # Region. This KMS key is used to encrypt the read replica in that
2330
2423
  # Amazon Web Services Region.
2331
2424
  #
2425
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2426
+ #
2332
2427
  # @option params [String] :pre_signed_url
2333
2428
  # A URL that contains a Signature Version 4 signed request for the
2334
2429
  # `CreateDBCluster` action to be called in the source Amazon Web
2335
- # Services Region where the DB cluster is replicated from. You only need
2336
- # to specify `PreSignedUrl` when you are performing cross-region
2337
- # replication from an encrypted DB cluster.
2430
+ # Services Region where the DB cluster is replicated from. Specify
2431
+ # `PreSignedUrl` only when you are performing cross-Region replication
2432
+ # from an encrypted DB cluster.
2338
2433
  #
2339
2434
  # The pre-signed URL must be a valid request for the `CreateDBCluster`
2340
2435
  # API action that can be executed in the source Amazon Web Services
@@ -2375,6 +2470,8 @@ module Aws::RDS
2375
2470
  #
2376
2471
  # </note>
2377
2472
  #
2473
+ # Valid for: Aurora DB clusters only
2474
+ #
2378
2475
  #
2379
2476
  #
2380
2477
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html
@@ -2383,11 +2480,13 @@ module Aws::RDS
2383
2480
  # @option params [Boolean] :enable_iam_database_authentication
2384
2481
  # A value that indicates whether to enable mapping of Amazon Web
2385
2482
  # Services Identity and Access Management (IAM) accounts to database
2386
- # accounts. By default, mapping is disabled.
2483
+ # accounts. By default, mapping isn't enabled.
2387
2484
  #
2388
2485
  # For more information, see [ IAM Database Authentication][1] in the
2389
2486
  # *Amazon Aurora User Guide.*
2390
2487
  #
2488
+ # Valid for: Aurora DB clusters only
2489
+ #
2391
2490
  #
2392
2491
  #
2393
2492
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.html
@@ -2396,10 +2495,6 @@ module Aws::RDS
2396
2495
  # The target backtrack window, in seconds. To disable backtracking, set
2397
2496
  # this value to 0.
2398
2497
  #
2399
- # <note markdown="1"> Currently, Backtrack is only supported for Aurora MySQL DB clusters.
2400
- #
2401
- # </note>
2402
- #
2403
2498
  # Default: 0
2404
2499
  #
2405
2500
  # Constraints:
@@ -2409,6 +2504,8 @@ module Aws::RDS
2409
2504
  #
2410
2505
  # ^
2411
2506
  #
2507
+ # Valid for: Aurora MySQL DB clusters only
2508
+ #
2412
2509
  # @option params [Array<String>] :enable_cloudwatch_logs_exports
2413
2510
  # The list of log types that need to be enabled for exporting to
2414
2511
  # CloudWatch Logs. The values in the list depend on the DB engine being
@@ -2423,6 +2520,8 @@ module Aws::RDS
2423
2520
  #
2424
2521
  # Possible value is `postgresql`.
2425
2522
  #
2523
+ # Valid for: Aurora DB clusters only
2524
+ #
2426
2525
  #
2427
2526
  #
2428
2527
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
@@ -2458,6 +2557,8 @@ module Aws::RDS
2458
2557
  #
2459
2558
  # * [ Limitations of Multi-Master Clusters][4]
2460
2559
  #
2560
+ # Valid for: Aurora DB clusters only
2561
+ #
2461
2562
  #
2462
2563
  #
2463
2564
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html#aurora-serverless.limitations
@@ -2469,15 +2570,21 @@ module Aws::RDS
2469
2570
  # For DB clusters in `serverless` DB engine mode, the scaling properties
2470
2571
  # of the DB cluster.
2471
2572
  #
2573
+ # Valid for: Aurora DB clusters only
2574
+ #
2472
2575
  # @option params [Boolean] :deletion_protection
2473
2576
  # A value that indicates whether the DB cluster has deletion protection
2474
2577
  # enabled. The database can't be deleted when deletion protection is
2475
- # enabled. By default, deletion protection is disabled.
2578
+ # enabled. By default, deletion protection isn't enabled.
2579
+ #
2580
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2476
2581
  #
2477
2582
  # @option params [String] :global_cluster_identifier
2478
2583
  # The global cluster ID of an Aurora cluster that becomes the primary
2479
2584
  # cluster in the new global database cluster.
2480
2585
  #
2586
+ # Valid for: Aurora DB clusters only
2587
+ #
2481
2588
  # @option params [Boolean] :enable_http_endpoint
2482
2589
  # A value that indicates whether to enable the HTTP endpoint for an
2483
2590
  # Aurora Serverless DB cluster. By default, the HTTP endpoint is
@@ -2491,6 +2598,8 @@ module Aws::RDS
2491
2598
  # For more information, see [Using the Data API for Aurora
2492
2599
  # Serverless][1] in the *Amazon Aurora User Guide*.
2493
2600
  #
2601
+ # Valid for: Aurora DB clusters only
2602
+ #
2494
2603
  #
2495
2604
  #
2496
2605
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html
@@ -2499,14 +2608,19 @@ module Aws::RDS
2499
2608
  # A value that indicates whether to copy all tags from the DB cluster to
2500
2609
  # snapshots of the DB cluster. The default is not to copy them.
2501
2610
  #
2611
+ # Valid for: Aurora DB clusters only
2612
+ #
2502
2613
  # @option params [String] :domain
2503
2614
  # The Active Directory directory ID to create the DB cluster in.
2504
2615
  #
2505
2616
  # For Amazon Aurora DB clusters, Amazon RDS can use Kerberos
2506
- # Authentication to authenticate users that connect to the DB cluster.
2507
- # For more information, see [Kerberos Authentication][1] in the *Amazon
2617
+ # authentication to authenticate users that connect to the DB cluster.
2618
+ #
2619
+ # For more information, see [Kerberos authentication][1] in the *Amazon
2508
2620
  # Aurora User Guide*.
2509
2621
  #
2622
+ # Valid for: Aurora DB clusters only
2623
+ #
2510
2624
  #
2511
2625
  #
2512
2626
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/kerberos-authentication.html
@@ -2515,6 +2629,8 @@ module Aws::RDS
2515
2629
  # Specify the name of the IAM role to be used when making API calls to
2516
2630
  # the Directory Service.
2517
2631
  #
2632
+ # Valid for: Aurora DB clusters only
2633
+ #
2518
2634
  # @option params [Boolean] :enable_global_write_forwarding
2519
2635
  # A value that indicates whether to enable this DB cluster to forward
2520
2636
  # write operations to the primary cluster of an Aurora global database
@@ -2530,6 +2646,171 @@ module Aws::RDS
2530
2646
  # immediately if the primary is demoted by the FailoverGlobalCluster API
2531
2647
  # operation, but it does nothing until then.
2532
2648
  #
2649
+ # Valid for: Aurora DB clusters only
2650
+ #
2651
+ # @option params [String] :db_cluster_instance_class
2652
+ # The compute and memory capacity of each DB instance in the Multi-AZ DB
2653
+ # cluster, for example db.m6g.xlarge. Not all DB instance classes are
2654
+ # available in all Amazon Web Services Regions, or for all database
2655
+ # engines.
2656
+ #
2657
+ # For the full list of DB instance classes and availability for your
2658
+ # engine, see [DB instance class][1] in the *Amazon RDS User Guide.*
2659
+ #
2660
+ # This setting is required to create a Multi-AZ DB cluster.
2661
+ #
2662
+ # Valid for: Multi-AZ DB clusters only
2663
+ #
2664
+ #
2665
+ #
2666
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html
2667
+ #
2668
+ # @option params [Integer] :allocated_storage
2669
+ # The amount of storage in gibibytes (GiB) to allocate to each DB
2670
+ # instance in the Multi-AZ DB cluster.
2671
+ #
2672
+ # This setting is required to create a Multi-AZ DB cluster.
2673
+ #
2674
+ # Valid for: Multi-AZ DB clusters only
2675
+ #
2676
+ # @option params [String] :storage_type
2677
+ # Specifies the storage type to be associated with the DB cluster.
2678
+ #
2679
+ # This setting is required to create a Multi-AZ DB cluster.
2680
+ #
2681
+ # Valid values: `standard | gp2 | io1`
2682
+ #
2683
+ # If you specify `io1`, also include a value for the `Iops` parameter.
2684
+ #
2685
+ # Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
2686
+ #
2687
+ # Valid for: Multi-AZ DB clusters only
2688
+ #
2689
+ # @option params [Integer] :iops
2690
+ # The amount of Provisioned IOPS (input/output operations per second) to
2691
+ # be initially allocated for each DB instance in the Multi-AZ DB
2692
+ # cluster.
2693
+ #
2694
+ # For information about valid `Iops` values, see [Amazon RDS Provisioned
2695
+ # IOPS storage to improve performance][1] in the *Amazon RDS User
2696
+ # Guide*.
2697
+ #
2698
+ # This setting is required to create a Multi-AZ DB cluster.
2699
+ #
2700
+ # Constraints: Must be a multiple between .5 and 50 of the storage
2701
+ # amount for the DB cluster.
2702
+ #
2703
+ # Valid for: Multi-AZ DB clusters only
2704
+ #
2705
+ #
2706
+ #
2707
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html#USER_PIOPS
2708
+ #
2709
+ # @option params [Boolean] :publicly_accessible
2710
+ # A value that indicates whether the DB cluster is publicly accessible.
2711
+ #
2712
+ # When the DB cluster is publicly accessible, its Domain Name System
2713
+ # (DNS) endpoint resolves to the private IP address from within the DB
2714
+ # cluster's virtual private cloud (VPC). It resolves to the public IP
2715
+ # address from outside of the DB cluster's VPC. Access to the DB
2716
+ # cluster is ultimately controlled by the security group it uses. That
2717
+ # public access isn't permitted if the security group assigned to the
2718
+ # DB cluster doesn't permit it.
2719
+ #
2720
+ # When the DB cluster isn't publicly accessible, it is an internal DB
2721
+ # cluster with a DNS name that resolves to a private IP address.
2722
+ #
2723
+ # Default: The default behavior varies depending on whether
2724
+ # `DBSubnetGroupName` is specified.
2725
+ #
2726
+ # If `DBSubnetGroupName` isn't specified, and `PubliclyAccessible`
2727
+ # isn't specified, the following applies:
2728
+ #
2729
+ # * If the default VPC in the target Region doesn’t have an internet
2730
+ # gateway attached to it, the DB cluster is private.
2731
+ #
2732
+ # * If the default VPC in the target Region has an internet gateway
2733
+ # attached to it, the DB cluster is public.
2734
+ #
2735
+ # If `DBSubnetGroupName` is specified, and `PubliclyAccessible` isn't
2736
+ # specified, the following applies:
2737
+ #
2738
+ # * If the subnets are part of a VPC that doesn’t have an internet
2739
+ # gateway attached to it, the DB cluster is private.
2740
+ #
2741
+ # * If the subnets are part of a VPC that has an internet gateway
2742
+ # attached to it, the DB cluster is public.
2743
+ #
2744
+ # Valid for: Multi-AZ DB clusters only
2745
+ #
2746
+ # @option params [Boolean] :auto_minor_version_upgrade
2747
+ # A value that indicates whether minor engine upgrades are applied
2748
+ # automatically to the DB cluster during the maintenance window. By
2749
+ # default, minor engine upgrades are applied automatically.
2750
+ #
2751
+ # Valid for: Multi-AZ DB clusters only
2752
+ #
2753
+ # @option params [Integer] :monitoring_interval
2754
+ # The interval, in seconds, between points when Enhanced Monitoring
2755
+ # metrics are collected for the DB cluster. To turn off collecting
2756
+ # Enhanced Monitoring metrics, specify 0. The default is 0.
2757
+ #
2758
+ # If `MonitoringRoleArn` is specified, also set `MonitoringInterval` to
2759
+ # a value other than 0.
2760
+ #
2761
+ # Valid Values: `0, 1, 5, 10, 15, 30, 60`
2762
+ #
2763
+ # Valid for: Multi-AZ DB clusters only
2764
+ #
2765
+ # @option params [String] :monitoring_role_arn
2766
+ # The Amazon Resource Name (ARN) for the IAM role that permits RDS to
2767
+ # send Enhanced Monitoring metrics to Amazon CloudWatch Logs. An example
2768
+ # is `arn:aws:iam:123456789012:role/emaccess`. For information on
2769
+ # creating a monitoring role, see [Setting up and enabling Enhanced
2770
+ # Monitoring][1] in the *Amazon RDS User Guide*.
2771
+ #
2772
+ # If `MonitoringInterval` is set to a value other than 0, supply a
2773
+ # `MonitoringRoleArn` value.
2774
+ #
2775
+ # Valid for: Multi-AZ DB clusters only
2776
+ #
2777
+ #
2778
+ #
2779
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling
2780
+ #
2781
+ # @option params [Boolean] :enable_performance_insights
2782
+ # A value that indicates whether to turn on Performance Insights for the
2783
+ # DB cluster.
2784
+ #
2785
+ # For more information, see [ Using Amazon Performance Insights][1] in
2786
+ # the *Amazon RDS User Guide*.
2787
+ #
2788
+ # Valid for: Multi-AZ DB clusters only
2789
+ #
2790
+ #
2791
+ #
2792
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
2793
+ #
2794
+ # @option params [String] :performance_insights_kms_key_id
2795
+ # The Amazon Web Services KMS key identifier for encryption of
2796
+ # Performance Insights data.
2797
+ #
2798
+ # The Amazon Web Services KMS key identifier is the key ARN, key ID,
2799
+ # alias ARN, or alias name for the KMS key.
2800
+ #
2801
+ # If you don't specify a value for `PerformanceInsightsKMSKeyId`, then
2802
+ # Amazon RDS uses your default KMS key. There is a default KMS key for
2803
+ # your Amazon Web Services account. Your Amazon Web Services account has
2804
+ # a different default KMS key for each Amazon Web Services Region.
2805
+ #
2806
+ # Valid for: Multi-AZ DB clusters only
2807
+ #
2808
+ # @option params [Integer] :performance_insights_retention_period
2809
+ # The amount of time, in days, to retain Performance Insights data.
2810
+ # Valid values are 7 or 731 (2 years).
2811
+ #
2812
+ # Valid for: Multi-AZ DB clusters only
2813
+ #
2533
2814
  # @option params [String] :source_region
2534
2815
  # The source region of the snapshot. This is only needed when the
2535
2816
  # shapshot is encrypted and in a different region.
@@ -2613,6 +2894,17 @@ module Aws::RDS
2613
2894
  # domain: "String",
2614
2895
  # domain_iam_role_name: "String",
2615
2896
  # enable_global_write_forwarding: false,
2897
+ # db_cluster_instance_class: "String",
2898
+ # allocated_storage: 1,
2899
+ # storage_type: "String",
2900
+ # iops: 1,
2901
+ # publicly_accessible: false,
2902
+ # auto_minor_version_upgrade: false,
2903
+ # monitoring_interval: 1,
2904
+ # monitoring_role_arn: "String",
2905
+ # enable_performance_insights: false,
2906
+ # performance_insights_kms_key_id: "String",
2907
+ # performance_insights_retention_period: 1,
2616
2908
  # source_region: "String",
2617
2909
  # })
2618
2910
  #
@@ -2708,6 +3000,16 @@ module Aws::RDS
2708
3000
  # resp.db_cluster.pending_modified_values.master_user_password #=> String
2709
3001
  # resp.db_cluster.pending_modified_values.iam_database_authentication_enabled #=> Boolean
2710
3002
  # resp.db_cluster.pending_modified_values.engine_version #=> String
3003
+ # resp.db_cluster.db_cluster_instance_class #=> String
3004
+ # resp.db_cluster.storage_type #=> String
3005
+ # resp.db_cluster.iops #=> Integer
3006
+ # resp.db_cluster.publicly_accessible #=> Boolean
3007
+ # resp.db_cluster.auto_minor_version_upgrade #=> Boolean
3008
+ # resp.db_cluster.monitoring_interval #=> Integer
3009
+ # resp.db_cluster.monitoring_role_arn #=> String
3010
+ # resp.db_cluster.performance_insights_enabled #=> Boolean
3011
+ # resp.db_cluster.performance_insights_kms_key_id #=> String
3012
+ # resp.db_cluster.performance_insights_retention_period #=> Integer
2711
3013
  #
2712
3014
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBCluster AWS API Documentation
2713
3015
  #
@@ -2734,7 +3036,7 @@ module Aws::RDS
2734
3036
  # as a lowercase string.
2735
3037
  #
2736
3038
  # @option params [required, String] :endpoint_type
2737
- # The type of the endpoint. One of: `READER`, `WRITER`, `ANY`.
3039
+ # The type of the endpoint, one of: `READER`, `WRITER`, `ANY`.
2738
3040
  #
2739
3041
  # @option params [Array<String>] :static_members
2740
3042
  # List of DB instance identifiers that are part of the custom endpoint
@@ -2743,7 +3045,8 @@ module Aws::RDS
2743
3045
  # @option params [Array<String>] :excluded_members
2744
3046
  # List of DB instance identifiers that aren't part of the custom
2745
3047
  # endpoint group. All other eligible instances are reachable through the
2746
- # custom endpoint. Only relevant if the list of static members is empty.
3048
+ # custom endpoint. This parameter is relevant only if the list of static
3049
+ # members is empty.
2747
3050
  #
2748
3051
  # @option params [Array<Types::Tag>] :tags
2749
3052
  # The tags to be assigned to the Amazon RDS resource.
@@ -2812,10 +3115,16 @@ module Aws::RDS
2812
3115
  # modify the group after creating it using
2813
3116
  # `ModifyDBClusterParameterGroup`. Once you've created a DB cluster
2814
3117
  # parameter group, you need to associate it with your DB cluster using
2815
- # `ModifyDBCluster`. When you associate a new DB cluster parameter group
2816
- # with a running DB cluster, you need to reboot the DB instances in the
2817
- # DB cluster without failover for the new DB cluster parameter group and
2818
- # associated settings to take effect.
3118
+ # `ModifyDBCluster`.
3119
+ #
3120
+ # When you associate a new DB cluster parameter group with a running
3121
+ # Aurora DB cluster, reboot the DB instances in the DB cluster without
3122
+ # failover for the new DB cluster parameter group and associated
3123
+ # settings to take effect.
3124
+ #
3125
+ # When you associate a new DB cluster parameter group with a running
3126
+ # Multi-AZ DB cluster, reboot the DB cluster without failover for the
3127
+ # new DB cluster parameter group and associated settings to take effect.
2819
3128
  #
2820
3129
  # After you create a DB cluster parameter group, you should wait at
2821
3130
  # least 5 minutes before creating your first DB cluster that uses that
@@ -2829,10 +3138,15 @@ module Aws::RDS
2829
3138
  # RDS console][1] or the `DescribeDBClusterParameters` action to verify
2830
3139
  # that your DB cluster parameter group has been created or modified.
2831
3140
  #
2832
- # For more information on Amazon Aurora, see [ What Is Amazon
3141
+ # For more information on Amazon Aurora, see [ What is Amazon
2833
3142
  # Aurora?][2] in the *Amazon Aurora User Guide.*
2834
3143
  #
2835
- # <note markdown="1"> This action only applies to Aurora DB clusters.
3144
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
3145
+ # deployments with two readable standby DB instances][3] in the *Amazon
3146
+ # RDS User Guide.*
3147
+ #
3148
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
3149
+ # change.
2836
3150
  #
2837
3151
  # </note>
2838
3152
  #
@@ -2840,13 +3154,14 @@ module Aws::RDS
2840
3154
  #
2841
3155
  # [1]: https://console.aws.amazon.com/rds/
2842
3156
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
3157
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
2843
3158
  #
2844
3159
  # @option params [required, String] :db_cluster_parameter_group_name
2845
3160
  # The name of the DB cluster parameter group.
2846
3161
  #
2847
3162
  # Constraints:
2848
3163
  #
2849
- # * Must match the name of an existing DB cluster parameter group.
3164
+ # * Must not match the name of an existing DB cluster parameter group.
2850
3165
  #
2851
3166
  # ^
2852
3167
  #
@@ -2869,6 +3184,14 @@ module Aws::RDS
2869
3184
  #
2870
3185
  # Example: `aurora-postgresql9.6`
2871
3186
  #
3187
+ # **RDS for MySQL**
3188
+ #
3189
+ # Example: `mysql8.0`
3190
+ #
3191
+ # **RDS for PostgreSQL**
3192
+ #
3193
+ # Example: `postgres12`
3194
+ #
2872
3195
  # To list all of the available parameter group families for a DB engine,
2873
3196
  # use the following command:
2874
3197
  #
@@ -2894,6 +3217,10 @@ module Aws::RDS
2894
3217
  #
2895
3218
  # * `aurora-postgresql`
2896
3219
  #
3220
+ # * `mysql`
3221
+ #
3222
+ # * `postgres`
3223
+ #
2897
3224
  # @option params [required, String] :description
2898
3225
  # The description for the DB cluster parameter group.
2899
3226
  #
@@ -2951,17 +3278,24 @@ module Aws::RDS
2951
3278
  req.send_request(options)
2952
3279
  end
2953
3280
 
2954
- # Creates a snapshot of a DB cluster. For more information on Amazon
2955
- # Aurora, see [ What Is Amazon Aurora?][1] in the *Amazon Aurora User
2956
- # Guide.*
3281
+ # Creates a snapshot of a DB cluster.
2957
3282
  #
2958
- # <note markdown="1"> This action only applies to Aurora DB clusters.
3283
+ # For more information on Amazon Aurora, see [ What is Amazon
3284
+ # Aurora?][1] in the *Amazon Aurora User Guide.*
3285
+ #
3286
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
3287
+ # deployments with two readable standby DB instances][2] in the *Amazon
3288
+ # RDS User Guide.*
3289
+ #
3290
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
3291
+ # change.
2959
3292
  #
2960
3293
  # </note>
2961
3294
  #
2962
3295
  #
2963
3296
  #
2964
3297
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
3298
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
2965
3299
  #
2966
3300
  # @option params [required, String] :db_cluster_snapshot_identifier
2967
3301
  # The identifier of the DB cluster snapshot. This parameter is stored as
@@ -3290,8 +3624,8 @@ module Aws::RDS
3290
3624
  # * Web and Express editions: Must be an integer from 20 to 1024.
3291
3625
  #
3292
3626
  # @option params [required, String] :db_instance_class
3293
- # The compute and memory capacity of the DB instance, for example,
3294
- # `db.m4.large`. Not all DB instance classes are available in all Amazon
3627
+ # The compute and memory capacity of the DB instance, for example
3628
+ # db.m4.large. Not all DB instance classes are available in all Amazon
3295
3629
  # Web Services Regions, or for all database engines. For the full list
3296
3630
  # of DB instance classes, and availability for your engine, see [DB
3297
3631
  # Instance Class][1] in the *Amazon RDS User Guide.*
@@ -3346,59 +3680,13 @@ module Aws::RDS
3346
3680
  # Not applicable. The name for the master user is managed by the DB
3347
3681
  # cluster.
3348
3682
  #
3349
- # **MariaDB**
3350
- #
3351
- # Constraints:
3352
- #
3353
- # * Required for MariaDB.
3354
- #
3355
- # * Must be 1 to 16 letters or numbers.
3356
- #
3357
- # * Can't be a reserved word for the chosen database engine.
3358
- #
3359
- # **Microsoft SQL Server**
3360
- #
3361
- # Constraints:
3362
- #
3363
- # * Required for SQL Server.
3364
- #
3365
- # * Must be 1 to 128 letters or numbers.
3366
- #
3367
- # * The first character must be a letter.
3368
- #
3369
- # * Can't be a reserved word for the chosen database engine.
3370
- #
3371
- # **MySQL**
3372
- #
3373
- # Constraints:
3374
- #
3375
- # * Required for MySQL.
3376
- #
3377
- # * Must be 1 to 16 letters or numbers.
3378
- #
3379
- # * First character must be a letter.
3380
- #
3381
- # * Can't be a reserved word for the chosen database engine.
3382
- #
3383
- # **Oracle**
3384
- #
3385
- # Constraints:
3386
- #
3387
- # * Required for Oracle.
3388
- #
3389
- # * Must be 1 to 30 letters or numbers.
3390
- #
3391
- # * First character must be a letter.
3392
- #
3393
- # * Can't be a reserved word for the chosen database engine.
3394
- #
3395
- # **PostgreSQL**
3683
+ # **Amazon RDS**
3396
3684
  #
3397
3685
  # Constraints:
3398
3686
  #
3399
- # * Required for PostgreSQL.
3687
+ # * Required.
3400
3688
  #
3401
- # * Must be 1 to 63 letters or numbers.
3689
+ # * Must be 1 to 16 letters, numbers, or underscores.
3402
3690
  #
3403
3691
  # * First character must be a letter.
3404
3692
  #
@@ -3645,27 +3933,28 @@ module Aws::RDS
3645
3933
  #
3646
3934
  # **MariaDB**
3647
3935
  #
3648
- # See [MariaDB on Amazon RDS Versions][2] in the *Amazon RDS User
3649
- # Guide.*
3936
+ # For information, see [MariaDB on Amazon RDS Versions][2] in the
3937
+ # *Amazon RDS User Guide.*
3650
3938
  #
3651
3939
  # **Microsoft SQL Server**
3652
3940
  #
3653
- # See [Microsoft SQL Server Versions on Amazon RDS][3] in the *Amazon
3654
- # RDS User Guide.*
3941
+ # For information, see [Microsoft SQL Server Versions on Amazon RDS][3]
3942
+ # in the *Amazon RDS User Guide.*
3655
3943
  #
3656
3944
  # **MySQL**
3657
3945
  #
3658
- # See [MySQL on Amazon RDS Versions][4] in the *Amazon RDS User Guide.*
3946
+ # For information, see [MySQL on Amazon RDS Versions][4] in the *Amazon
3947
+ # RDS User Guide.*
3659
3948
  #
3660
3949
  # **Oracle**
3661
3950
  #
3662
- # See [Oracle Database Engine Release Notes][5] in the *Amazon RDS User
3663
- # Guide.*
3951
+ # For information, see [Oracle Database Engine Release Notes][5] in the
3952
+ # *Amazon RDS User Guide.*
3664
3953
  #
3665
3954
  # **PostgreSQL**
3666
3955
  #
3667
- # See [Amazon RDS for PostgreSQL versions and extensions][6] in the
3668
- # *Amazon RDS User Guide.*
3956
+ # For information, see [Amazon RDS for PostgreSQL versions and
3957
+ # extensions][6] in the *Amazon RDS User Guide.*
3669
3958
  #
3670
3959
  #
3671
3960
  #
@@ -3695,8 +3984,8 @@ module Aws::RDS
3695
3984
  # @option params [Integer] :iops
3696
3985
  # The amount of Provisioned IOPS (input/output operations per second) to
3697
3986
  # be initially allocated for the DB instance. For information about
3698
- # valid Iops values, see [Amazon RDS Provisioned IOPS Storage to Improve
3699
- # Performance][1] in the *Amazon RDS User Guide*.
3987
+ # valid `Iops` values, see [Amazon RDS Provisioned IOPS storage to
3988
+ # improve performance][1] in the *Amazon RDS User Guide*.
3700
3989
  #
3701
3990
  # Constraints: For MariaDB, MySQL, Oracle, and PostgreSQL DB instances,
3702
3991
  # must be a multiple between .5 and 50 of the storage amount for the DB
@@ -3738,12 +4027,13 @@ module Aws::RDS
3738
4027
  # @option params [Boolean] :publicly_accessible
3739
4028
  # A value that indicates whether the DB instance is publicly accessible.
3740
4029
  #
3741
- # When the DB instance is publicly accessible, its DNS endpoint resolves
3742
- # to the private IP address from within the DB instance's VPC, and to
3743
- # the public IP address from outside of the DB instance's VPC. Access
3744
- # to the DB instance is ultimately controlled by the security group it
3745
- # uses, and that public access is not permitted if the security group
3746
- # assigned to the DB instance doesn't permit it.
4030
+ # When the DB instance is publicly accessible, its Domain Name System
4031
+ # (DNS) endpoint resolves to the private IP address from within the DB
4032
+ # instance's virtual private cloud (VPC). It resolves to the public IP
4033
+ # address from outside of the DB instance's VPC. Access to the DB
4034
+ # instance is ultimately controlled by the security group it uses. That
4035
+ # public access is not permitted if the security group assigned to the
4036
+ # DB instance doesn't permit it.
3747
4037
  #
3748
4038
  # When the DB instance isn't publicly accessible, it is an internal DB
3749
4039
  # instance with a DNS name that resolves to a private IP address.
@@ -3754,19 +4044,19 @@ module Aws::RDS
3754
4044
  # If `DBSubnetGroupName` isn't specified, and `PubliclyAccessible`
3755
4045
  # isn't specified, the following applies:
3756
4046
  #
3757
- # * If the default VPC in the target region doesn’t have an Internet
4047
+ # * If the default VPC in the target Region doesn’t have an internet
3758
4048
  # gateway attached to it, the DB instance is private.
3759
4049
  #
3760
- # * If the default VPC in the target region has an Internet gateway
4050
+ # * If the default VPC in the target Region has an internet gateway
3761
4051
  # attached to it, the DB instance is public.
3762
4052
  #
3763
4053
  # If `DBSubnetGroupName` is specified, and `PubliclyAccessible` isn't
3764
4054
  # specified, the following applies:
3765
4055
  #
3766
- # * If the subnets are part of a VPC that doesn’t have an Internet
4056
+ # * If the subnets are part of a VPC that doesn’t have an internet
3767
4057
  # gateway attached to it, the DB instance is private.
3768
4058
  #
3769
- # * If the subnets are part of a VPC that has an Internet gateway
4059
+ # * If the subnets are part of a VPC that has an internet gateway
3770
4060
  # attached to it, the DB instance is public.
3771
4061
  #
3772
4062
  # @option params [Array<Types::Tag>] :tags
@@ -3925,7 +4215,7 @@ module Aws::RDS
3925
4215
  # @option params [Boolean] :enable_iam_database_authentication
3926
4216
  # A value that indicates whether to enable mapping of Amazon Web
3927
4217
  # Services Identity and Access Management (IAM) accounts to database
3928
- # accounts. By default, mapping is disabled.
4218
+ # accounts. By default, mapping isn't enabled.
3929
4219
  #
3930
4220
  # This setting doesn't apply to RDS Custom or Amazon Aurora. In Aurora,
3931
4221
  # mapping Amazon Web Services IAM accounts to database accounts is
@@ -4017,7 +4307,7 @@ module Aws::RDS
4017
4307
  # @option params [Boolean] :deletion_protection
4018
4308
  # A value that indicates whether the DB instance has deletion protection
4019
4309
  # enabled. The database can't be deleted when deletion protection is
4020
- # enabled. By default, deletion protection is disabled. For more
4310
+ # enabled. By default, deletion protection isn't enabled. For more
4021
4311
  # information, see [ Deleting a DB Instance][1].
4022
4312
  #
4023
4313
  # **Amazon Aurora**
@@ -4089,6 +4379,19 @@ module Aws::RDS
4089
4379
  #
4090
4380
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
4091
4381
  #
4382
+ # @option params [String] :backup_target
4383
+ # Specifies where automated backups and manual snapshots are stored.
4384
+ #
4385
+ # Possible values are `outposts` (Amazon Web Services Outposts) and
4386
+ # `region` (Amazon Web Services Region). The default is `region`.
4387
+ #
4388
+ # For more information, see [Working with Amazon RDS on Amazon Web
4389
+ # Services Outposts][1] in the *Amazon RDS User Guide*.
4390
+ #
4391
+ #
4392
+ #
4393
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
4394
+ #
4092
4395
  # @return [Types::CreateDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4093
4396
  #
4094
4397
  # * {Types::CreateDBInstanceResult#db_instance #db_instance} => Types::DBInstance
@@ -4175,6 +4478,7 @@ module Aws::RDS
4175
4478
  # max_allocated_storage: 1,
4176
4479
  # enable_customer_owned_ip: false,
4177
4480
  # custom_iam_instance_profile: "String",
4481
+ # backup_target: "String",
4178
4482
  # })
4179
4483
  #
4180
4484
  # @example Response structure
@@ -4314,6 +4618,7 @@ module Aws::RDS
4314
4618
  # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
4315
4619
  # resp.db_instance.resume_full_automation_mode_time #=> Time
4316
4620
  # resp.db_instance.custom_iam_instance_profile #=> String
4621
+ # resp.db_instance.backup_target #=> String
4317
4622
  #
4318
4623
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstance AWS API Documentation
4319
4624
  #
@@ -4370,7 +4675,7 @@ module Aws::RDS
4370
4675
  # Guide*.
4371
4676
  #
4372
4677
  # * Can specify a PostgreSQL DB instance only if the source is running
4373
- # PostgreSQL 9.3.5 or later (9.4.7 and higher for cross-region
4678
+ # PostgreSQL 9.3.5 or later (9.4.7 and higher for cross-Region
4374
4679
  # replication).
4375
4680
  #
4376
4681
  # * The specified DB instance must have automatic backups enabled, that
@@ -4392,8 +4697,8 @@ module Aws::RDS
4392
4697
  # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.ARN.html#USER_Tagging.ARN.Constructing
4393
4698
  #
4394
4699
  # @option params [String] :db_instance_class
4395
- # The compute and memory capacity of the read replica, for example,
4396
- # `db.m4.large`. Not all DB instance classes are available in all Amazon
4700
+ # The compute and memory capacity of the read replica, for example
4701
+ # db.m4.large. Not all DB instance classes are available in all Amazon
4397
4702
  # Web Services Regions, or for all database engines. For the full list
4398
4703
  # of DB instance classes, and availability for your engine, see [DB
4399
4704
  # Instance Class][1] in the *Amazon RDS User Guide.*
@@ -4459,8 +4764,8 @@ module Aws::RDS
4459
4764
  #
4460
4765
  # If you do not specify a value for `DBParameterGroupName`, then Amazon
4461
4766
  # RDS uses the `DBParameterGroup` of source DB instance for a same
4462
- # region read replica, or the default `DBParameterGroup` for the
4463
- # specified DB engine for a cross region read replica.
4767
+ # Region read replica, or the default `DBParameterGroup` for the
4768
+ # specified DB engine for a cross-Region read replica.
4464
4769
  #
4465
4770
  # Specifying a parameter group for this operation is only supported for
4466
4771
  # Oracle DB instances. It isn't supported for RDS Custom.
@@ -4476,12 +4781,13 @@ module Aws::RDS
4476
4781
  # @option params [Boolean] :publicly_accessible
4477
4782
  # A value that indicates whether the DB instance is publicly accessible.
4478
4783
  #
4479
- # When the DB instance is publicly accessible, its DNS endpoint resolves
4480
- # to the private IP address from within the DB instance's VPC, and to
4481
- # the public IP address from outside of the DB instance's VPC. Access
4482
- # to the DB instance is ultimately controlled by the security group it
4483
- # uses, and that public access is not permitted if the security group
4484
- # assigned to the DB instance doesn't permit it.
4784
+ # When the DB cluster is publicly accessible, its Domain Name System
4785
+ # (DNS) endpoint resolves to the private IP address from within the DB
4786
+ # cluster's virtual private cloud (VPC). It resolves to the public IP
4787
+ # address from outside of the DB cluster's VPC. Access to the DB
4788
+ # cluster is ultimately controlled by the security group it uses. That
4789
+ # public access isn't permitted if the security group assigned to the
4790
+ # DB cluster doesn't permit it.
4485
4791
  #
4486
4792
  # When the DB instance isn't publicly accessible, it is an internal DB
4487
4793
  # instance with a DNS name that resolves to a private IP address.
@@ -4659,7 +4965,7 @@ module Aws::RDS
4659
4965
  # Region.
4660
4966
  #
4661
4967
  # `SourceRegion` isn't supported for SQL Server, because SQL Server on
4662
- # Amazon RDS doesn't support cross-region read replicas.
4968
+ # Amazon RDS doesn't support cross-Region read replicas.
4663
4969
  #
4664
4970
  # </note>
4665
4971
  #
@@ -4673,7 +4979,7 @@ module Aws::RDS
4673
4979
  # @option params [Boolean] :enable_iam_database_authentication
4674
4980
  # A value that indicates whether to enable mapping of Amazon Web
4675
4981
  # Services Identity and Access Management (IAM) accounts to database
4676
- # accounts. By default, mapping is disabled.
4982
+ # accounts. By default, mapping isn't enabled.
4677
4983
  #
4678
4984
  # For more information about IAM database authentication, see [ IAM
4679
4985
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
@@ -4745,7 +5051,7 @@ module Aws::RDS
4745
5051
  # @option params [Boolean] :deletion_protection
4746
5052
  # A value that indicates whether the DB instance has deletion protection
4747
5053
  # enabled. The database can't be deleted when deletion protection is
4748
- # enabled. By default, deletion protection is disabled. For more
5054
+ # enabled. By default, deletion protection isn't enabled. For more
4749
5055
  # information, see [ Deleting a DB Instance][1].
4750
5056
  #
4751
5057
  #
@@ -5055,6 +5361,7 @@ module Aws::RDS
5055
5361
  # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
5056
5362
  # resp.db_instance.resume_full_automation_mode_time #=> Time
5057
5363
  # resp.db_instance.custom_iam_instance_profile #=> String
5364
+ # resp.db_instance.backup_target #=> String
5058
5365
  #
5059
5366
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstanceReadReplica AWS API Documentation
5060
5367
  #
@@ -5609,6 +5916,7 @@ module Aws::RDS
5609
5916
  # resp.db_snapshot.tag_list[0].key #=> String
5610
5917
  # resp.db_snapshot.tag_list[0].value #=> String
5611
5918
  # resp.db_snapshot.original_snapshot_create_time #=> Time
5919
+ # resp.db_snapshot.snapshot_target #=> String
5612
5920
  #
5613
5921
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBSnapshot AWS API Documentation
5614
5922
  #
@@ -6270,18 +6578,22 @@ module Aws::RDS
6270
6578
  # DB cluster are deleted and can't be recovered. Manual DB cluster
6271
6579
  # snapshots of the specified DB cluster are not deleted.
6272
6580
  #
6273
- #
6274
- #
6275
- # For more information on Amazon Aurora, see [ What Is Amazon
6581
+ # For more information on Amazon Aurora, see [ What is Amazon
6276
6582
  # Aurora?][1] in the *Amazon Aurora User Guide.*
6277
6583
  #
6278
- # <note markdown="1"> This action only applies to Aurora DB clusters.
6584
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
6585
+ # deployments with two readable standby DB instances][2] in the *Amazon
6586
+ # RDS User Guide.*
6587
+ #
6588
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
6589
+ # change.
6279
6590
  #
6280
6591
  # </note>
6281
6592
  #
6282
6593
  #
6283
6594
  #
6284
6595
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
6596
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
6285
6597
  #
6286
6598
  # @option params [required, String] :db_cluster_identifier
6287
6599
  # The DB cluster identifier for the DB cluster to be deleted. This
@@ -6444,6 +6756,16 @@ module Aws::RDS
6444
6756
  # resp.db_cluster.pending_modified_values.master_user_password #=> String
6445
6757
  # resp.db_cluster.pending_modified_values.iam_database_authentication_enabled #=> Boolean
6446
6758
  # resp.db_cluster.pending_modified_values.engine_version #=> String
6759
+ # resp.db_cluster.db_cluster_instance_class #=> String
6760
+ # resp.db_cluster.storage_type #=> String
6761
+ # resp.db_cluster.iops #=> Integer
6762
+ # resp.db_cluster.publicly_accessible #=> Boolean
6763
+ # resp.db_cluster.auto_minor_version_upgrade #=> Boolean
6764
+ # resp.db_cluster.monitoring_interval #=> Integer
6765
+ # resp.db_cluster.monitoring_role_arn #=> String
6766
+ # resp.db_cluster.performance_insights_enabled #=> Boolean
6767
+ # resp.db_cluster.performance_insights_kms_key_id #=> String
6768
+ # resp.db_cluster.performance_insights_retention_period #=> Integer
6447
6769
  #
6448
6770
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBCluster AWS API Documentation
6449
6771
  #
@@ -6512,16 +6834,22 @@ module Aws::RDS
6512
6834
  # parameter group to be deleted can't be associated with any DB
6513
6835
  # clusters.
6514
6836
  #
6515
- # For more information on Amazon Aurora, see [ What Is Amazon
6837
+ # For more information on Amazon Aurora, see [ What is Amazon
6516
6838
  # Aurora?][1] in the *Amazon Aurora User Guide.*
6517
6839
  #
6518
- # <note markdown="1"> This action only applies to Aurora DB clusters.
6840
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
6841
+ # deployments with two readable standby DB instances][2] in the *Amazon
6842
+ # RDS User Guide.*
6843
+ #
6844
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
6845
+ # change.
6519
6846
  #
6520
6847
  # </note>
6521
6848
  #
6522
6849
  #
6523
6850
  #
6524
6851
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
6852
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
6525
6853
  #
6526
6854
  # @option params [required, String] :db_cluster_parameter_group_name
6527
6855
  # The name of the DB cluster parameter group.
@@ -6568,16 +6896,22 @@ module Aws::RDS
6568
6896
  #
6569
6897
  # </note>
6570
6898
  #
6571
- # For more information on Amazon Aurora, see [ What Is Amazon
6899
+ # For more information on Amazon Aurora, see [ What is Amazon
6572
6900
  # Aurora?][1] in the *Amazon Aurora User Guide.*
6573
6901
  #
6574
- # <note markdown="1"> This action only applies to Aurora DB clusters.
6902
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
6903
+ # deployments with two readable standby DB instances][2] in the *Amazon
6904
+ # RDS User Guide.*
6905
+ #
6906
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
6907
+ # change.
6575
6908
  #
6576
6909
  # </note>
6577
6910
  #
6578
6911
  #
6579
6912
  #
6580
6913
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
6914
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
6581
6915
  #
6582
6916
  # @option params [required, String] :db_cluster_snapshot_identifier
6583
6917
  # The identifier of the DB cluster snapshot to delete.
@@ -6903,6 +7237,7 @@ module Aws::RDS
6903
7237
  # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
6904
7238
  # resp.db_instance.resume_full_automation_mode_time #=> Time
6905
7239
  # resp.db_instance.custom_iam_instance_profile #=> String
7240
+ # resp.db_instance.backup_target #=> String
6906
7241
  #
6907
7242
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBInstance AWS API Documentation
6908
7243
  #
@@ -6969,6 +7304,7 @@ module Aws::RDS
6969
7304
  # resp.db_instance_automated_backup.db_instance_automated_backups_arn #=> String
6970
7305
  # resp.db_instance_automated_backup.db_instance_automated_backups_replications #=> Array
6971
7306
  # resp.db_instance_automated_backup.db_instance_automated_backups_replications[0].db_instance_automated_backups_arn #=> String
7307
+ # resp.db_instance_automated_backup.backup_target #=> String
6972
7308
  #
6973
7309
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBInstanceAutomatedBackup AWS API Documentation
6974
7310
  #
@@ -7236,6 +7572,7 @@ module Aws::RDS
7236
7572
  # resp.db_snapshot.tag_list[0].key #=> String
7237
7573
  # resp.db_snapshot.tag_list[0].value #=> String
7238
7574
  # resp.db_snapshot.original_snapshot_create_time #=> Time
7575
+ # resp.db_snapshot.snapshot_target #=> String
7239
7576
  #
7240
7577
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBSnapshot AWS API Documentation
7241
7578
  #
@@ -7722,7 +8059,7 @@ module Aws::RDS
7722
8059
 
7723
8060
  # Returns information about backtracks for a DB cluster.
7724
8061
  #
7725
- # For more information on Amazon Aurora, see [ What Is Amazon
8062
+ # For more information on Amazon Aurora, see [ What is Amazon
7726
8063
  # Aurora?][1] in the *Amazon Aurora User Guide.*
7727
8064
  #
7728
8065
  # <note markdown="1"> This action only applies to Aurora MySQL DB clusters.
@@ -7941,16 +8278,22 @@ module Aws::RDS
7941
8278
  # contain only the description of the specified DB cluster parameter
7942
8279
  # group.
7943
8280
  #
7944
- # For more information on Amazon Aurora, see [ What Is Amazon
8281
+ # For more information on Amazon Aurora, see [ What is Amazon
7945
8282
  # Aurora?][1] in the *Amazon Aurora User Guide.*
7946
8283
  #
7947
- # <note markdown="1"> This action only applies to Aurora DB clusters.
8284
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
8285
+ # deployments with two readable standby DB instances][2] in the *Amazon
8286
+ # RDS User Guide.*
8287
+ #
8288
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
8289
+ # change.
7948
8290
  #
7949
8291
  # </note>
7950
8292
  #
7951
8293
  #
7952
8294
  #
7953
8295
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
8296
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
7954
8297
  #
7955
8298
  # @option params [String] :db_cluster_parameter_group_name
7956
8299
  # The name of a specific DB cluster parameter group to return details
@@ -8037,16 +8380,22 @@ module Aws::RDS
8037
8380
  # Returns the detailed parameter list for a particular DB cluster
8038
8381
  # parameter group.
8039
8382
  #
8040
- # For more information on Amazon Aurora, see [ What Is Amazon
8383
+ # For more information on Amazon Aurora, see [ What is Amazon
8041
8384
  # Aurora?][1] in the *Amazon Aurora User Guide.*
8042
8385
  #
8043
- # <note markdown="1"> This action only applies to Aurora DB clusters.
8386
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
8387
+ # deployments with two readable standby DB instances][2] in the *Amazon
8388
+ # RDS User Guide.*
8389
+ #
8390
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
8391
+ # change.
8044
8392
  #
8045
8393
  # </note>
8046
8394
  #
8047
8395
  #
8048
8396
  #
8049
8397
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
8398
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
8050
8399
  #
8051
8400
  # @option params [required, String] :db_cluster_parameter_group_name
8052
8401
  # The name of a specific DB cluster parameter group to return parameter
@@ -8160,10 +8509,6 @@ module Aws::RDS
8160
8509
  # snapshot public or private, use the `ModifyDBClusterSnapshotAttribute`
8161
8510
  # API action.
8162
8511
  #
8163
- # <note markdown="1"> This action only applies to Aurora DB clusters.
8164
- #
8165
- # </note>
8166
- #
8167
8512
  # @option params [required, String] :db_cluster_snapshot_identifier
8168
8513
  # The identifier for the DB cluster snapshot to describe the attributes
8169
8514
  # for.
@@ -8213,16 +8558,22 @@ module Aws::RDS
8213
8558
  # Returns information about DB cluster snapshots. This API action
8214
8559
  # supports pagination.
8215
8560
  #
8216
- # For more information on Amazon Aurora, see [ What Is Amazon
8217
- # Aurora?][1] in the *Amazon Aurora User Guide.*
8561
+ # For more information on Amazon Aurora DB clusters, see [ What is
8562
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
8218
8563
  #
8219
- # <note markdown="1"> This action only applies to Aurora DB clusters.
8564
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
8565
+ # deployments with two readable standby DB instances][2] in the *Amazon
8566
+ # RDS User Guide.*
8567
+ #
8568
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
8569
+ # change.
8220
8570
  #
8221
8571
  # </note>
8222
8572
  #
8223
8573
  #
8224
8574
  #
8225
8575
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
8576
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
8226
8577
  #
8227
8578
  # @option params [String] :db_cluster_identifier
8228
8579
  # The ID of the DB cluster to retrieve the list of DB cluster snapshots
@@ -8410,20 +8761,28 @@ module Aws::RDS
8410
8761
  req.send_request(options)
8411
8762
  end
8412
8763
 
8413
- # Returns information about provisioned Aurora DB clusters. This API
8414
- # supports pagination.
8764
+ # Returns information about Amazon Aurora DB clusters and Multi-AZ DB
8765
+ # clusters. This API supports pagination.
8766
+ #
8767
+ # For more information on Amazon Aurora DB clusters, see [ What is
8768
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
8415
8769
  #
8416
- # For more information on Amazon Aurora, see [ What Is Amazon
8417
- # Aurora?][1] in the *Amazon Aurora User Guide.*
8770
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
8771
+ # deployments with two readable standby DB instances][2] in the *Amazon
8772
+ # RDS User Guide.*
8418
8773
  #
8419
- # <note markdown="1"> This operation can also return information for Amazon Neptune DB
8420
- # instances and Amazon DocumentDB instances.
8774
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
8775
+ # change.
8421
8776
  #
8422
8777
  # </note>
8423
8778
  #
8779
+ # This operation can also return information for Amazon Neptune DB
8780
+ # instances and Amazon DocumentDB instances.
8781
+ #
8424
8782
  #
8425
8783
  #
8426
8784
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
8785
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
8427
8786
  #
8428
8787
  # @option params [String] :db_cluster_identifier
8429
8788
  # The user-supplied DB cluster identifier. If this parameter is
@@ -8606,6 +8965,16 @@ module Aws::RDS
8606
8965
  # resp.db_clusters[0].pending_modified_values.master_user_password #=> String
8607
8966
  # resp.db_clusters[0].pending_modified_values.iam_database_authentication_enabled #=> Boolean
8608
8967
  # resp.db_clusters[0].pending_modified_values.engine_version #=> String
8968
+ # resp.db_clusters[0].db_cluster_instance_class #=> String
8969
+ # resp.db_clusters[0].storage_type #=> String
8970
+ # resp.db_clusters[0].iops #=> Integer
8971
+ # resp.db_clusters[0].publicly_accessible #=> Boolean
8972
+ # resp.db_clusters[0].auto_minor_version_upgrade #=> Boolean
8973
+ # resp.db_clusters[0].monitoring_interval #=> Integer
8974
+ # resp.db_clusters[0].monitoring_role_arn #=> String
8975
+ # resp.db_clusters[0].performance_insights_enabled #=> Boolean
8976
+ # resp.db_clusters[0].performance_insights_kms_key_id #=> String
8977
+ # resp.db_clusters[0].performance_insights_retention_period #=> Integer
8609
8978
  #
8610
8979
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusters AWS API Documentation
8611
8980
  #
@@ -8938,6 +9307,7 @@ module Aws::RDS
8938
9307
  # resp.db_instance_automated_backups[0].db_instance_automated_backups_arn #=> String
8939
9308
  # resp.db_instance_automated_backups[0].db_instance_automated_backups_replications #=> Array
8940
9309
  # resp.db_instance_automated_backups[0].db_instance_automated_backups_replications[0].db_instance_automated_backups_arn #=> String
9310
+ # resp.db_instance_automated_backups[0].backup_target #=> String
8941
9311
  #
8942
9312
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBInstanceAutomatedBackups AWS API Documentation
8943
9313
  #
@@ -9181,6 +9551,7 @@ module Aws::RDS
9181
9551
  # resp.db_instances[0].automation_mode #=> String, one of "full", "all-paused"
9182
9552
  # resp.db_instances[0].resume_full_automation_mode_time #=> Time
9183
9553
  # resp.db_instances[0].custom_iam_instance_profile #=> String
9554
+ # resp.db_instances[0].backup_target #=> String
9184
9555
  #
9185
9556
  #
9186
9557
  # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -10141,6 +10512,7 @@ module Aws::RDS
10141
10512
  # resp.db_snapshots[0].tag_list[0].key #=> String
10142
10513
  # resp.db_snapshots[0].tag_list[0].value #=> String
10143
10514
  # resp.db_snapshots[0].original_snapshot_create_time #=> Time
10515
+ # resp.db_snapshots[0].snapshot_target #=> String
10144
10516
  #
10145
10517
  #
10146
10518
  # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -10250,7 +10622,7 @@ module Aws::RDS
10250
10622
  # Returns the default engine and system parameter information for the
10251
10623
  # cluster database engine.
10252
10624
  #
10253
- # For more information on Amazon Aurora, see [ What Is Amazon
10625
+ # For more information on Amazon Aurora, see [ What is Amazon
10254
10626
  # Aurora?][1] in the *Amazon Aurora User Guide.*
10255
10627
  #
10256
10628
  #
@@ -10775,6 +11147,8 @@ module Aws::RDS
10775
11147
  #
10776
11148
  # * `failed`
10777
11149
  #
11150
+ # * `in_progress`
11151
+ #
10778
11152
  # * `starting`
10779
11153
  #
10780
11154
  # @option params [String] :marker
@@ -10848,7 +11222,7 @@ module Aws::RDS
10848
11222
  # Returns information about Aurora global database clusters. This API
10849
11223
  # supports pagination.
10850
11224
  #
10851
- # For more information on Amazon Aurora, see [ What Is Amazon
11225
+ # For more information on Amazon Aurora, see [ What is Amazon
10852
11226
  # Aurora?][1] in the *Amazon Aurora User Guide.*
10853
11227
  #
10854
11228
  # <note markdown="1"> This action only applies to Aurora DB clusters.
@@ -11289,8 +11663,8 @@ module Aws::RDS
11289
11663
  req.send_request(options)
11290
11664
  end
11291
11665
 
11292
- # Returns a list of orderable DB instance options for the specified
11293
- # engine.
11666
+ # Returns a list of orderable DB instance options for the specified DB
11667
+ # engine, DB engine version, and DB instance class.
11294
11668
  #
11295
11669
  # @option params [required, String] :engine
11296
11670
  # The name of the engine to retrieve DB instance options for.
@@ -11456,6 +11830,7 @@ module Aws::RDS
11456
11830
  # resp.orderable_db_instance_options[0].supported_activity_stream_modes #=> Array
11457
11831
  # resp.orderable_db_instance_options[0].supported_activity_stream_modes[0] #=> String
11458
11832
  # resp.orderable_db_instance_options[0].supports_global_databases #=> Boolean
11833
+ # resp.orderable_db_instance_options[0].supports_clusters #=> Boolean
11459
11834
  # resp.marker #=> String
11460
11835
  #
11461
11836
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeOrderableDBInstanceOptions AWS API Documentation
@@ -12110,27 +12485,41 @@ module Aws::RDS
12110
12485
 
12111
12486
  # Forces a failover for a DB cluster.
12112
12487
  #
12113
- # A failover for a DB cluster promotes one of the Aurora Replicas
12114
- # (read-only instances) in the DB cluster to be the primary instance
12115
- # (the cluster writer).
12488
+ # For an Aurora DB cluster, failover for a DB cluster promotes one of
12489
+ # the Aurora Replicas (read-only instances) in the DB cluster to be the
12490
+ # primary DB instance (the cluster writer).
12116
12491
  #
12117
- # Amazon Aurora will automatically fail over to an Aurora Replica, if
12118
- # one exists, when the primary instance fails. You can force a failover
12119
- # when you want to simulate a failure of a primary instance for testing.
12120
- # Because each instance in a DB cluster has its own endpoint address,
12121
- # you will need to clean up and re-establish any existing connections
12122
- # that use those endpoint addresses when the failover is complete.
12492
+ # For a Multi-AZ DB cluster, failover for a DB cluster promotes one of
12493
+ # the readable standby DB instances (read-only instances) in the DB
12494
+ # cluster to be the primary DB instance (the cluster writer).
12123
12495
  #
12124
- # For more information on Amazon Aurora, see [ What Is Amazon
12125
- # Aurora?][1] in the *Amazon Aurora User Guide.*
12496
+ # An Amazon Aurora DB cluster automatically fails over to an Aurora
12497
+ # Replica, if one exists, when the primary DB instance fails. A Multi-AZ
12498
+ # DB cluster automatically fails over to a readbable standby DB instance
12499
+ # when the primary DB instance fails.
12126
12500
  #
12127
- # <note markdown="1"> This action only applies to Aurora DB clusters.
12501
+ # To simulate a failure of a primary instance for testing, you can force
12502
+ # a failover. Because each instance in a DB cluster has its own endpoint
12503
+ # address, make sure to clean up and re-establish any existing
12504
+ # connections that use those endpoint addresses when the failover is
12505
+ # complete.
12506
+ #
12507
+ # For more information on Amazon Aurora DB clusters, see [ What is
12508
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
12509
+ #
12510
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
12511
+ # deployments with two readable standby DB instances][2] in the *Amazon
12512
+ # RDS User Guide.*
12513
+ #
12514
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
12515
+ # change.
12128
12516
  #
12129
12517
  # </note>
12130
12518
  #
12131
12519
  #
12132
12520
  #
12133
12521
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
12522
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
12134
12523
  #
12135
12524
  # @option params [required, String] :db_cluster_identifier
12136
12525
  # A DB cluster identifier to force a failover for. This parameter isn't
@@ -12143,10 +12532,13 @@ module Aws::RDS
12143
12532
  # ^
12144
12533
  #
12145
12534
  # @option params [String] :target_db_instance_identifier
12146
- # The name of the instance to promote to the primary instance.
12535
+ # The name of the DB instance to promote to the primary DB instance.
12536
+ #
12537
+ # Specify the DB instance identifier for an Aurora Replica or a Multi-AZ
12538
+ # readable standby in the DB cluster, for example
12539
+ # `mydbcluster-replica1`.
12147
12540
  #
12148
- # You must specify the instance identifier for an Aurora Replica in the
12149
- # DB cluster. For example, `mydbcluster-replica1`.
12541
+ # This setting isn't supported for RDS for MySQL Multi-AZ DB clusters.
12150
12542
  #
12151
12543
  # @return [Types::FailoverDBClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
12152
12544
  #
@@ -12267,6 +12659,16 @@ module Aws::RDS
12267
12659
  # resp.db_cluster.pending_modified_values.master_user_password #=> String
12268
12660
  # resp.db_cluster.pending_modified_values.iam_database_authentication_enabled #=> Boolean
12269
12661
  # resp.db_cluster.pending_modified_values.engine_version #=> String
12662
+ # resp.db_cluster.db_cluster_instance_class #=> String
12663
+ # resp.db_cluster.storage_type #=> String
12664
+ # resp.db_cluster.iops #=> Integer
12665
+ # resp.db_cluster.publicly_accessible #=> Boolean
12666
+ # resp.db_cluster.auto_minor_version_upgrade #=> Boolean
12667
+ # resp.db_cluster.monitoring_interval #=> Integer
12668
+ # resp.db_cluster.monitoring_role_arn #=> String
12669
+ # resp.db_cluster.performance_insights_enabled #=> Boolean
12670
+ # resp.db_cluster.performance_insights_kms_key_id #=> String
12671
+ # resp.db_cluster.performance_insights_retention_period #=> Integer
12270
12672
  #
12271
12673
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/FailoverDBCluster AWS API Documentation
12272
12674
  #
@@ -12727,7 +13129,7 @@ module Aws::RDS
12727
13129
  #
12728
13130
  #
12729
13131
  #
12730
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.preparing.manifest
13132
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.modify
12731
13133
  #
12732
13134
  # @option params [required, String] :engine
12733
13135
  # The DB engine. The only supported value is `custom-oracle-ee`.
@@ -12857,19 +13259,26 @@ module Aws::RDS
12857
13259
  req.send_request(options)
12858
13260
  end
12859
13261
 
12860
- # Modify a setting for an Amazon Aurora DB cluster. You can change one
12861
- # or more database configuration parameters by specifying these
12862
- # parameters and the new values in the request. For more information on
12863
- # Amazon Aurora, see [ What Is Amazon Aurora?][1] in the *Amazon Aurora
12864
- # User Guide.*
13262
+ # Modify the settings for an Amazon Aurora DB cluster or a Multi-AZ DB
13263
+ # cluster. You can change one or more settings by specifying these
13264
+ # parameters and the new values in the request.
12865
13265
  #
12866
- # <note markdown="1"> This action only applies to Aurora DB clusters.
13266
+ # For more information on Amazon Aurora DB clusters, see [ What is
13267
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
13268
+ #
13269
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
13270
+ # deployments with two readable standby DB instances][2] in the *Amazon
13271
+ # RDS User Guide.*
13272
+ #
13273
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
13274
+ # change.
12867
13275
  #
12868
13276
  # </note>
12869
13277
  #
12870
13278
  #
12871
13279
  #
12872
13280
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
13281
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
12873
13282
  #
12874
13283
  # @option params [required, String] :db_cluster_identifier
12875
13284
  # The DB cluster identifier for the cluster being modified. This
@@ -12878,6 +13287,8 @@ module Aws::RDS
12878
13287
  # Constraints: This identifier must match the identifier of an existing
12879
13288
  # DB cluster.
12880
13289
  #
13290
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
13291
+ #
12881
13292
  # @option params [String] :new_db_cluster_identifier
12882
13293
  # The new DB cluster identifier for the DB cluster when renaming a DB
12883
13294
  # cluster. This value is stored as a lowercase string.
@@ -12892,6 +13303,8 @@ module Aws::RDS
12892
13303
  #
12893
13304
  # Example: `my-cluster2`
12894
13305
  #
13306
+ # Valid for: Aurora DB clusters only
13307
+ #
12895
13308
  # @option params [Boolean] :apply_immediately
12896
13309
  # A value that indicates whether the modifications in this request and
12897
13310
  # any pending modifications are asynchronously applied as soon as
@@ -12910,9 +13323,11 @@ module Aws::RDS
12910
13323
  #
12911
13324
  # By default, this parameter is disabled.
12912
13325
  #
13326
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
13327
+ #
12913
13328
  # @option params [Integer] :backup_retention_period
12914
- # The number of days for which automated backups are retained. You must
12915
- # specify a minimum value of 1.
13329
+ # The number of days for which automated backups are retained. Specify a
13330
+ # minimum value of 1.
12916
13331
  #
12917
13332
  # Default: 1
12918
13333
  #
@@ -12922,12 +13337,18 @@ module Aws::RDS
12922
13337
  #
12923
13338
  # ^
12924
13339
  #
13340
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
13341
+ #
12925
13342
  # @option params [String] :db_cluster_parameter_group_name
12926
13343
  # The name of the DB cluster parameter group to use for the DB cluster.
12927
13344
  #
13345
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
13346
+ #
12928
13347
  # @option params [Array<String>] :vpc_security_group_ids
12929
13348
  # A list of VPC security groups that the DB cluster will belong to.
12930
13349
  #
13350
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
13351
+ #
12931
13352
  # @option params [Integer] :port
12932
13353
  # The port number on which the DB cluster accepts connections.
12933
13354
  #
@@ -12935,25 +13356,22 @@ module Aws::RDS
12935
13356
  #
12936
13357
  # Default: The same port as the original DB cluster.
12937
13358
  #
13359
+ # Valid for: Aurora DB clusters only
13360
+ #
12938
13361
  # @option params [String] :master_user_password
12939
13362
  # The new password for the master database user. This password can
12940
13363
  # contain any printable ASCII character except "/", """, or "@".
12941
13364
  #
12942
13365
  # Constraints: Must contain from 8 to 41 characters.
12943
13366
  #
13367
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
13368
+ #
12944
13369
  # @option params [String] :option_group_name
12945
13370
  # A value that indicates that the DB cluster should be associated with
12946
- # the specified option group. Changing this parameter doesn't result in
12947
- # an outage except in the following case, and the change is applied
12948
- # during the next maintenance window unless the `ApplyImmediately` is
12949
- # enabled for this request. If the parameter change results in an option
12950
- # group that enables OEM, this change can cause a brief (sub-second)
12951
- # period during which new connections are rejected but existing
12952
- # connections are not interrupted.
12953
- #
12954
- # Permanent options can't be removed from an option group. The option
12955
- # group can't be removed from a DB cluster once it is associated with a
12956
- # DB cluster.
13371
+ # the specified option group.
13372
+ #
13373
+ # DB clusters are associated with a default option group that can't be
13374
+ # modified.
12957
13375
  #
12958
13376
  # @option params [String] :preferred_backup_window
12959
13377
  # The daily time range during which automated backups are created if
@@ -12975,6 +13393,8 @@ module Aws::RDS
12975
13393
  #
12976
13394
  # * Must be at least 30 minutes.
12977
13395
  #
13396
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
13397
+ #
12978
13398
  #
12979
13399
  #
12980
13400
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Managing.Backups.html#Aurora.Managing.Backups.BackupWindow
@@ -12995,6 +13415,8 @@ module Aws::RDS
12995
13415
  #
12996
13416
  # Constraints: Minimum 30-minute window.
12997
13417
  #
13418
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
13419
+ #
12998
13420
  #
12999
13421
  #
13000
13422
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#AdjustingTheMaintenanceWindow.Aurora
@@ -13002,11 +13424,13 @@ module Aws::RDS
13002
13424
  # @option params [Boolean] :enable_iam_database_authentication
13003
13425
  # A value that indicates whether to enable mapping of Amazon Web
13004
13426
  # Services Identity and Access Management (IAM) accounts to database
13005
- # accounts. By default, mapping is disabled.
13427
+ # accounts. By default, mapping isn't enabled.
13006
13428
  #
13007
13429
  # For more information, see [ IAM Database Authentication][1] in the
13008
13430
  # *Amazon Aurora User Guide.*
13009
13431
  #
13432
+ # Valid for: Aurora DB clusters only
13433
+ #
13010
13434
  #
13011
13435
  #
13012
13436
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.html
@@ -13015,10 +13439,6 @@ module Aws::RDS
13015
13439
  # The target backtrack window, in seconds. To disable backtracking, set
13016
13440
  # this value to 0.
13017
13441
  #
13018
- # <note markdown="1"> Currently, Backtrack is only supported for Aurora MySQL DB clusters.
13019
- #
13020
- # </note>
13021
- #
13022
13442
  # Default: 0
13023
13443
  #
13024
13444
  # Constraints:
@@ -13028,34 +13448,52 @@ module Aws::RDS
13028
13448
  #
13029
13449
  # ^
13030
13450
  #
13451
+ # Valid for: Aurora MySQL DB clusters only
13452
+ #
13031
13453
  # @option params [Types::CloudwatchLogsExportConfiguration] :cloudwatch_logs_export_configuration
13032
13454
  # The configuration setting for the log types to be enabled for export
13033
13455
  # to CloudWatch Logs for a specific DB cluster.
13034
13456
  #
13457
+ # Valid for: Aurora DB clusters only
13458
+ #
13035
13459
  # @option params [String] :engine_version
13036
13460
  # The version number of the database engine to which you want to
13037
13461
  # upgrade. Changing this parameter results in an outage. The change is
13038
13462
  # applied during the next maintenance window unless `ApplyImmediately`
13039
13463
  # is enabled.
13040
13464
  #
13041
- # To list all of the available engine versions for `aurora` (for MySQL
13042
- # 5.6-compatible Aurora), use the following command:
13465
+ # To list all of the available engine versions for MySQL 5.6-compatible
13466
+ # Aurora, use the following command:
13043
13467
  #
13044
13468
  # `aws rds describe-db-engine-versions --engine aurora --query
13045
13469
  # "DBEngineVersions[].EngineVersion"`
13046
13470
  #
13047
- # To list all of the available engine versions for `aurora-mysql` (for
13048
- # MySQL 5.7-compatible Aurora), use the following command:
13471
+ # To list all of the available engine versions for MySQL 5.7-compatible
13472
+ # Aurora, use the following command:
13049
13473
  #
13050
13474
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
13051
13475
  # "DBEngineVersions[].EngineVersion"`
13052
13476
  #
13053
- # To list all of the available engine versions for `aurora-postgresql`,
13477
+ # To list all of the available engine versions for Aurora PostgreSQL,
13054
13478
  # use the following command:
13055
13479
  #
13056
13480
  # `aws rds describe-db-engine-versions --engine aurora-postgresql
13057
13481
  # --query "DBEngineVersions[].EngineVersion"`
13058
13482
  #
13483
+ # To list all of the available engine versions for RDS for MySQL, use
13484
+ # the following command:
13485
+ #
13486
+ # `aws rds describe-db-engine-versions --engine mysql --query
13487
+ # "DBEngineVersions[].EngineVersion"`
13488
+ #
13489
+ # To list all of the available engine versions for RDS for PostgreSQL,
13490
+ # use the following command:
13491
+ #
13492
+ # `aws rds describe-db-engine-versions --engine postgres --query
13493
+ # "DBEngineVersions[].EngineVersion"`
13494
+ #
13495
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
13496
+ #
13059
13497
  # @option params [Boolean] :allow_major_version_upgrade
13060
13498
  # A value that indicates whether major version upgrades are allowed.
13061
13499
  #
@@ -13063,6 +13501,8 @@ module Aws::RDS
13063
13501
  # value for the `EngineVersion` parameter that is a different major
13064
13502
  # version than the DB cluster's current version.
13065
13503
  #
13504
+ # Valid for: Aurora DB clusters only
13505
+ #
13066
13506
  # @option params [String] :db_instance_parameter_group_name
13067
13507
  # The name of the DB parameter group to apply to all instances of the DB
13068
13508
  # cluster.
@@ -13084,6 +13524,8 @@ module Aws::RDS
13084
13524
  # * The `DBInstanceParameterGroupName` parameter is only valid in
13085
13525
  # combination with the `AllowMajorVersionUpgrade` parameter.
13086
13526
  #
13527
+ # Valid for: Aurora DB clusters only
13528
+ #
13087
13529
  # @option params [String] :domain
13088
13530
  # The Active Directory directory ID to move the DB cluster to. Specify
13089
13531
  # `none` to remove the cluster from its current domain. The domain must
@@ -13092,6 +13534,8 @@ module Aws::RDS
13092
13534
  # For more information, see [Kerberos Authentication][1] in the *Amazon
13093
13535
  # Aurora User Guide*.
13094
13536
  #
13537
+ # Valid for: Aurora DB clusters only
13538
+ #
13095
13539
  #
13096
13540
  #
13097
13541
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/kerberos-authentication.html
@@ -13100,14 +13544,20 @@ module Aws::RDS
13100
13544
  # Specify the name of the IAM role to be used when making API calls to
13101
13545
  # the Directory Service.
13102
13546
  #
13547
+ # Valid for: Aurora DB clusters only
13548
+ #
13103
13549
  # @option params [Types::ScalingConfiguration] :scaling_configuration
13104
13550
  # The scaling properties of the DB cluster. You can only modify scaling
13105
13551
  # properties for DB clusters in `serverless` DB engine mode.
13106
13552
  #
13553
+ # Valid for: Aurora DB clusters only
13554
+ #
13107
13555
  # @option params [Boolean] :deletion_protection
13108
13556
  # A value that indicates whether the DB cluster has deletion protection
13109
13557
  # enabled. The database can't be deleted when deletion protection is
13110
- # enabled. By default, deletion protection is disabled.
13558
+ # enabled. By default, deletion protection isn't enabled.
13559
+ #
13560
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
13111
13561
  #
13112
13562
  # @option params [Boolean] :enable_http_endpoint
13113
13563
  # A value that indicates whether to enable the HTTP endpoint for an
@@ -13122,6 +13572,8 @@ module Aws::RDS
13122
13572
  # For more information, see [Using the Data API for Aurora
13123
13573
  # Serverless][1] in the *Amazon Aurora User Guide*.
13124
13574
  #
13575
+ # Valid for: Aurora DB clusters only
13576
+ #
13125
13577
  #
13126
13578
  #
13127
13579
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html
@@ -13130,6 +13582,8 @@ module Aws::RDS
13130
13582
  # A value that indicates whether to copy all tags from the DB cluster to
13131
13583
  # snapshots of the DB cluster. The default is not to copy them.
13132
13584
  #
13585
+ # Valid for: Aurora DB clusters only
13586
+ #
13133
13587
  # @option params [Boolean] :enable_global_write_forwarding
13134
13588
  # A value that indicates whether to enable this DB cluster to forward
13135
13589
  # write operations to the primary cluster of an Aurora global database
@@ -13145,6 +13599,129 @@ module Aws::RDS
13145
13599
  # immediately if the primary is demoted by the FailoverGlobalCluster API
13146
13600
  # operation, but it does nothing until then.
13147
13601
  #
13602
+ # Valid for: Aurora DB clusters only
13603
+ #
13604
+ # @option params [String] :db_cluster_instance_class
13605
+ # The compute and memory capacity of each DB instance in the Multi-AZ DB
13606
+ # cluster, for example db.m6g.xlarge. Not all DB instance classes are
13607
+ # available in all Amazon Web Services Regions, or for all database
13608
+ # engines.
13609
+ #
13610
+ # For the full list of DB instance classes and availability for your
13611
+ # engine, see [DB Instance Class][1] in the *Amazon RDS User Guide.*
13612
+ #
13613
+ # Valid for: Multi-AZ DB clusters only
13614
+ #
13615
+ #
13616
+ #
13617
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html
13618
+ #
13619
+ # @option params [Integer] :allocated_storage
13620
+ # The amount of storage in gibibytes (GiB) to allocate to each DB
13621
+ # instance in the Multi-AZ DB cluster.
13622
+ #
13623
+ # Type: Integer
13624
+ #
13625
+ # Valid for: Multi-AZ DB clusters only
13626
+ #
13627
+ # @option params [String] :storage_type
13628
+ # Specifies the storage type to be associated with the DB cluster.
13629
+ #
13630
+ # Valid values: `standard | gp2 | io1`
13631
+ #
13632
+ # If you specify `io1`, you must also include a value for the `Iops`
13633
+ # parameter.
13634
+ #
13635
+ # Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
13636
+ #
13637
+ # Valid for: Multi-AZ DB clusters only
13638
+ #
13639
+ # @option params [Integer] :iops
13640
+ # The amount of Provisioned IOPS (input/output operations per second) to
13641
+ # be initially allocated for each DB instance in the Multi-AZ DB
13642
+ # cluster.
13643
+ #
13644
+ # For information about valid Iops values, see [Amazon RDS Provisioned
13645
+ # IOPS Storage to Improve Performance][1] in the *Amazon RDS User
13646
+ # Guide*.
13647
+ #
13648
+ # Constraints: Must be a multiple between .5 and 50 of the storage
13649
+ # amount for the DB cluster.
13650
+ #
13651
+ # Valid for: Multi-AZ DB clusters only
13652
+ #
13653
+ #
13654
+ #
13655
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html#USER_PIOPS
13656
+ #
13657
+ # @option params [Boolean] :auto_minor_version_upgrade
13658
+ # A value that indicates whether minor engine upgrades are applied
13659
+ # automatically to the DB cluster during the maintenance window. By
13660
+ # default, minor engine upgrades are applied automatically.
13661
+ #
13662
+ # Valid for: Multi-AZ DB clusters only
13663
+ #
13664
+ # @option params [Integer] :monitoring_interval
13665
+ # The interval, in seconds, between points when Enhanced Monitoring
13666
+ # metrics are collected for the DB cluster. To turn off collecting
13667
+ # Enhanced Monitoring metrics, specify 0. The default is 0.
13668
+ #
13669
+ # If `MonitoringRoleArn` is specified, also set `MonitoringInterval` to
13670
+ # a value other than 0.
13671
+ #
13672
+ # Valid Values: `0, 1, 5, 10, 15, 30, 60`
13673
+ #
13674
+ # Valid for: Multi-AZ DB clusters only
13675
+ #
13676
+ # @option params [String] :monitoring_role_arn
13677
+ # The Amazon Resource Name (ARN) for the IAM role that permits RDS to
13678
+ # send Enhanced Monitoring metrics to Amazon CloudWatch Logs. An example
13679
+ # is `arn:aws:iam:123456789012:role/emaccess`. For information on
13680
+ # creating a monitoring role, see [To create an IAM role for Amazon RDS
13681
+ # Enhanced Monitoring][1] in the *Amazon RDS User Guide.*
13682
+ #
13683
+ # If `MonitoringInterval` is set to a value other than 0, supply a
13684
+ # `MonitoringRoleArn` value.
13685
+ #
13686
+ # Valid for: Multi-AZ DB clusters only
13687
+ #
13688
+ #
13689
+ #
13690
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.html#USER_Monitoring.OS.IAMRole
13691
+ #
13692
+ # @option params [Boolean] :enable_performance_insights
13693
+ # A value that indicates whether to turn on Performance Insights for the
13694
+ # DB cluster.
13695
+ #
13696
+ # For more information, see [ Using Amazon Performance Insights][1] in
13697
+ # the *Amazon RDS User Guide*.
13698
+ #
13699
+ # Valid for: Multi-AZ DB clusters only
13700
+ #
13701
+ #
13702
+ #
13703
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
13704
+ #
13705
+ # @option params [String] :performance_insights_kms_key_id
13706
+ # The Amazon Web Services KMS key identifier for encryption of
13707
+ # Performance Insights data.
13708
+ #
13709
+ # The Amazon Web Services KMS key identifier is the key ARN, key ID,
13710
+ # alias ARN, or alias name for the KMS key.
13711
+ #
13712
+ # If you don't specify a value for `PerformanceInsightsKMSKeyId`, then
13713
+ # Amazon RDS uses your default KMS key. There is a default KMS key for
13714
+ # your Amazon Web Services account. Your Amazon Web Services account has
13715
+ # a different default KMS key for each Amazon Web Services Region.
13716
+ #
13717
+ # Valid for: Multi-AZ DB clusters only
13718
+ #
13719
+ # @option params [Integer] :performance_insights_retention_period
13720
+ # The amount of time, in days, to retain Performance Insights data.
13721
+ # Valid values are 7 or 731 (2 years).
13722
+ #
13723
+ # Valid for: Multi-AZ DB clusters only
13724
+ #
13148
13725
  # @return [Types::ModifyDBClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
13149
13726
  #
13150
13727
  # * {Types::ModifyDBClusterResult#db_cluster #db_cluster} => Types::DBCluster
@@ -13206,6 +13783,16 @@ module Aws::RDS
13206
13783
  # enable_http_endpoint: false,
13207
13784
  # copy_tags_to_snapshot: false,
13208
13785
  # enable_global_write_forwarding: false,
13786
+ # db_cluster_instance_class: "String",
13787
+ # allocated_storage: 1,
13788
+ # storage_type: "String",
13789
+ # iops: 1,
13790
+ # auto_minor_version_upgrade: false,
13791
+ # monitoring_interval: 1,
13792
+ # monitoring_role_arn: "String",
13793
+ # enable_performance_insights: false,
13794
+ # performance_insights_kms_key_id: "String",
13795
+ # performance_insights_retention_period: 1,
13209
13796
  # })
13210
13797
  #
13211
13798
  # @example Response structure
@@ -13300,6 +13887,16 @@ module Aws::RDS
13300
13887
  # resp.db_cluster.pending_modified_values.master_user_password #=> String
13301
13888
  # resp.db_cluster.pending_modified_values.iam_database_authentication_enabled #=> Boolean
13302
13889
  # resp.db_cluster.pending_modified_values.engine_version #=> String
13890
+ # resp.db_cluster.db_cluster_instance_class #=> String
13891
+ # resp.db_cluster.storage_type #=> String
13892
+ # resp.db_cluster.iops #=> Integer
13893
+ # resp.db_cluster.publicly_accessible #=> Boolean
13894
+ # resp.db_cluster.auto_minor_version_upgrade #=> Boolean
13895
+ # resp.db_cluster.monitoring_interval #=> Integer
13896
+ # resp.db_cluster.monitoring_role_arn #=> String
13897
+ # resp.db_cluster.performance_insights_enabled #=> Boolean
13898
+ # resp.db_cluster.performance_insights_kms_key_id #=> String
13899
+ # resp.db_cluster.performance_insights_retention_period #=> Integer
13303
13900
  #
13304
13901
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBCluster AWS API Documentation
13305
13902
  #
@@ -13383,9 +13980,6 @@ module Aws::RDS
13383
13980
  # `ParameterName`, `ParameterValue`, and `ApplyMethod`. A maximum of 20
13384
13981
  # parameters can be modified in a single request.
13385
13982
  #
13386
- # For more information on Amazon Aurora, see [ What Is Amazon
13387
- # Aurora?][1] in the *Amazon Aurora User Guide.*
13388
- #
13389
13983
  # After you create a DB cluster parameter group, you should wait at
13390
13984
  # least 5 minutes before creating your first DB cluster that uses that
13391
13985
  # DB cluster parameter group as the default parameter group. This allows
@@ -13394,7 +13988,7 @@ module Aws::RDS
13394
13988
  # important for parameters that are critical when creating the default
13395
13989
  # database for a DB cluster, such as the character set for the default
13396
13990
  # database defined by the `character_set_database` parameter. You can
13397
- # use the *Parameter Groups* option of the [Amazon RDS console][2] or
13991
+ # use the *Parameter Groups* option of the [Amazon RDS console][1] or
13398
13992
  # the `DescribeDBClusterParameters` action to verify that your DB
13399
13993
  # cluster parameter group has been created or modified.
13400
13994
  #
@@ -13404,14 +13998,23 @@ module Aws::RDS
13404
13998
  # must reopen any connections and retry any transactions that were
13405
13999
  # active when the parameter changes took effect.
13406
14000
  #
13407
- # <note markdown="1"> This action only applies to Aurora DB clusters.
14001
+ # For more information on Amazon Aurora DB clusters, see [ What is
14002
+ # Amazon Aurora?][2] in the *Amazon Aurora User Guide.*
14003
+ #
14004
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
14005
+ # deployments with two readable standby DB instances][3] in the *Amazon
14006
+ # RDS User Guide.*
14007
+ #
14008
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
14009
+ # change.
13408
14010
  #
13409
14011
  # </note>
13410
14012
  #
13411
14013
  #
13412
14014
  #
13413
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
13414
- # [2]: https://console.aws.amazon.com/rds/
14015
+ # [1]: https://console.aws.amazon.com/rds/
14016
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
14017
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
13415
14018
  #
13416
14019
  # @option params [required, String] :db_cluster_parameter_group_name
13417
14020
  # The name of the DB cluster parameter group to modify.
@@ -13521,10 +14124,6 @@ module Aws::RDS
13521
14124
  # DescribeDBClusterSnapshotAttributes API action. The accounts are
13522
14125
  # returned as values for the `restore` attribute.
13523
14126
  #
13524
- # <note markdown="1"> This action only applies to Aurora DB clusters.
13525
- #
13526
- # </note>
13527
- #
13528
14127
  # @option params [required, String] :db_cluster_snapshot_identifier
13529
14128
  # The identifier for the DB cluster snapshot to modify the attributes
13530
14129
  # for.
@@ -13647,8 +14246,8 @@ module Aws::RDS
13647
14246
  # `CreateDBInstance`.
13648
14247
  #
13649
14248
  # @option params [String] :db_instance_class
13650
- # The new compute and memory capacity of the DB instance, for example,
13651
- # `db.m4.large`. Not all DB instance classes are available in all Amazon
14249
+ # The new compute and memory capacity of the DB instance, for example
14250
+ # db.m4.large. Not all DB instance classes are available in all Amazon
13652
14251
  # Web Services Regions, or for all database engines. For the full list
13653
14252
  # of DB instance classes, and availability for your engine, see [DB
13654
14253
  # Instance Class][1] in the *Amazon RDS User Guide*.
@@ -14160,12 +14759,13 @@ module Aws::RDS
14160
14759
  # @option params [Boolean] :publicly_accessible
14161
14760
  # A value that indicates whether the DB instance is publicly accessible.
14162
14761
  #
14163
- # When the DB instance is publicly accessible, its DNS endpoint resolves
14164
- # to the private IP address from within the DB instance's VPC, and to
14165
- # the public IP address from outside of the DB instance's VPC. Access
14166
- # to the DB instance is ultimately controlled by the security group it
14167
- # uses, and that public access is not permitted if the security group
14168
- # assigned to the DB instance doesn't permit it.
14762
+ # When the DB cluster is publicly accessible, its Domain Name System
14763
+ # (DNS) endpoint resolves to the private IP address from within the DB
14764
+ # cluster's virtual private cloud (VPC). It resolves to the public IP
14765
+ # address from outside of the DB cluster's VPC. Access to the DB
14766
+ # cluster is ultimately controlled by the security group it uses. That
14767
+ # public access isn't permitted if the security group assigned to the
14768
+ # DB cluster doesn't permit it.
14169
14769
  #
14170
14770
  # When the DB instance isn't publicly accessible, it is an internal DB
14171
14771
  # instance with a DNS name that resolves to a private IP address.
@@ -14220,7 +14820,7 @@ module Aws::RDS
14220
14820
  # @option params [Boolean] :enable_iam_database_authentication
14221
14821
  # A value that indicates whether to enable mapping of Amazon Web
14222
14822
  # Services Identity and Access Management (IAM) accounts to database
14223
- # accounts. By default, mapping is disabled.
14823
+ # accounts. By default, mapping isn't enabled.
14224
14824
  #
14225
14825
  # This setting doesn't apply to Amazon Aurora. Mapping Amazon Web
14226
14826
  # Services IAM accounts to database accounts is managed by the DB
@@ -14294,7 +14894,7 @@ module Aws::RDS
14294
14894
  # @option params [Boolean] :deletion_protection
14295
14895
  # A value that indicates whether the DB instance has deletion protection
14296
14896
  # enabled. The database can't be deleted when deletion protection is
14297
- # enabled. By default, deletion protection is disabled. For more
14897
+ # enabled. By default, deletion protection isn't enabled. For more
14298
14898
  # information, see [ Deleting a DB Instance][1].
14299
14899
  #
14300
14900
  #
@@ -14628,6 +15228,7 @@ module Aws::RDS
14628
15228
  # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
14629
15229
  # resp.db_instance.resume_full_automation_mode_time #=> Time
14630
15230
  # resp.db_instance.custom_iam_instance_profile #=> String
15231
+ # resp.db_instance.backup_target #=> String
14631
15232
  #
14632
15233
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBInstance AWS API Documentation
14633
15234
  #
@@ -15063,6 +15664,7 @@ module Aws::RDS
15063
15664
  # resp.db_snapshot.tag_list[0].key #=> String
15064
15665
  # resp.db_snapshot.tag_list[0].value #=> String
15065
15666
  # resp.db_snapshot.original_snapshot_create_time #=> Time
15667
+ # resp.db_snapshot.snapshot_target #=> String
15066
15668
  #
15067
15669
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBSnapshot AWS API Documentation
15068
15670
  #
@@ -15363,7 +15965,7 @@ module Aws::RDS
15363
15965
  # Modify a setting for an Amazon Aurora global cluster. You can change
15364
15966
  # one or more database configuration parameters by specifying these
15365
15967
  # parameters and the new values in the request. For more information on
15366
- # Amazon Aurora, see [ What Is Amazon Aurora?][1] in the *Amazon Aurora
15968
+ # Amazon Aurora, see [ What is Amazon Aurora?][1] in the *Amazon Aurora
15367
15969
  # User Guide.*
15368
15970
  #
15369
15971
  # <note markdown="1"> This action only applies to Aurora DB clusters.
@@ -15838,6 +16440,7 @@ module Aws::RDS
15838
16440
  # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
15839
16441
  # resp.db_instance.resume_full_automation_mode_time #=> Time
15840
16442
  # resp.db_instance.custom_iam_instance_profile #=> String
16443
+ # resp.db_instance.backup_target #=> String
15841
16444
  #
15842
16445
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PromoteReadReplica AWS API Documentation
15843
16446
  #
@@ -15850,10 +16453,6 @@ module Aws::RDS
15850
16453
 
15851
16454
  # Promotes a read replica DB cluster to a standalone DB cluster.
15852
16455
  #
15853
- # <note markdown="1"> This action only applies to Aurora DB clusters.
15854
- #
15855
- # </note>
15856
- #
15857
16456
  # @option params [required, String] :db_cluster_identifier
15858
16457
  # The identifier of the DB cluster read replica to promote. This
15859
16458
  # parameter isn't case-sensitive.
@@ -15968,6 +16567,16 @@ module Aws::RDS
15968
16567
  # resp.db_cluster.pending_modified_values.master_user_password #=> String
15969
16568
  # resp.db_cluster.pending_modified_values.iam_database_authentication_enabled #=> Boolean
15970
16569
  # resp.db_cluster.pending_modified_values.engine_version #=> String
16570
+ # resp.db_cluster.db_cluster_instance_class #=> String
16571
+ # resp.db_cluster.storage_type #=> String
16572
+ # resp.db_cluster.iops #=> Integer
16573
+ # resp.db_cluster.publicly_accessible #=> Boolean
16574
+ # resp.db_cluster.auto_minor_version_upgrade #=> Boolean
16575
+ # resp.db_cluster.monitoring_interval #=> Integer
16576
+ # resp.db_cluster.monitoring_role_arn #=> String
16577
+ # resp.db_cluster.performance_insights_enabled #=> Boolean
16578
+ # resp.db_cluster.performance_insights_kms_key_id #=> String
16579
+ # resp.db_cluster.performance_insights_retention_period #=> Integer
15971
16580
  #
15972
16581
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PromoteReadReplicaDBCluster AWS API Documentation
15973
16582
  #
@@ -16062,8 +16671,160 @@ module Aws::RDS
16062
16671
  #
16063
16672
  # @overload purchase_reserved_db_instances_offering(params = {})
16064
16673
  # @param [Hash] params ({})
16065
- def purchase_reserved_db_instances_offering(params = {}, options = {})
16066
- req = build_request(:purchase_reserved_db_instances_offering, params)
16674
+ def purchase_reserved_db_instances_offering(params = {}, options = {})
16675
+ req = build_request(:purchase_reserved_db_instances_offering, params)
16676
+ req.send_request(options)
16677
+ end
16678
+
16679
+ # You might need to reboot your DB cluster, usually for maintenance
16680
+ # reasons. For example, if you make certain modifications, or if you
16681
+ # change the DB cluster parameter group associated with the DB cluster,
16682
+ # reboot the DB cluster for the changes to take effect.
16683
+ #
16684
+ # Rebooting a DB cluster restarts the database engine service. Rebooting
16685
+ # a DB cluster results in a momentary outage, during which the DB
16686
+ # cluster status is set to rebooting.
16687
+ #
16688
+ # Use this operation only for a non-Aurora Multi-AZ DB cluster. The
16689
+ # Multi-AZ DB clusters feature is in preview and is subject to change.
16690
+ #
16691
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
16692
+ # deployments with two readable standby DB instances][1] in the *Amazon
16693
+ # RDS User Guide.*
16694
+ #
16695
+ #
16696
+ #
16697
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
16698
+ #
16699
+ # @option params [required, String] :db_cluster_identifier
16700
+ # The DB cluster identifier. This parameter is stored as a lowercase
16701
+ # string.
16702
+ #
16703
+ # Constraints:
16704
+ #
16705
+ # * Must match the identifier of an existing DBCluster.
16706
+ #
16707
+ # ^
16708
+ #
16709
+ # @return [Types::RebootDBClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
16710
+ #
16711
+ # * {Types::RebootDBClusterResult#db_cluster #db_cluster} => Types::DBCluster
16712
+ #
16713
+ # @example Request syntax with placeholder values
16714
+ #
16715
+ # resp = client.reboot_db_cluster({
16716
+ # db_cluster_identifier: "String", # required
16717
+ # })
16718
+ #
16719
+ # @example Response structure
16720
+ #
16721
+ # resp.db_cluster.allocated_storage #=> Integer
16722
+ # resp.db_cluster.availability_zones #=> Array
16723
+ # resp.db_cluster.availability_zones[0] #=> String
16724
+ # resp.db_cluster.backup_retention_period #=> Integer
16725
+ # resp.db_cluster.character_set_name #=> String
16726
+ # resp.db_cluster.database_name #=> String
16727
+ # resp.db_cluster.db_cluster_identifier #=> String
16728
+ # resp.db_cluster.db_cluster_parameter_group #=> String
16729
+ # resp.db_cluster.db_subnet_group #=> String
16730
+ # resp.db_cluster.status #=> String
16731
+ # resp.db_cluster.automatic_restart_time #=> Time
16732
+ # resp.db_cluster.percent_progress #=> String
16733
+ # resp.db_cluster.earliest_restorable_time #=> Time
16734
+ # resp.db_cluster.endpoint #=> String
16735
+ # resp.db_cluster.reader_endpoint #=> String
16736
+ # resp.db_cluster.custom_endpoints #=> Array
16737
+ # resp.db_cluster.custom_endpoints[0] #=> String
16738
+ # resp.db_cluster.multi_az #=> Boolean
16739
+ # resp.db_cluster.engine #=> String
16740
+ # resp.db_cluster.engine_version #=> String
16741
+ # resp.db_cluster.latest_restorable_time #=> Time
16742
+ # resp.db_cluster.port #=> Integer
16743
+ # resp.db_cluster.master_username #=> String
16744
+ # resp.db_cluster.db_cluster_option_group_memberships #=> Array
16745
+ # resp.db_cluster.db_cluster_option_group_memberships[0].db_cluster_option_group_name #=> String
16746
+ # resp.db_cluster.db_cluster_option_group_memberships[0].status #=> String
16747
+ # resp.db_cluster.preferred_backup_window #=> String
16748
+ # resp.db_cluster.preferred_maintenance_window #=> String
16749
+ # resp.db_cluster.replication_source_identifier #=> String
16750
+ # resp.db_cluster.read_replica_identifiers #=> Array
16751
+ # resp.db_cluster.read_replica_identifiers[0] #=> String
16752
+ # resp.db_cluster.db_cluster_members #=> Array
16753
+ # resp.db_cluster.db_cluster_members[0].db_instance_identifier #=> String
16754
+ # resp.db_cluster.db_cluster_members[0].is_cluster_writer #=> Boolean
16755
+ # resp.db_cluster.db_cluster_members[0].db_cluster_parameter_group_status #=> String
16756
+ # resp.db_cluster.db_cluster_members[0].promotion_tier #=> Integer
16757
+ # resp.db_cluster.vpc_security_groups #=> Array
16758
+ # resp.db_cluster.vpc_security_groups[0].vpc_security_group_id #=> String
16759
+ # resp.db_cluster.vpc_security_groups[0].status #=> String
16760
+ # resp.db_cluster.hosted_zone_id #=> String
16761
+ # resp.db_cluster.storage_encrypted #=> Boolean
16762
+ # resp.db_cluster.kms_key_id #=> String
16763
+ # resp.db_cluster.db_cluster_resource_id #=> String
16764
+ # resp.db_cluster.db_cluster_arn #=> String
16765
+ # resp.db_cluster.associated_roles #=> Array
16766
+ # resp.db_cluster.associated_roles[0].role_arn #=> String
16767
+ # resp.db_cluster.associated_roles[0].status #=> String
16768
+ # resp.db_cluster.associated_roles[0].feature_name #=> String
16769
+ # resp.db_cluster.iam_database_authentication_enabled #=> Boolean
16770
+ # resp.db_cluster.clone_group_id #=> String
16771
+ # resp.db_cluster.cluster_create_time #=> Time
16772
+ # resp.db_cluster.earliest_backtrack_time #=> Time
16773
+ # resp.db_cluster.backtrack_window #=> Integer
16774
+ # resp.db_cluster.backtrack_consumed_change_records #=> Integer
16775
+ # resp.db_cluster.enabled_cloudwatch_logs_exports #=> Array
16776
+ # resp.db_cluster.enabled_cloudwatch_logs_exports[0] #=> String
16777
+ # resp.db_cluster.capacity #=> Integer
16778
+ # resp.db_cluster.engine_mode #=> String
16779
+ # resp.db_cluster.scaling_configuration_info.min_capacity #=> Integer
16780
+ # resp.db_cluster.scaling_configuration_info.max_capacity #=> Integer
16781
+ # resp.db_cluster.scaling_configuration_info.auto_pause #=> Boolean
16782
+ # resp.db_cluster.scaling_configuration_info.seconds_until_auto_pause #=> Integer
16783
+ # resp.db_cluster.scaling_configuration_info.timeout_action #=> String
16784
+ # resp.db_cluster.scaling_configuration_info.seconds_before_timeout #=> Integer
16785
+ # resp.db_cluster.deletion_protection #=> Boolean
16786
+ # resp.db_cluster.http_endpoint_enabled #=> Boolean
16787
+ # resp.db_cluster.activity_stream_mode #=> String, one of "sync", "async"
16788
+ # resp.db_cluster.activity_stream_status #=> String, one of "stopped", "starting", "started", "stopping"
16789
+ # resp.db_cluster.activity_stream_kms_key_id #=> String
16790
+ # resp.db_cluster.activity_stream_kinesis_stream_name #=> String
16791
+ # resp.db_cluster.copy_tags_to_snapshot #=> Boolean
16792
+ # resp.db_cluster.cross_account_clone #=> Boolean
16793
+ # resp.db_cluster.domain_memberships #=> Array
16794
+ # resp.db_cluster.domain_memberships[0].domain #=> String
16795
+ # resp.db_cluster.domain_memberships[0].status #=> String
16796
+ # resp.db_cluster.domain_memberships[0].fqdn #=> String
16797
+ # resp.db_cluster.domain_memberships[0].iam_role_name #=> String
16798
+ # resp.db_cluster.tag_list #=> Array
16799
+ # resp.db_cluster.tag_list[0].key #=> String
16800
+ # resp.db_cluster.tag_list[0].value #=> String
16801
+ # resp.db_cluster.global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
16802
+ # resp.db_cluster.global_write_forwarding_requested #=> Boolean
16803
+ # resp.db_cluster.pending_modified_values.pending_cloudwatch_logs_exports.log_types_to_enable #=> Array
16804
+ # resp.db_cluster.pending_modified_values.pending_cloudwatch_logs_exports.log_types_to_enable[0] #=> String
16805
+ # resp.db_cluster.pending_modified_values.pending_cloudwatch_logs_exports.log_types_to_disable #=> Array
16806
+ # resp.db_cluster.pending_modified_values.pending_cloudwatch_logs_exports.log_types_to_disable[0] #=> String
16807
+ # resp.db_cluster.pending_modified_values.db_cluster_identifier #=> String
16808
+ # resp.db_cluster.pending_modified_values.master_user_password #=> String
16809
+ # resp.db_cluster.pending_modified_values.iam_database_authentication_enabled #=> Boolean
16810
+ # resp.db_cluster.pending_modified_values.engine_version #=> String
16811
+ # resp.db_cluster.db_cluster_instance_class #=> String
16812
+ # resp.db_cluster.storage_type #=> String
16813
+ # resp.db_cluster.iops #=> Integer
16814
+ # resp.db_cluster.publicly_accessible #=> Boolean
16815
+ # resp.db_cluster.auto_minor_version_upgrade #=> Boolean
16816
+ # resp.db_cluster.monitoring_interval #=> Integer
16817
+ # resp.db_cluster.monitoring_role_arn #=> String
16818
+ # resp.db_cluster.performance_insights_enabled #=> Boolean
16819
+ # resp.db_cluster.performance_insights_kms_key_id #=> String
16820
+ # resp.db_cluster.performance_insights_retention_period #=> Integer
16821
+ #
16822
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RebootDBCluster AWS API Documentation
16823
+ #
16824
+ # @overload reboot_db_cluster(params = {})
16825
+ # @param [Hash] params ({})
16826
+ def reboot_db_cluster(params = {}, options = {})
16827
+ req = build_request(:reboot_db_cluster, params)
16067
16828
  req.send_request(options)
16068
16829
  end
16069
16830
 
@@ -16266,6 +17027,7 @@ module Aws::RDS
16266
17027
  # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
16267
17028
  # resp.db_instance.resume_full_automation_mode_time #=> Time
16268
17029
  # resp.db_instance.custom_iam_instance_profile #=> String
17030
+ # resp.db_instance.backup_target #=> String
16269
17031
  #
16270
17032
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RebootDBInstance AWS API Documentation
16271
17033
  #
@@ -16331,7 +17093,7 @@ module Aws::RDS
16331
17093
  # Detaches an Aurora secondary cluster from an Aurora global database
16332
17094
  # cluster. The cluster becomes a standalone cluster with read-write
16333
17095
  # capability instead of being read-only and receiving data from a
16334
- # primary cluster in a different region.
17096
+ # primary cluster in a different Region.
16335
17097
  #
16336
17098
  # <note markdown="1"> This action only applies to Aurora DB clusters.
16337
17099
  #
@@ -16386,18 +17148,25 @@ module Aws::RDS
16386
17148
  req.send_request(options)
16387
17149
  end
16388
17150
 
16389
- # Disassociates an Amazon Web Services Identity and Access Management
16390
- # (IAM) role from an Amazon Aurora DB cluster. For more information, see
16391
- # [Authorizing Amazon Aurora MySQL to Access Other Amazon Web Services
16392
- # Services on Your Behalf ][1] in the *Amazon Aurora User Guide*.
17151
+ # Removes the asssociation of an Amazon Web Services Identity and Access
17152
+ # Management (IAM) role from a DB cluster.
16393
17153
  #
16394
- # <note markdown="1"> This action only applies to Aurora DB clusters.
17154
+ # For more information on Amazon Aurora DB clusters, see [ What is
17155
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
17156
+ #
17157
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
17158
+ # deployments with two readable standby DB instances][2] in the *Amazon
17159
+ # RDS User Guide.*
17160
+ #
17161
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
17162
+ # change.
16395
17163
  #
16396
17164
  # </note>
16397
17165
  #
16398
17166
  #
16399
17167
  #
16400
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Integrating.Authorizing.html
17168
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
17169
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
16401
17170
  #
16402
17171
  # @option params [required, String] :db_cluster_identifier
16403
17172
  # The name of the DB cluster to disassociate the IAM role from.
@@ -16593,16 +17362,22 @@ module Aws::RDS
16593
17362
  # You must call `RebootDBInstance` for every DB instance in your DB
16594
17363
  # cluster that you want the updated static parameter to apply to.
16595
17364
  #
16596
- # For more information on Amazon Aurora, see [ What Is Amazon
16597
- # Aurora?][1] in the *Amazon Aurora User Guide.*
17365
+ # For more information on Amazon Aurora DB clusters, see [ What is
17366
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
16598
17367
  #
16599
- # <note markdown="1"> This action only applies to Aurora DB clusters.
17368
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
17369
+ # deployments with two readable standby DB instances][2] in the *Amazon
17370
+ # RDS User Guide.*
17371
+ #
17372
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
17373
+ # change.
16600
17374
  #
16601
17375
  # </note>
16602
17376
  #
16603
17377
  #
16604
17378
  #
16605
17379
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
17380
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
16606
17381
  #
16607
17382
  # @option params [required, String] :db_cluster_parameter_group_name
16608
17383
  # The name of the DB cluster parameter group to reset.
@@ -16789,7 +17564,7 @@ module Aws::RDS
16789
17564
  #
16790
17565
  # </note>
16791
17566
  #
16792
- # For more information on Amazon Aurora, see [ What Is Amazon
17567
+ # For more information on Amazon Aurora, see [ What is Amazon
16793
17568
  # Aurora?][2] in the *Amazon Aurora User Guide.*
16794
17569
  #
16795
17570
  # <note markdown="1"> This action only applies to Aurora DB clusters. The source DB engine
@@ -17004,7 +17779,7 @@ module Aws::RDS
17004
17779
  # @option params [Boolean] :enable_iam_database_authentication
17005
17780
  # A value that indicates whether to enable mapping of Amazon Web
17006
17781
  # Services Identity and Access Management (IAM) accounts to database
17007
- # accounts. By default, mapping is disabled.
17782
+ # accounts. By default, mapping isn't enabled.
17008
17783
  #
17009
17784
  # For more information, see [ IAM Database Authentication][1] in the
17010
17785
  # *Amazon Aurora User Guide.*
@@ -17071,7 +17846,7 @@ module Aws::RDS
17071
17846
  # @option params [Boolean] :deletion_protection
17072
17847
  # A value that indicates whether the DB cluster has deletion protection
17073
17848
  # enabled. The database can't be deleted when deletion protection is
17074
- # enabled. By default, deletion protection is disabled.
17849
+ # enabled. By default, deletion protection isn't enabled.
17075
17850
  #
17076
17851
  # @option params [Boolean] :copy_tags_to_snapshot
17077
17852
  # A value that indicates whether to copy all tags from the restored DB
@@ -17232,6 +18007,16 @@ module Aws::RDS
17232
18007
  # resp.db_cluster.pending_modified_values.master_user_password #=> String
17233
18008
  # resp.db_cluster.pending_modified_values.iam_database_authentication_enabled #=> Boolean
17234
18009
  # resp.db_cluster.pending_modified_values.engine_version #=> String
18010
+ # resp.db_cluster.db_cluster_instance_class #=> String
18011
+ # resp.db_cluster.storage_type #=> String
18012
+ # resp.db_cluster.iops #=> Integer
18013
+ # resp.db_cluster.publicly_accessible #=> Boolean
18014
+ # resp.db_cluster.auto_minor_version_upgrade #=> Boolean
18015
+ # resp.db_cluster.monitoring_interval #=> Integer
18016
+ # resp.db_cluster.monitoring_role_arn #=> String
18017
+ # resp.db_cluster.performance_insights_enabled #=> Boolean
18018
+ # resp.db_cluster.performance_insights_kms_key_id #=> String
18019
+ # resp.db_cluster.performance_insights_retention_period #=> Integer
17235
18020
  #
17236
18021
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBClusterFromS3 AWS API Documentation
17237
18022
  #
@@ -17243,7 +18028,6 @@ module Aws::RDS
17243
18028
  end
17244
18029
 
17245
18030
  # Creates a new DB cluster from a DB snapshot or DB cluster snapshot.
17246
- # This action only applies to Aurora DB clusters.
17247
18031
  #
17248
18032
  # The target DB cluster is created from the source snapshot with a
17249
18033
  # default configuration. If you don't specify a security group, the new
@@ -17258,21 +18042,29 @@ module Aws::RDS
17258
18042
  #
17259
18043
  # </note>
17260
18044
  #
17261
- # For more information on Amazon Aurora, see [ What Is Amazon
17262
- # Aurora?][1] in the *Amazon Aurora User Guide.*
18045
+ # For more information on Amazon Aurora DB clusters, see [ What is
18046
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
17263
18047
  #
17264
- # <note markdown="1"> This action only applies to Aurora DB clusters.
18048
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
18049
+ # deployments with two readable standby DB instances][2] in the *Amazon
18050
+ # RDS User Guide.*
18051
+ #
18052
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
18053
+ # change.
17265
18054
  #
17266
18055
  # </note>
17267
18056
  #
17268
18057
  #
17269
18058
  #
17270
18059
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
18060
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
17271
18061
  #
17272
18062
  # @option params [Array<String>] :availability_zones
17273
18063
  # Provides the list of Availability Zones (AZs) where instances in the
17274
18064
  # restored DB cluster can be created.
17275
18065
  #
18066
+ # Valid for: Aurora DB clusters only
18067
+ #
17276
18068
  # @option params [required, String] :db_cluster_identifier
17277
18069
  # The name of the DB cluster to create from the DB snapshot or DB
17278
18070
  # cluster snapshot. This parameter isn't case-sensitive.
@@ -17287,6 +18079,8 @@ module Aws::RDS
17287
18079
  #
17288
18080
  # Example: `my-snapshot-id`
17289
18081
  #
18082
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18083
+ #
17290
18084
  # @option params [required, String] :snapshot_identifier
17291
18085
  # The identifier for the DB snapshot or DB cluster snapshot to restore
17292
18086
  # from.
@@ -17301,6 +18095,8 @@ module Aws::RDS
17301
18095
  #
17302
18096
  # ^
17303
18097
  #
18098
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18099
+ #
17304
18100
  # @option params [required, String] :engine
17305
18101
  # The database engine to use for the new DB cluster.
17306
18102
  #
@@ -17308,40 +18104,68 @@ module Aws::RDS
17308
18104
  #
17309
18105
  # Constraint: Must be compatible with the engine of the source
17310
18106
  #
18107
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18108
+ #
17311
18109
  # @option params [String] :engine_version
17312
18110
  # The version of the database engine to use for the new DB cluster.
17313
18111
  #
17314
- # To list all of the available engine versions for `aurora` (for MySQL
17315
- # 5.6-compatible Aurora), use the following command:
18112
+ # To list all of the available engine versions for MySQL 5.6-compatible
18113
+ # Aurora, use the following command:
17316
18114
  #
17317
18115
  # `aws rds describe-db-engine-versions --engine aurora --query
17318
18116
  # "DBEngineVersions[].EngineVersion"`
17319
18117
  #
17320
- # To list all of the available engine versions for `aurora-mysql` (for
17321
- # MySQL 5.7-compatible Aurora), use the following command:
18118
+ # To list all of the available engine versions for MySQL 5.7-compatible
18119
+ # Aurora, use the following command:
17322
18120
  #
17323
18121
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
17324
18122
  # "DBEngineVersions[].EngineVersion"`
17325
18123
  #
17326
- # To list all of the available engine versions for `aurora-postgresql`,
18124
+ # To list all of the available engine versions for Aurora PostgreSQL,
17327
18125
  # use the following command:
17328
18126
  #
17329
18127
  # `aws rds describe-db-engine-versions --engine aurora-postgresql
17330
18128
  # --query "DBEngineVersions[].EngineVersion"`
17331
18129
  #
17332
- # <note markdown="1"> If you aren't using the default engine version, then you must specify
17333
- # the engine version.
18130
+ # To list all of the available engine versions for RDS for MySQL, use
18131
+ # the following command:
17334
18132
  #
17335
- # </note>
18133
+ # `aws rds describe-db-engine-versions --engine mysql --query
18134
+ # "DBEngineVersions[].EngineVersion"`
18135
+ #
18136
+ # To list all of the available engine versions for RDS for PostgreSQL,
18137
+ # use the following command:
18138
+ #
18139
+ # `aws rds describe-db-engine-versions --engine postgres --query
18140
+ # "DBEngineVersions[].EngineVersion"`
17336
18141
  #
17337
18142
  # **Aurora MySQL**
17338
18143
  #
17339
- # Example: `5.6.10a`, `5.6.mysql_aurora.1.19.2`, `5.7.12`,
17340
- # `5.7.mysql_aurora.2.04.5`
18144
+ # See [MySQL on Amazon RDS Versions][1] in the *Amazon Aurora User
18145
+ # Guide.*
17341
18146
  #
17342
18147
  # **Aurora PostgreSQL**
17343
18148
  #
17344
- # Example: `9.6.3`, `10.7`
18149
+ # See [Amazon Aurora PostgreSQL releases and engine versions][2] in the
18150
+ # *Amazon Aurora User Guide.*
18151
+ #
18152
+ # **MySQL**
18153
+ #
18154
+ # See [MySQL on Amazon RDS Versions][3] in the *Amazon RDS User Guide.*
18155
+ #
18156
+ # **PostgreSQL**
18157
+ #
18158
+ # See [Amazon RDS for PostgreSQL versions and extensions][4] in the
18159
+ # *Amazon RDS User Guide.*
18160
+ #
18161
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18162
+ #
18163
+ #
18164
+ #
18165
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Updates.html
18166
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Updates.20180305.html
18167
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
18168
+ # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
17345
18169
  #
17346
18170
  # @option params [Integer] :port
17347
18171
  # The port number on which the new DB cluster accepts connections.
@@ -17350,6 +18174,8 @@ module Aws::RDS
17350
18174
  #
17351
18175
  # Default: The same port as the original DB cluster.
17352
18176
  #
18177
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18178
+ #
17353
18179
  # @option params [String] :db_subnet_group_name
17354
18180
  # The name of the DB subnet group to use for the new DB cluster.
17355
18181
  #
@@ -17358,18 +18184,29 @@ module Aws::RDS
17358
18184
  #
17359
18185
  # Example: `mySubnetgroup`
17360
18186
  #
18187
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18188
+ #
17361
18189
  # @option params [String] :database_name
17362
18190
  # The database name for the restored DB cluster.
17363
18191
  #
18192
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18193
+ #
17364
18194
  # @option params [String] :option_group_name
17365
18195
  # The name of the option group to use for the restored DB cluster.
17366
18196
  #
18197
+ # DB clusters are associated with a default option group that can't be
18198
+ # modified.
18199
+ #
17367
18200
  # @option params [Array<String>] :vpc_security_group_ids
17368
18201
  # A list of VPC security groups that the new DB cluster will belong to.
17369
18202
  #
18203
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18204
+ #
17370
18205
  # @option params [Array<Types::Tag>] :tags
17371
18206
  # The tags to be assigned to the restored DB cluster.
17372
18207
  #
18208
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18209
+ #
17373
18210
  # @option params [String] :kms_key_id
17374
18211
  # The Amazon Web Services KMS key identifier to use when restoring an
17375
18212
  # encrypted DB cluster from a DB snapshot or DB cluster snapshot.
@@ -17389,14 +18226,18 @@ module Aws::RDS
17389
18226
  # * If the DB snapshot or DB cluster snapshot in `SnapshotIdentifier`
17390
18227
  # isn't encrypted, then the restored DB cluster isn't encrypted.
17391
18228
  #
18229
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18230
+ #
17392
18231
  # @option params [Boolean] :enable_iam_database_authentication
17393
18232
  # A value that indicates whether to enable mapping of Amazon Web
17394
18233
  # Services Identity and Access Management (IAM) accounts to database
17395
- # accounts. By default, mapping is disabled.
18234
+ # accounts. By default, mapping isn't enabled.
17396
18235
  #
17397
18236
  # For more information, see [ IAM Database Authentication][1] in the
17398
18237
  # *Amazon Aurora User Guide.*
17399
18238
  #
18239
+ # Valid for: Aurora DB clusters only
18240
+ #
17400
18241
  #
17401
18242
  #
17402
18243
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.html
@@ -17418,12 +18259,18 @@ module Aws::RDS
17418
18259
  #
17419
18260
  # ^
17420
18261
  #
18262
+ # Valid for: Aurora DB clusters only
18263
+ #
17421
18264
  # @option params [Array<String>] :enable_cloudwatch_logs_exports
17422
18265
  # The list of logs that the restored DB cluster is to export to Amazon
17423
18266
  # CloudWatch Logs. The values in the list depend on the DB engine being
17424
- # used. For more information, see [Publishing Database Logs to Amazon
18267
+ # used.
18268
+ #
18269
+ # For more information, see [Publishing Database Logs to Amazon
17425
18270
  # CloudWatch Logs ][1] in the *Amazon Aurora User Guide*.
17426
18271
  #
18272
+ # Valid for: Aurora DB clusters only
18273
+ #
17427
18274
  #
17428
18275
  #
17429
18276
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
@@ -17434,6 +18281,8 @@ module Aws::RDS
17434
18281
  #
17435
18282
  # For more information, see [ CreateDBCluster][1].
17436
18283
  #
18284
+ # Valid for: Aurora DB clusters only
18285
+ #
17437
18286
  #
17438
18287
  #
17439
18288
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html
@@ -17442,6 +18291,8 @@ module Aws::RDS
17442
18291
  # For DB clusters in `serverless` DB engine mode, the scaling properties
17443
18292
  # of the DB cluster.
17444
18293
  #
18294
+ # Valid for: Aurora DB clusters only
18295
+ #
17445
18296
  # @option params [String] :db_cluster_parameter_group_name
17446
18297
  # The name of the DB cluster parameter group to associate with this DB
17447
18298
  # cluster. If this argument is omitted, the default DB cluster parameter
@@ -17458,16 +18309,22 @@ module Aws::RDS
17458
18309
  #
17459
18310
  # * Can't end with a hyphen or contain two consecutive hyphens.
17460
18311
  #
18312
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18313
+ #
17461
18314
  # @option params [Boolean] :deletion_protection
17462
18315
  # A value that indicates whether the DB cluster has deletion protection
17463
18316
  # enabled. The database can't be deleted when deletion protection is
17464
- # enabled. By default, deletion protection is disabled.
18317
+ # enabled. By default, deletion protection isn't enabled.
18318
+ #
18319
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
17465
18320
  #
17466
18321
  # @option params [Boolean] :copy_tags_to_snapshot
17467
18322
  # A value that indicates whether to copy all tags from the restored DB
17468
18323
  # cluster to snapshots of the restored DB cluster. The default is not to
17469
18324
  # copy them.
17470
18325
  #
18326
+ # Valid for: Aurora DB clusters only
18327
+ #
17471
18328
  # @option params [String] :domain
17472
18329
  # Specify the Active Directory directory ID to restore the DB cluster
17473
18330
  # in. The domain must be created prior to this operation. Currently,
@@ -17477,6 +18334,8 @@ module Aws::RDS
17477
18334
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
17478
18335
  # RDS User Guide*.
17479
18336
  #
18337
+ # Valid for: Aurora DB clusters only
18338
+ #
17480
18339
  #
17481
18340
  #
17482
18341
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
@@ -17485,6 +18344,91 @@ module Aws::RDS
17485
18344
  # Specify the name of the IAM role to be used when making API calls to
17486
18345
  # the Directory Service.
17487
18346
  #
18347
+ # Valid for: Aurora DB clusters only
18348
+ #
18349
+ # @option params [String] :db_cluster_instance_class
18350
+ # The compute and memory capacity of the each DB instance in the
18351
+ # Multi-AZ DB cluster, for example db.m6g.xlarge. Not all DB instance
18352
+ # classes are available in all Amazon Web Services Regions, or for all
18353
+ # database engines.
18354
+ #
18355
+ # For the full list of DB instance classes, and availability for your
18356
+ # engine, see [DB Instance Class][1] in the *Amazon RDS User Guide.*
18357
+ #
18358
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18359
+ #
18360
+ #
18361
+ #
18362
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html
18363
+ #
18364
+ # @option params [String] :storage_type
18365
+ # Specifies the storage type to be associated with the each DB instance
18366
+ # in the Multi-AZ DB cluster.
18367
+ #
18368
+ # Valid values: `standard | gp2 | io1`
18369
+ #
18370
+ # If you specify `io1`, you must also include a value for the `Iops`
18371
+ # parameter.
18372
+ #
18373
+ # Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
18374
+ #
18375
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18376
+ #
18377
+ # @option params [Integer] :iops
18378
+ # The amount of Provisioned IOPS (input/output operations per second) to
18379
+ # be initially allocated for each DB instance in the Multi-AZ DB
18380
+ # cluster.
18381
+ #
18382
+ # For information about valid Iops values, see [Amazon RDS Provisioned
18383
+ # IOPS Storage to Improve Performance][1] in the *Amazon RDS User
18384
+ # Guide*.
18385
+ #
18386
+ # Constraints: Must be a multiple between .5 and 50 of the storage
18387
+ # amount for the DB instance.
18388
+ #
18389
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18390
+ #
18391
+ #
18392
+ #
18393
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html#USER_PIOPS
18394
+ #
18395
+ # @option params [Boolean] :publicly_accessible
18396
+ # A value that indicates whether the DB cluster is publicly accessible.
18397
+ #
18398
+ # When the DB cluster is publicly accessible, its Domain Name System
18399
+ # (DNS) endpoint resolves to the private IP address from within the DB
18400
+ # cluster's virtual private cloud (VPC). It resolves to the public IP
18401
+ # address from outside of the DB cluster's VPC. Access to the DB
18402
+ # cluster is ultimately controlled by the security group it uses. That
18403
+ # public access is not permitted if the security group assigned to the
18404
+ # DB cluster doesn't permit it.
18405
+ #
18406
+ # When the DB cluster isn't publicly accessible, it is an internal DB
18407
+ # cluster with a DNS name that resolves to a private IP address.
18408
+ #
18409
+ # Default: The default behavior varies depending on whether
18410
+ # `DBSubnetGroupName` is specified.
18411
+ #
18412
+ # If `DBSubnetGroupName` isn't specified, and `PubliclyAccessible`
18413
+ # isn't specified, the following applies:
18414
+ #
18415
+ # * If the default VPC in the target Region doesn’t have an internet
18416
+ # gateway attached to it, the DB cluster is private.
18417
+ #
18418
+ # * If the default VPC in the target Region has an internet gateway
18419
+ # attached to it, the DB cluster is public.
18420
+ #
18421
+ # If `DBSubnetGroupName` is specified, and `PubliclyAccessible` isn't
18422
+ # specified, the following applies:
18423
+ #
18424
+ # * If the subnets are part of a VPC that doesn’t have an internet
18425
+ # gateway attached to it, the DB cluster is private.
18426
+ #
18427
+ # * If the subnets are part of a VPC that has an internet gateway
18428
+ # attached to it, the DB cluster is public.
18429
+ #
18430
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18431
+ #
17488
18432
  # @return [Types::RestoreDBClusterFromSnapshotResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
17489
18433
  #
17490
18434
  # * {Types::RestoreDBClusterFromSnapshotResult#db_cluster #db_cluster} => Types::DBCluster
@@ -17543,6 +18487,10 @@ module Aws::RDS
17543
18487
  # copy_tags_to_snapshot: false,
17544
18488
  # domain: "String",
17545
18489
  # domain_iam_role_name: "String",
18490
+ # db_cluster_instance_class: "String",
18491
+ # storage_type: "String",
18492
+ # iops: 1,
18493
+ # publicly_accessible: false,
17546
18494
  # })
17547
18495
  #
17548
18496
  # @example Response structure
@@ -17637,6 +18585,16 @@ module Aws::RDS
17637
18585
  # resp.db_cluster.pending_modified_values.master_user_password #=> String
17638
18586
  # resp.db_cluster.pending_modified_values.iam_database_authentication_enabled #=> Boolean
17639
18587
  # resp.db_cluster.pending_modified_values.engine_version #=> String
18588
+ # resp.db_cluster.db_cluster_instance_class #=> String
18589
+ # resp.db_cluster.storage_type #=> String
18590
+ # resp.db_cluster.iops #=> Integer
18591
+ # resp.db_cluster.publicly_accessible #=> Boolean
18592
+ # resp.db_cluster.auto_minor_version_upgrade #=> Boolean
18593
+ # resp.db_cluster.monitoring_interval #=> Integer
18594
+ # resp.db_cluster.monitoring_role_arn #=> String
18595
+ # resp.db_cluster.performance_insights_enabled #=> Boolean
18596
+ # resp.db_cluster.performance_insights_kms_key_id #=> String
18597
+ # resp.db_cluster.performance_insights_retention_period #=> Integer
17640
18598
  #
17641
18599
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBClusterFromSnapshot AWS API Documentation
17642
18600
  #
@@ -17654,25 +18612,32 @@ module Aws::RDS
17654
18612
  # cluster, except that the new DB cluster is created with the default DB
17655
18613
  # security group.
17656
18614
  #
17657
- # <note markdown="1"> This action only restores the DB cluster, not the DB instances for
17658
- # that DB cluster. You must invoke the `CreateDBInstance` action to
17659
- # create DB instances for the restored DB cluster, specifying the
17660
- # identifier of the restored DB cluster in `DBClusterIdentifier`. You
17661
- # can create DB instances only after the `RestoreDBClusterToPointInTime`
17662
- # action has completed and the DB cluster is available.
18615
+ # <note markdown="1"> For Aurora, this action only restores the DB cluster, not the DB
18616
+ # instances for that DB cluster. You must invoke the `CreateDBInstance`
18617
+ # action to create DB instances for the restored DB cluster, specifying
18618
+ # the identifier of the restored DB cluster in `DBClusterIdentifier`.
18619
+ # You can create DB instances only after the
18620
+ # `RestoreDBClusterToPointInTime` action has completed and the DB
18621
+ # cluster is available.
17663
18622
  #
17664
18623
  # </note>
17665
18624
  #
17666
- # For more information on Amazon Aurora, see [ What Is Amazon
17667
- # Aurora?][1] in the *Amazon Aurora User Guide.*
18625
+ # For more information on Amazon Aurora DB clusters, see [ What is
18626
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
17668
18627
  #
17669
- # <note markdown="1"> This action only applies to Aurora DB clusters.
18628
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
18629
+ # deployments with two readable standby DB instances][2] in the *Amazon
18630
+ # RDS User Guide.*
18631
+ #
18632
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
18633
+ # change.
17670
18634
  #
17671
18635
  # </note>
17672
18636
  #
17673
18637
  #
17674
18638
  #
17675
18639
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
18640
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
17676
18641
  #
17677
18642
  # @option params [required, String] :db_cluster_identifier
17678
18643
  # The name of the new DB cluster to be created.
@@ -17685,6 +18650,8 @@ module Aws::RDS
17685
18650
  #
17686
18651
  # * Can't end with a hyphen or contain two consecutive hyphens
17687
18652
  #
18653
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18654
+ #
17688
18655
  # @option params [String] :restore_type
17689
18656
  # The type of restore to be performed. You can specify one of the
17690
18657
  # following values:
@@ -17701,6 +18668,8 @@ module Aws::RDS
17701
18668
  # If you don't specify a `RestoreType` value, then the new DB cluster
17702
18669
  # is restored as a full copy of the source DB cluster.
17703
18670
  #
18671
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18672
+ #
17704
18673
  # @option params [required, String] :source_db_cluster_identifier
17705
18674
  # The identifier of the source DB cluster from which to restore.
17706
18675
  #
@@ -17710,6 +18679,8 @@ module Aws::RDS
17710
18679
  #
17711
18680
  # ^
17712
18681
  #
18682
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18683
+ #
17713
18684
  # @option params [Time,DateTime,Date,Integer,String] :restore_to_time
17714
18685
  # The date and time to restore the DB cluster to.
17715
18686
  #
@@ -17731,6 +18702,8 @@ module Aws::RDS
17731
18702
  #
17732
18703
  # Example: `2015-03-07T23:45:00Z`
17733
18704
  #
18705
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18706
+ #
17734
18707
  # @option params [Boolean] :use_latest_restorable_time
17735
18708
  # A value that indicates whether to restore the DB cluster to the latest
17736
18709
  # restorable backup time. By default, the DB cluster isn't restored to
@@ -17739,6 +18712,8 @@ module Aws::RDS
17739
18712
  # Constraints: Can't be specified if `RestoreToTime` parameter is
17740
18713
  # provided.
17741
18714
  #
18715
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18716
+ #
17742
18717
  # @option params [Integer] :port
17743
18718
  # The port number on which the new DB cluster accepts connections.
17744
18719
  #
@@ -17746,6 +18721,8 @@ module Aws::RDS
17746
18721
  #
17747
18722
  # Default: The default port for the engine.
17748
18723
  #
18724
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18725
+ #
17749
18726
  # @option params [String] :db_subnet_group_name
17750
18727
  # The DB subnet group name to use for the new DB cluster.
17751
18728
  #
@@ -17754,12 +18731,19 @@ module Aws::RDS
17754
18731
  #
17755
18732
  # Example: `mySubnetgroup`
17756
18733
  #
18734
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18735
+ #
17757
18736
  # @option params [String] :option_group_name
17758
18737
  # The name of the option group for the new DB cluster.
17759
18738
  #
18739
+ # DB clusters are associated with a default option group that can't be
18740
+ # modified.
18741
+ #
17760
18742
  # @option params [Array<String>] :vpc_security_group_ids
17761
18743
  # A list of VPC security groups that the new DB cluster belongs to.
17762
18744
  #
18745
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18746
+ #
17763
18747
  # @option params [Array<Types::Tag>] :tags
17764
18748
  # A list of tags. For more information, see [Tagging Amazon RDS
17765
18749
  # Resources][1] in the *Amazon RDS User Guide.*
@@ -17795,14 +18779,18 @@ module Aws::RDS
17795
18779
  # If `DBClusterIdentifier` refers to a DB cluster that isn't encrypted,
17796
18780
  # then the restore request is rejected.
17797
18781
  #
18782
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18783
+ #
17798
18784
  # @option params [Boolean] :enable_iam_database_authentication
17799
18785
  # A value that indicates whether to enable mapping of Amazon Web
17800
18786
  # Services Identity and Access Management (IAM) accounts to database
17801
- # accounts. By default, mapping is disabled.
18787
+ # accounts. By default, mapping isn't enabled.
17802
18788
  #
17803
18789
  # For more information, see [ IAM Database Authentication][1] in the
17804
18790
  # *Amazon Aurora User Guide.*
17805
18791
  #
18792
+ # Valid for: Aurora DB clusters only
18793
+ #
17806
18794
  #
17807
18795
  #
17808
18796
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.html
@@ -17811,10 +18799,6 @@ module Aws::RDS
17811
18799
  # The target backtrack window, in seconds. To disable backtracking, set
17812
18800
  # this value to 0.
17813
18801
  #
17814
- # <note markdown="1"> Currently, Backtrack is only supported for Aurora MySQL DB clusters.
17815
- #
17816
- # </note>
17817
- #
17818
18802
  # Default: 0
17819
18803
  #
17820
18804
  # Constraints:
@@ -17824,12 +18808,18 @@ module Aws::RDS
17824
18808
  #
17825
18809
  # ^
17826
18810
  #
18811
+ # Valid for: Aurora MySQL DB clusters only
18812
+ #
17827
18813
  # @option params [Array<String>] :enable_cloudwatch_logs_exports
17828
18814
  # The list of logs that the restored DB cluster is to export to
17829
18815
  # CloudWatch Logs. The values in the list depend on the DB engine being
17830
- # used. For more information, see [Publishing Database Logs to Amazon
18816
+ # used.
18817
+ #
18818
+ # For more information, see [Publishing Database Logs to Amazon
17831
18819
  # CloudWatch Logs][1] in the *Amazon Aurora User Guide*.
17832
18820
  #
18821
+ # Valid for: Aurora DB clusters only
18822
+ #
17833
18823
  #
17834
18824
  #
17835
18825
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
@@ -17850,16 +18840,22 @@ module Aws::RDS
17850
18840
  #
17851
18841
  # * Can't end with a hyphen or contain two consecutive hyphens.
17852
18842
  #
18843
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18844
+ #
17853
18845
  # @option params [Boolean] :deletion_protection
17854
18846
  # A value that indicates whether the DB cluster has deletion protection
17855
18847
  # enabled. The database can't be deleted when deletion protection is
17856
- # enabled. By default, deletion protection is disabled.
18848
+ # enabled. By default, deletion protection isn't enabled.
18849
+ #
18850
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
17857
18851
  #
17858
18852
  # @option params [Boolean] :copy_tags_to_snapshot
17859
18853
  # A value that indicates whether to copy all tags from the restored DB
17860
18854
  # cluster to snapshots of the restored DB cluster. The default is not to
17861
18855
  # copy them.
17862
18856
  #
18857
+ # Valid for: Aurora DB clusters only
18858
+ #
17863
18859
  # @option params [String] :domain
17864
18860
  # Specify the Active Directory directory ID to restore the DB cluster
17865
18861
  # in. The domain must be created prior to this operation.
@@ -17869,6 +18865,8 @@ module Aws::RDS
17869
18865
  # For more information, see [Kerberos Authentication][1] in the *Amazon
17870
18866
  # Aurora User Guide*.
17871
18867
  #
18868
+ # Valid for: Aurora DB clusters only
18869
+ #
17872
18870
  #
17873
18871
  #
17874
18872
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/kerberos-authentication.html
@@ -17877,10 +18875,14 @@ module Aws::RDS
17877
18875
  # Specify the name of the IAM role to be used when making API calls to
17878
18876
  # the Directory Service.
17879
18877
  #
18878
+ # Valid for: Aurora DB clusters only
18879
+ #
17880
18880
  # @option params [Types::ScalingConfiguration] :scaling_configuration
17881
18881
  # For DB clusters in `serverless` DB engine mode, the scaling properties
17882
18882
  # of the DB cluster.
17883
18883
  #
18884
+ # Valid for: Aurora DB clusters only
18885
+ #
17884
18886
  # @option params [String] :engine_mode
17885
18887
  # The engine mode of the new cluster. Specify `provisioned` or
17886
18888
  # `serverless`, depending on the type of the cluster you are creating.
@@ -17889,6 +18891,90 @@ module Aws::RDS
17889
18891
  # clone that is an Aurora Serverless cluster, the original cluster must
17890
18892
  # be an Aurora Serverless cluster or an encrypted provisioned cluster.
17891
18893
  #
18894
+ # Valid for: Aurora DB clusters only
18895
+ #
18896
+ # @option params [String] :db_cluster_instance_class
18897
+ # The compute and memory capacity of the each DB instance in the
18898
+ # Multi-AZ DB cluster, for example db.m6g.xlarge. Not all DB instance
18899
+ # classes are available in all Amazon Web Services Regions, or for all
18900
+ # database engines.
18901
+ #
18902
+ # For the full list of DB instance classes, and availability for your
18903
+ # engine, see [DB instance class][1] in the *Amazon RDS User Guide.*
18904
+ #
18905
+ # Valid for: Multi-AZ DB clusters only
18906
+ #
18907
+ #
18908
+ #
18909
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html
18910
+ #
18911
+ # @option params [String] :storage_type
18912
+ # Specifies the storage type to be associated with the each DB instance
18913
+ # in the Multi-AZ DB cluster.
18914
+ #
18915
+ # Valid values: `standard | gp2 | io1`
18916
+ #
18917
+ # If you specify `io1`, also include a value for the `Iops` parameter.
18918
+ #
18919
+ # Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
18920
+ #
18921
+ # Valid for: Multi-AZ DB clusters only
18922
+ #
18923
+ # @option params [Boolean] :publicly_accessible
18924
+ # A value that indicates whether the DB cluster is publicly accessible.
18925
+ #
18926
+ # When the DB cluster is publicly accessible, its Domain Name System
18927
+ # (DNS) endpoint resolves to the private IP address from within the DB
18928
+ # cluster's virtual private cloud (VPC). It resolves to the public IP
18929
+ # address from outside of the DB cluster's VPC. Access to the DB
18930
+ # cluster is ultimately controlled by the security group it uses. That
18931
+ # public access is not permitted if the security group assigned to the
18932
+ # DB cluster doesn't permit it.
18933
+ #
18934
+ # When the DB cluster isn't publicly accessible, it is an internal DB
18935
+ # cluster with a DNS name that resolves to a private IP address.
18936
+ #
18937
+ # Default: The default behavior varies depending on whether
18938
+ # `DBSubnetGroupName` is specified.
18939
+ #
18940
+ # If `DBSubnetGroupName` isn't specified, and `PubliclyAccessible`
18941
+ # isn't specified, the following applies:
18942
+ #
18943
+ # * If the default VPC in the target Region doesn’t have an internet
18944
+ # gateway attached to it, the DB cluster is private.
18945
+ #
18946
+ # * If the default VPC in the target Region has an internet gateway
18947
+ # attached to it, the DB cluster is public.
18948
+ #
18949
+ # If `DBSubnetGroupName` is specified, and `PubliclyAccessible` isn't
18950
+ # specified, the following applies:
18951
+ #
18952
+ # * If the subnets are part of a VPC that doesn’t have an internet
18953
+ # gateway attached to it, the DB cluster is private.
18954
+ #
18955
+ # * If the subnets are part of a VPC that has an internet gateway
18956
+ # attached to it, the DB cluster is public.
18957
+ #
18958
+ # Valid for: Multi-AZ DB clusters only
18959
+ #
18960
+ # @option params [Integer] :iops
18961
+ # The amount of Provisioned IOPS (input/output operations per second) to
18962
+ # be initially allocated for each DB instance in the Multi-AZ DB
18963
+ # cluster.
18964
+ #
18965
+ # For information about valid `Iops` values, see [Amazon RDS Provisioned
18966
+ # IOPS storage to improve performance][1] in the *Amazon RDS User
18967
+ # Guide*.
18968
+ #
18969
+ # Constraints: Must be a multiple between .5 and 50 of the storage
18970
+ # amount for the DB instance.
18971
+ #
18972
+ # Valid for: Multi-AZ DB clusters only
18973
+ #
18974
+ #
18975
+ #
18976
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html#USER_PIOPS
18977
+ #
17892
18978
  # @return [Types::RestoreDBClusterToPointInTimeResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
17893
18979
  #
17894
18980
  # * {Types::RestoreDBClusterToPointInTimeResult#db_cluster #db_cluster} => Types::DBCluster
@@ -17946,6 +19032,10 @@ module Aws::RDS
17946
19032
  # seconds_before_timeout: 1,
17947
19033
  # },
17948
19034
  # engine_mode: "String",
19035
+ # db_cluster_instance_class: "String",
19036
+ # storage_type: "String",
19037
+ # publicly_accessible: false,
19038
+ # iops: 1,
17949
19039
  # })
17950
19040
  #
17951
19041
  # @example Response structure
@@ -18040,6 +19130,16 @@ module Aws::RDS
18040
19130
  # resp.db_cluster.pending_modified_values.master_user_password #=> String
18041
19131
  # resp.db_cluster.pending_modified_values.iam_database_authentication_enabled #=> Boolean
18042
19132
  # resp.db_cluster.pending_modified_values.engine_version #=> String
19133
+ # resp.db_cluster.db_cluster_instance_class #=> String
19134
+ # resp.db_cluster.storage_type #=> String
19135
+ # resp.db_cluster.iops #=> Integer
19136
+ # resp.db_cluster.publicly_accessible #=> Boolean
19137
+ # resp.db_cluster.auto_minor_version_upgrade #=> Boolean
19138
+ # resp.db_cluster.monitoring_interval #=> Integer
19139
+ # resp.db_cluster.monitoring_role_arn #=> String
19140
+ # resp.db_cluster.performance_insights_enabled #=> Boolean
19141
+ # resp.db_cluster.performance_insights_kms_key_id #=> String
19142
+ # resp.db_cluster.performance_insights_retention_period #=> Integer
18043
19143
  #
18044
19144
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBClusterToPointInTime AWS API Documentation
18045
19145
  #
@@ -18103,10 +19203,10 @@ module Aws::RDS
18103
19203
  #
18104
19204
  # @option params [String] :db_instance_class
18105
19205
  # The compute and memory capacity of the Amazon RDS DB instance, for
18106
- # example, `db.m4.large`. Not all DB instance classes are available in
18107
- # all Amazon Web Services Regions, or for all database engines. For the
18108
- # full list of DB instance classes, and availability for your engine,
18109
- # see [DB Instance Class][1] in the *Amazon RDS User Guide.*
19206
+ # example db.m4.large. Not all DB instance classes are available in all
19207
+ # Amazon Web Services Regions, or for all database engines. For the full
19208
+ # list of DB instance classes, and availability for your engine, see [DB
19209
+ # Instance Class][1] in the *Amazon RDS User Guide.*
18110
19210
  #
18111
19211
  # Default: The same DBInstanceClass as the original DB instance.
18112
19212
  #
@@ -18151,12 +19251,13 @@ module Aws::RDS
18151
19251
  # @option params [Boolean] :publicly_accessible
18152
19252
  # A value that indicates whether the DB instance is publicly accessible.
18153
19253
  #
18154
- # When the DB instance is publicly accessible, its DNS endpoint resolves
18155
- # to the private IP address from within the DB instance's VPC, and to
18156
- # the public IP address from outside of the DB instance's VPC. Access
18157
- # to the DB instance is ultimately controlled by the security group it
18158
- # uses, and that public access is not permitted if the security group
18159
- # assigned to the DB instance doesn't permit it.
19254
+ # When the DB instance is publicly accessible, its Domain Name System
19255
+ # (DNS) endpoint resolves to the private IP address from within the DB
19256
+ # instance's virtual private cloud (VPC). It resolves to the public IP
19257
+ # address from outside of the DB instance's VPC. Access to the DB
19258
+ # instance is ultimately controlled by the security group it uses. That
19259
+ # public access is not permitted if the security group assigned to the
19260
+ # DB instance doesn't permit it.
18160
19261
  #
18161
19262
  # When the DB instance isn't publicly accessible, it is an internal DB
18162
19263
  # instance with a DNS name that resolves to a private IP address.
@@ -18372,7 +19473,7 @@ module Aws::RDS
18372
19473
  # @option params [Boolean] :deletion_protection
18373
19474
  # A value that indicates whether the DB instance has deletion protection
18374
19475
  # enabled. The database can't be deleted when deletion protection is
18375
- # enabled. By default, deletion protection is disabled. For more
19476
+ # enabled. By default, deletion protection isn't enabled. For more
18376
19477
  # information, see [ Deleting a DB Instance][1].
18377
19478
  #
18378
19479
  #
@@ -18425,6 +19526,20 @@ module Aws::RDS
18425
19526
  #
18426
19527
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
18427
19528
  #
19529
+ # @option params [String] :backup_target
19530
+ # Specifies where automated backups and manual snapshots are stored for
19531
+ # the restored DB instance.
19532
+ #
19533
+ # Possible values are `outposts` (Amazon Web Services Outposts) and
19534
+ # `region` (Amazon Web Services Region). The default is `region`.
19535
+ #
19536
+ # For more information, see [Working with Amazon RDS on Amazon Web
19537
+ # Services Outposts][1] in the *Amazon RDS User Guide*.
19538
+ #
19539
+ #
19540
+ #
19541
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
19542
+ #
18428
19543
  # @return [Types::RestoreDBInstanceFromDBSnapshotResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
18429
19544
  #
18430
19545
  # * {Types::RestoreDBInstanceFromDBSnapshotResult#db_instance #db_instance} => Types::DBInstance
@@ -18567,6 +19682,7 @@ module Aws::RDS
18567
19682
  # deletion_protection: false,
18568
19683
  # enable_customer_owned_ip: false,
18569
19684
  # custom_iam_instance_profile: "String",
19685
+ # backup_target: "String",
18570
19686
  # })
18571
19687
  #
18572
19688
  # @example Response structure
@@ -18706,6 +19822,7 @@ module Aws::RDS
18706
19822
  # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
18707
19823
  # resp.db_instance.resume_full_automation_mode_time #=> Time
18708
19824
  # resp.db_instance.custom_iam_instance_profile #=> String
19825
+ # resp.db_instance.backup_target #=> String
18709
19826
  #
18710
19827
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromDBSnapshot AWS API Documentation
18711
19828
  #
@@ -18758,8 +19875,8 @@ module Aws::RDS
18758
19875
  # </note>
18759
19876
  #
18760
19877
  # @option params [required, String] :db_instance_class
18761
- # The compute and memory capacity of the DB instance, for example,
18762
- # `db.m4.large`. Not all DB instance classes are available in all Amazon
19878
+ # The compute and memory capacity of the DB instance, for example
19879
+ # db.m4.large. Not all DB instance classes are available in all Amazon
18763
19880
  # Web Services Regions, or for all database engines. For the full list
18764
19881
  # of DB instance classes, and availability for your engine, see [DB
18765
19882
  # Instance Class][1] in the *Amazon RDS User Guide.*
@@ -18920,12 +20037,13 @@ module Aws::RDS
18920
20037
  # @option params [Boolean] :publicly_accessible
18921
20038
  # A value that indicates whether the DB instance is publicly accessible.
18922
20039
  #
18923
- # When the DB instance is publicly accessible, its DNS endpoint resolves
18924
- # to the private IP address from within the DB instance's VPC, and to
18925
- # the public IP address from outside of the DB instance's VPC. Access
18926
- # to the DB instance is ultimately controlled by the security group it
18927
- # uses, and that public access is not permitted if the security group
18928
- # assigned to the DB instance doesn't permit it.
20040
+ # When the DB instance is publicly accessible, its Domain Name System
20041
+ # (DNS) endpoint resolves to the private IP address from within the DB
20042
+ # instance's virtual private cloud (VPC). It resolves to the public IP
20043
+ # address from outside of the DB instance's VPC. Access to the DB
20044
+ # instance is ultimately controlled by the security group it uses. That
20045
+ # public access is not permitted if the security group assigned to the
20046
+ # DB instance doesn't permit it.
18929
20047
  #
18930
20048
  # When the DB instance isn't publicly accessible, it is an internal DB
18931
20049
  # instance with a DNS name that resolves to a private IP address.
@@ -19003,7 +20121,7 @@ module Aws::RDS
19003
20121
  # @option params [Boolean] :enable_iam_database_authentication
19004
20122
  # A value that indicates whether to enable mapping of Amazon Web
19005
20123
  # Services Identity and Access Management (IAM) accounts to database
19006
- # accounts. By default, mapping is disabled.
20124
+ # accounts. By default, mapping isn't enabled.
19007
20125
  #
19008
20126
  # For more information about IAM database authentication, see [ IAM
19009
20127
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
@@ -19084,7 +20202,7 @@ module Aws::RDS
19084
20202
  # @option params [Boolean] :deletion_protection
19085
20203
  # A value that indicates whether the DB instance has deletion protection
19086
20204
  # enabled. The database can't be deleted when deletion protection is
19087
- # enabled. By default, deletion protection is disabled. For more
20205
+ # enabled. By default, deletion protection isn't enabled. For more
19088
20206
  # information, see [ Deleting a DB Instance][1].
19089
20207
  #
19090
20208
  #
@@ -19303,6 +20421,7 @@ module Aws::RDS
19303
20421
  # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
19304
20422
  # resp.db_instance.resume_full_automation_mode_time #=> Time
19305
20423
  # resp.db_instance.custom_iam_instance_profile #=> String
20424
+ # resp.db_instance.backup_target #=> String
19306
20425
  #
19307
20426
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromS3 AWS API Documentation
19308
20427
  #
@@ -19377,10 +20496,10 @@ module Aws::RDS
19377
20496
  #
19378
20497
  # @option params [String] :db_instance_class
19379
20498
  # The compute and memory capacity of the Amazon RDS DB instance, for
19380
- # example, `db.m4.large`. Not all DB instance classes are available in
19381
- # all Amazon Web Services Regions, or for all database engines. For the
19382
- # full list of DB instance classes, and availability for your engine,
19383
- # see [DB Instance Class][1] in the *Amazon RDS User Guide.*
20499
+ # example db.m4.large. Not all DB instance classes are available in all
20500
+ # Amazon Web Services Regions, or for all database engines. For the full
20501
+ # list of DB instance classes, and availability for your engine, see [DB
20502
+ # Instance Class][1] in the *Amazon RDS User Guide.*
19384
20503
  #
19385
20504
  # Default: The same DBInstanceClass as the original DB instance.
19386
20505
  #
@@ -19425,12 +20544,13 @@ module Aws::RDS
19425
20544
  # @option params [Boolean] :publicly_accessible
19426
20545
  # A value that indicates whether the DB instance is publicly accessible.
19427
20546
  #
19428
- # When the DB instance is publicly accessible, its DNS endpoint resolves
19429
- # to the private IP address from within the DB instance's VPC, and to
19430
- # the public IP address from outside of the DB instance's VPC. Access
19431
- # to the DB instance is ultimately controlled by the security group it
19432
- # uses, and that public access is not permitted if the security group
19433
- # assigned to the DB instance doesn't permit it.
20547
+ # When the DB cluster is publicly accessible, its Domain Name System
20548
+ # (DNS) endpoint resolves to the private IP address from within the DB
20549
+ # cluster's virtual private cloud (VPC). It resolves to the public IP
20550
+ # address from outside of the DB cluster's VPC. Access to the DB
20551
+ # cluster is ultimately controlled by the security group it uses. That
20552
+ # public access isn't permitted if the security group assigned to the
20553
+ # DB cluster doesn't permit it.
19434
20554
  #
19435
20555
  # When the DB instance isn't publicly accessible, it is an internal DB
19436
20556
  # instance with a DNS name that resolves to a private IP address.
@@ -19580,7 +20700,7 @@ module Aws::RDS
19580
20700
  # @option params [Boolean] :enable_iam_database_authentication
19581
20701
  # A value that indicates whether to enable mapping of Amazon Web
19582
20702
  # Services Identity and Access Management (IAM) accounts to database
19583
- # accounts. By default, mapping is disabled.
20703
+ # accounts. By default, mapping isn't enabled.
19584
20704
  #
19585
20705
  # This setting doesn't apply to RDS Custom.
19586
20706
  #
@@ -19637,7 +20757,7 @@ module Aws::RDS
19637
20757
  # @option params [Boolean] :deletion_protection
19638
20758
  # A value that indicates whether the DB instance has deletion protection
19639
20759
  # enabled. The database can't be deleted when deletion protection is
19640
- # enabled. By default, deletion protection is disabled. For more
20760
+ # enabled. By default, deletion protection isn't enabled. For more
19641
20761
  # information, see [ Deleting a DB Instance][1].
19642
20762
  #
19643
20763
  #
@@ -19714,6 +20834,20 @@ module Aws::RDS
19714
20834
  #
19715
20835
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
19716
20836
  #
20837
+ # @option params [String] :backup_target
20838
+ # Specifies where automated backups and manual snapshots are stored for
20839
+ # the restored DB instance.
20840
+ #
20841
+ # Possible values are `outposts` (Amazon Web Services Outposts) and
20842
+ # `region` (Amazon Web Services Region). The default is `region`.
20843
+ #
20844
+ # For more information, see [Working with Amazon RDS on Amazon Web
20845
+ # Services Outposts][1] in the *Amazon RDS User Guide*.
20846
+ #
20847
+ #
20848
+ #
20849
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
20850
+ #
19717
20851
  # @return [Types::RestoreDBInstanceToPointInTimeResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
19718
20852
  #
19719
20853
  # * {Types::RestoreDBInstanceToPointInTimeResult#db_instance #db_instance} => Types::DBInstance
@@ -19862,6 +20996,7 @@ module Aws::RDS
19862
20996
  # source_db_instance_automated_backups_arn: "String",
19863
20997
  # enable_customer_owned_ip: false,
19864
20998
  # custom_iam_instance_profile: "String",
20999
+ # backup_target: "String",
19865
21000
  # })
19866
21001
  #
19867
21002
  # @example Response structure
@@ -20001,6 +21136,7 @@ module Aws::RDS
20001
21136
  # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
20002
21137
  # resp.db_instance.resume_full_automation_mode_time #=> Time
20003
21138
  # resp.db_instance.custom_iam_instance_profile #=> String
21139
+ # resp.db_instance.backup_target #=> String
20004
21140
  #
20005
21141
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceToPointInTime AWS API Documentation
20006
21142
  #
@@ -20292,6 +21428,16 @@ module Aws::RDS
20292
21428
  # resp.db_cluster.pending_modified_values.master_user_password #=> String
20293
21429
  # resp.db_cluster.pending_modified_values.iam_database_authentication_enabled #=> Boolean
20294
21430
  # resp.db_cluster.pending_modified_values.engine_version #=> String
21431
+ # resp.db_cluster.db_cluster_instance_class #=> String
21432
+ # resp.db_cluster.storage_type #=> String
21433
+ # resp.db_cluster.iops #=> Integer
21434
+ # resp.db_cluster.publicly_accessible #=> Boolean
21435
+ # resp.db_cluster.auto_minor_version_upgrade #=> Boolean
21436
+ # resp.db_cluster.monitoring_interval #=> Integer
21437
+ # resp.db_cluster.monitoring_role_arn #=> String
21438
+ # resp.db_cluster.performance_insights_enabled #=> Boolean
21439
+ # resp.db_cluster.performance_insights_kms_key_id #=> String
21440
+ # resp.db_cluster.performance_insights_retention_period #=> Integer
20295
21441
  #
20296
21442
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StartDBCluster AWS API Documentation
20297
21443
  #
@@ -20468,6 +21614,7 @@ module Aws::RDS
20468
21614
  # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
20469
21615
  # resp.db_instance.resume_full_automation_mode_time #=> Time
20470
21616
  # resp.db_instance.custom_iam_instance_profile #=> String
21617
+ # resp.db_instance.backup_target #=> String
20471
21618
  #
20472
21619
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StartDBInstance AWS API Documentation
20473
21620
  #
@@ -20562,6 +21709,7 @@ module Aws::RDS
20562
21709
  # resp.db_instance_automated_backup.db_instance_automated_backups_arn #=> String
20563
21710
  # resp.db_instance_automated_backup.db_instance_automated_backups_replications #=> Array
20564
21711
  # resp.db_instance_automated_backup.db_instance_automated_backups_replications[0].db_instance_automated_backups_arn #=> String
21712
+ # resp.db_instance_automated_backup.backup_target #=> String
20565
21713
  #
20566
21714
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StartDBInstanceAutomatedBackupsReplication AWS API Documentation
20567
21715
  #
@@ -20870,6 +22018,16 @@ module Aws::RDS
20870
22018
  # resp.db_cluster.pending_modified_values.master_user_password #=> String
20871
22019
  # resp.db_cluster.pending_modified_values.iam_database_authentication_enabled #=> Boolean
20872
22020
  # resp.db_cluster.pending_modified_values.engine_version #=> String
22021
+ # resp.db_cluster.db_cluster_instance_class #=> String
22022
+ # resp.db_cluster.storage_type #=> String
22023
+ # resp.db_cluster.iops #=> Integer
22024
+ # resp.db_cluster.publicly_accessible #=> Boolean
22025
+ # resp.db_cluster.auto_minor_version_upgrade #=> Boolean
22026
+ # resp.db_cluster.monitoring_interval #=> Integer
22027
+ # resp.db_cluster.monitoring_role_arn #=> String
22028
+ # resp.db_cluster.performance_insights_enabled #=> Boolean
22029
+ # resp.db_cluster.performance_insights_kms_key_id #=> String
22030
+ # resp.db_cluster.performance_insights_retention_period #=> Integer
20873
22031
  #
20874
22032
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StopDBCluster AWS API Documentation
20875
22033
  #
@@ -21053,6 +22211,7 @@ module Aws::RDS
21053
22211
  # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
21054
22212
  # resp.db_instance.resume_full_automation_mode_time #=> Time
21055
22213
  # resp.db_instance.custom_iam_instance_profile #=> String
22214
+ # resp.db_instance.backup_target #=> String
21056
22215
  #
21057
22216
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StopDBInstance AWS API Documentation
21058
22217
  #
@@ -21119,6 +22278,7 @@ module Aws::RDS
21119
22278
  # resp.db_instance_automated_backup.db_instance_automated_backups_arn #=> String
21120
22279
  # resp.db_instance_automated_backup.db_instance_automated_backups_replications #=> Array
21121
22280
  # resp.db_instance_automated_backup.db_instance_automated_backups_replications[0].db_instance_automated_backups_arn #=> String
22281
+ # resp.db_instance_automated_backup.backup_target #=> String
21122
22282
  #
21123
22283
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StopDBInstanceAutomatedBackupsReplication AWS API Documentation
21124
22284
  #
@@ -21142,7 +22302,7 @@ module Aws::RDS
21142
22302
  params: params,
21143
22303
  config: config)
21144
22304
  context[:gem_name] = 'aws-sdk-rds'
21145
- context[:gem_version] = '1.130.0'
22305
+ context[:gem_version] = '1.134.0'
21146
22306
  Seahorse::Client::Request.new(handlers, context)
21147
22307
  end
21148
22308