aws-sdk-rds 1.129.0 → 1.133.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -158,7 +158,7 @@ module Aws::RDS
158
158
  #
159
159
  # @!attribute [rw] role_arn
160
160
  # The Amazon Resource Name (ARN) of the IAM role to associate with the
161
- # Aurora DB cluster, for example,
161
+ # Aurora DB cluster, for example
162
162
  # `arn:aws:iam::123456789012:role/AuroraAccessRole`.
163
163
  # @return [String]
164
164
  #
@@ -1830,7 +1830,7 @@ module Aws::RDS
1830
1830
  # @return [String]
1831
1831
  #
1832
1832
  # @!attribute [rw] endpoint_type
1833
- # The type of the endpoint. One of: `READER`, `WRITER`, `ANY`.
1833
+ # The type of the endpoint, one of: `READER`, `WRITER`, `ANY`.
1834
1834
  # @return [String]
1835
1835
  #
1836
1836
  # @!attribute [rw] static_members
@@ -1841,8 +1841,8 @@ module Aws::RDS
1841
1841
  # @!attribute [rw] excluded_members
1842
1842
  # List of DB instance identifiers that aren't part of the custom
1843
1843
  # endpoint group. All other eligible instances are reachable through
1844
- # the custom endpoint. Only relevant if the list of static members is
1845
- # empty.
1844
+ # the custom endpoint. This parameter is relevant only if the list of
1845
+ # static members is empty.
1846
1846
  # @return [Array<String>]
1847
1847
  #
1848
1848
  # @!attribute [rw] tags
@@ -1911,14 +1911,29 @@ module Aws::RDS
1911
1911
  # domain: "String",
1912
1912
  # domain_iam_role_name: "String",
1913
1913
  # enable_global_write_forwarding: false,
1914
+ # db_cluster_instance_class: "String",
1915
+ # allocated_storage: 1,
1916
+ # storage_type: "String",
1917
+ # iops: 1,
1918
+ # publicly_accessible: false,
1919
+ # auto_minor_version_upgrade: false,
1920
+ # monitoring_interval: 1,
1921
+ # monitoring_role_arn: "String",
1922
+ # enable_performance_insights: false,
1923
+ # performance_insights_kms_key_id: "String",
1924
+ # performance_insights_retention_period: 1,
1914
1925
  # source_region: "String",
1915
1926
  # }
1916
1927
  #
1917
1928
  # @!attribute [rw] availability_zones
1918
- # A list of Availability Zones (AZs) where instances in the DB cluster
1919
- # can be created. For information on Amazon Web Services Regions and
1920
- # Availability Zones, see [Choosing the Regions and Availability
1921
- # Zones][1] in the *Amazon Aurora User Guide*.
1929
+ # A list of Availability Zones (AZs) where DB instances in the DB
1930
+ # cluster can be created.
1931
+ #
1932
+ # For information on Amazon Web Services Regions and Availability
1933
+ # Zones, see [Choosing the Regions and Availability Zones][1] in the
1934
+ # *Amazon Aurora User Guide*.
1935
+ #
1936
+ # Valid for: Aurora DB clusters only
1922
1937
  #
1923
1938
  #
1924
1939
  #
@@ -1935,17 +1950,23 @@ module Aws::RDS
1935
1950
  # * Must be a value from 1 to 35
1936
1951
  #
1937
1952
  # ^
1953
+ #
1954
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
1938
1955
  # @return [Integer]
1939
1956
  #
1940
1957
  # @!attribute [rw] character_set_name
1941
1958
  # A value that indicates that the DB cluster should be associated with
1942
1959
  # the specified CharacterSet.
1960
+ #
1961
+ # Valid for: Aurora DB clusters only
1943
1962
  # @return [String]
1944
1963
  #
1945
1964
  # @!attribute [rw] database_name
1946
1965
  # The name for your database of up to 64 alphanumeric characters. If
1947
1966
  # you do not provide a name, Amazon RDS doesn't create a database in
1948
1967
  # the DB cluster you are creating.
1968
+ #
1969
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
1949
1970
  # @return [String]
1950
1971
  #
1951
1972
  # @!attribute [rw] db_cluster_identifier
@@ -1961,6 +1982,8 @@ module Aws::RDS
1961
1982
  # * Can't end with a hyphen or contain two consecutive hyphens.
1962
1983
  #
1963
1984
  # Example: `my-cluster1`
1985
+ #
1986
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
1964
1987
  # @return [String]
1965
1988
  #
1966
1989
  # @!attribute [rw] db_cluster_parameter_group_name
@@ -1974,66 +1997,127 @@ module Aws::RDS
1974
1997
  # parameter group.
1975
1998
  #
1976
1999
  # ^
2000
+ #
2001
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
1977
2002
  # @return [String]
1978
2003
  #
1979
2004
  # @!attribute [rw] vpc_security_group_ids
1980
2005
  # A list of EC2 VPC security groups to associate with this DB cluster.
2006
+ #
2007
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
1981
2008
  # @return [Array<String>]
1982
2009
  #
1983
2010
  # @!attribute [rw] db_subnet_group_name
1984
2011
  # A DB subnet group to associate with this DB cluster.
1985
2012
  #
2013
+ # This setting is required to create a Multi-AZ DB cluster.
2014
+ #
1986
2015
  # Constraints: Must match the name of an existing DBSubnetGroup. Must
1987
2016
  # not be default.
1988
2017
  #
1989
2018
  # Example: `mySubnetgroup`
2019
+ #
2020
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
1990
2021
  # @return [String]
1991
2022
  #
1992
2023
  # @!attribute [rw] engine
1993
2024
  # The name of the database engine to be used for this DB cluster.
1994
2025
  #
1995
- # Valid Values: `aurora` (for MySQL 5.6-compatible Aurora),
1996
- # `aurora-mysql` (for MySQL 5.7-compatible Aurora), and
1997
- # `aurora-postgresql`
2026
+ # Valid Values:
2027
+ #
2028
+ # * `aurora` (for MySQL 5.6-compatible Aurora)
2029
+ #
2030
+ # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
2031
+ #
2032
+ # * `aurora-postgresql`
2033
+ #
2034
+ # * `mysql`
2035
+ #
2036
+ # * `postgres`
2037
+ #
2038
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
1998
2039
  # @return [String]
1999
2040
  #
2000
2041
  # @!attribute [rw] engine_version
2001
2042
  # The version number of the database engine to use.
2002
2043
  #
2003
- # To list all of the available engine versions for `aurora` (for MySQL
2004
- # 5.6-compatible Aurora), use the following command:
2044
+ # To list all of the available engine versions for MySQL
2045
+ # 5.6-compatible Aurora, use the following command:
2005
2046
  #
2006
2047
  # `aws rds describe-db-engine-versions --engine aurora --query
2007
2048
  # "DBEngineVersions[].EngineVersion"`
2008
2049
  #
2009
- # To list all of the available engine versions for `aurora-mysql` (for
2010
- # MySQL 5.7-compatible Aurora), use the following command:
2050
+ # To list all of the available engine versions for MySQL
2051
+ # 5.7-compatible Aurora, use the following command:
2011
2052
  #
2012
2053
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
2013
2054
  # "DBEngineVersions[].EngineVersion"`
2014
2055
  #
2015
- # To list all of the available engine versions for
2016
- # `aurora-postgresql`, use the following command:
2056
+ # To list all of the available engine versions for Aurora PostgreSQL,
2057
+ # use the following command:
2017
2058
  #
2018
2059
  # `aws rds describe-db-engine-versions --engine aurora-postgresql
2019
2060
  # --query "DBEngineVersions[].EngineVersion"`
2020
2061
  #
2062
+ # To list all of the available engine versions for RDS for MySQL, use
2063
+ # the following command:
2064
+ #
2065
+ # `aws rds describe-db-engine-versions --engine mysql --query
2066
+ # "DBEngineVersions[].EngineVersion"`
2067
+ #
2068
+ # To list all of the available engine versions for RDS for PostgreSQL,
2069
+ # use the following command:
2070
+ #
2071
+ # `aws rds describe-db-engine-versions --engine postgres --query
2072
+ # "DBEngineVersions[].EngineVersion"`
2073
+ #
2021
2074
  # **Aurora MySQL**
2022
2075
  #
2023
- # Example: `5.6.10a`, `5.6.mysql_aurora.1.19.2`, `5.7.12`,
2024
- # `5.7.mysql_aurora.2.04.5`
2076
+ # For information, see [MySQL on Amazon RDS Versions][1] in the
2077
+ # *Amazon Aurora User Guide.*
2025
2078
  #
2026
2079
  # **Aurora PostgreSQL**
2027
2080
  #
2028
- # Example: `9.6.3`, `10.7`
2081
+ # For information, see [Amazon Aurora PostgreSQL releases and engine
2082
+ # versions][2] in the *Amazon Aurora User Guide.*
2083
+ #
2084
+ # **MySQL**
2085
+ #
2086
+ # For information, see [MySQL on Amazon RDS Versions][3] in the
2087
+ # *Amazon RDS User Guide.*
2088
+ #
2089
+ # **PostgreSQL**
2090
+ #
2091
+ # For information, see [Amazon RDS for PostgreSQL versions and
2092
+ # extensions][4] in the *Amazon RDS User Guide.*
2093
+ #
2094
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2095
+ #
2096
+ #
2097
+ #
2098
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Updates.html
2099
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Updates.20180305.html
2100
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
2101
+ # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
2029
2102
  # @return [String]
2030
2103
  #
2031
2104
  # @!attribute [rw] port
2032
2105
  # The port number on which the instances in the DB cluster accept
2033
2106
  # connections.
2034
2107
  #
2035
- # Default: `3306` if engine is set as aurora or `5432` if set to
2036
- # aurora-postgresql.
2108
+ # **RDS for MySQL and Aurora MySQL**
2109
+ #
2110
+ # Default: `3306`
2111
+ #
2112
+ # Valid values: `1150-65535`
2113
+ #
2114
+ # **RDS for PostgreSQL and Aurora PostgreSQL**
2115
+ #
2116
+ # Default: `5432`
2117
+ #
2118
+ # Valid values: `1150-65535`
2119
+ #
2120
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2037
2121
  # @return [Integer]
2038
2122
  #
2039
2123
  # @!attribute [rw] master_username
@@ -2046,6 +2130,8 @@ module Aws::RDS
2046
2130
  # * First character must be a letter.
2047
2131
  #
2048
2132
  # * Can't be a reserved word for the chosen database engine.
2133
+ #
2134
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2049
2135
  # @return [String]
2050
2136
  #
2051
2137
  # @!attribute [rw] master_user_password
@@ -2053,15 +2139,16 @@ module Aws::RDS
2053
2139
  # any printable ASCII character except "/", """, or "@".
2054
2140
  #
2055
2141
  # Constraints: Must contain from 8 to 41 characters.
2142
+ #
2143
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2056
2144
  # @return [String]
2057
2145
  #
2058
2146
  # @!attribute [rw] option_group_name
2059
2147
  # A value that indicates that the DB cluster should be associated with
2060
2148
  # the specified option group.
2061
2149
  #
2062
- # Permanent options can't be removed from an option group. The option
2063
- # group can't be removed from a DB cluster once it is associated with
2064
- # a DB cluster.
2150
+ # DB clusters are associated with a default option group that can't
2151
+ # be modified.
2065
2152
  # @return [String]
2066
2153
  #
2067
2154
  # @!attribute [rw] preferred_backup_window
@@ -2084,6 +2171,8 @@ module Aws::RDS
2084
2171
  #
2085
2172
  # * Must be at least 30 minutes.
2086
2173
  #
2174
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2175
+ #
2087
2176
  #
2088
2177
  #
2089
2178
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Managing.Backups.html#Aurora.Managing.Backups.BackupWindow
@@ -2105,6 +2194,8 @@ module Aws::RDS
2105
2194
  #
2106
2195
  # Constraints: Minimum 30-minute window.
2107
2196
  #
2197
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2198
+ #
2108
2199
  #
2109
2200
  #
2110
2201
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#AdjustingTheMaintenanceWindow.Aurora
@@ -2113,14 +2204,20 @@ module Aws::RDS
2113
2204
  # @!attribute [rw] replication_source_identifier
2114
2205
  # The Amazon Resource Name (ARN) of the source DB instance or DB
2115
2206
  # cluster if this DB cluster is created as a read replica.
2207
+ #
2208
+ # Valid for: Aurora DB clusters only
2116
2209
  # @return [String]
2117
2210
  #
2118
2211
  # @!attribute [rw] tags
2119
2212
  # Tags to assign to the DB cluster.
2213
+ #
2214
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2120
2215
  # @return [Array<Types::Tag>]
2121
2216
  #
2122
2217
  # @!attribute [rw] storage_encrypted
2123
2218
  # A value that indicates whether the DB cluster is encrypted.
2219
+ #
2220
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2124
2221
  # @return [Boolean]
2125
2222
  #
2126
2223
  # @!attribute [rw] kms_key_id
@@ -2151,14 +2248,16 @@ module Aws::RDS
2151
2248
  # identifier that is valid in the destination Amazon Web Services
2152
2249
  # Region. This KMS key is used to encrypt the read replica in that
2153
2250
  # Amazon Web Services Region.
2251
+ #
2252
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2154
2253
  # @return [String]
2155
2254
  #
2156
2255
  # @!attribute [rw] pre_signed_url
2157
2256
  # A URL that contains a Signature Version 4 signed request for the
2158
2257
  # `CreateDBCluster` action to be called in the source Amazon Web
2159
- # Services Region where the DB cluster is replicated from. You only
2160
- # need to specify `PreSignedUrl` when you are performing cross-region
2161
- # replication from an encrypted DB cluster.
2258
+ # Services Region where the DB cluster is replicated from. Specify
2259
+ # `PreSignedUrl` only when you are performing cross-Region replication
2260
+ # from an encrypted DB cluster.
2162
2261
  #
2163
2262
  # The pre-signed URL must be a valid request for the `CreateDBCluster`
2164
2263
  # API action that can be executed in the source Amazon Web Services
@@ -2199,6 +2298,8 @@ module Aws::RDS
2199
2298
  #
2200
2299
  # </note>
2201
2300
  #
2301
+ # Valid for: Aurora DB clusters only
2302
+ #
2202
2303
  #
2203
2304
  #
2204
2305
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html
@@ -2208,11 +2309,13 @@ module Aws::RDS
2208
2309
  # @!attribute [rw] enable_iam_database_authentication
2209
2310
  # A value that indicates whether to enable mapping of Amazon Web
2210
2311
  # Services Identity and Access Management (IAM) accounts to database
2211
- # accounts. By default, mapping is disabled.
2312
+ # accounts. By default, mapping isn't enabled.
2212
2313
  #
2213
2314
  # For more information, see [ IAM Database Authentication][1] in the
2214
2315
  # *Amazon Aurora User Guide.*
2215
2316
  #
2317
+ # Valid for: Aurora DB clusters only
2318
+ #
2216
2319
  #
2217
2320
  #
2218
2321
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.html
@@ -2222,10 +2325,6 @@ module Aws::RDS
2222
2325
  # The target backtrack window, in seconds. To disable backtracking,
2223
2326
  # set this value to 0.
2224
2327
  #
2225
- # <note markdown="1"> Currently, Backtrack is only supported for Aurora MySQL DB clusters.
2226
- #
2227
- # </note>
2228
- #
2229
2328
  # Default: 0
2230
2329
  #
2231
2330
  # Constraints:
@@ -2234,6 +2333,8 @@ module Aws::RDS
2234
2333
  # (72 hours).
2235
2334
  #
2236
2335
  # ^
2336
+ #
2337
+ # Valid for: Aurora MySQL DB clusters only
2237
2338
  # @return [Integer]
2238
2339
  #
2239
2340
  # @!attribute [rw] enable_cloudwatch_logs_exports
@@ -2250,6 +2351,8 @@ module Aws::RDS
2250
2351
  #
2251
2352
  # Possible value is `postgresql`.
2252
2353
  #
2354
+ # Valid for: Aurora DB clusters only
2355
+ #
2253
2356
  #
2254
2357
  #
2255
2358
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
@@ -2286,6 +2389,8 @@ module Aws::RDS
2286
2389
  #
2287
2390
  # * [ Limitations of Multi-Master Clusters][4]
2288
2391
  #
2392
+ # Valid for: Aurora DB clusters only
2393
+ #
2289
2394
  #
2290
2395
  #
2291
2396
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html#aurora-serverless.limitations
@@ -2297,17 +2402,24 @@ module Aws::RDS
2297
2402
  # @!attribute [rw] scaling_configuration
2298
2403
  # For DB clusters in `serverless` DB engine mode, the scaling
2299
2404
  # properties of the DB cluster.
2405
+ #
2406
+ # Valid for: Aurora DB clusters only
2300
2407
  # @return [Types::ScalingConfiguration]
2301
2408
  #
2302
2409
  # @!attribute [rw] deletion_protection
2303
2410
  # A value that indicates whether the DB cluster has deletion
2304
2411
  # protection enabled. The database can't be deleted when deletion
2305
- # protection is enabled. By default, deletion protection is disabled.
2412
+ # protection is enabled. By default, deletion protection isn't
2413
+ # enabled.
2414
+ #
2415
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2306
2416
  # @return [Boolean]
2307
2417
  #
2308
2418
  # @!attribute [rw] global_cluster_identifier
2309
2419
  # The global cluster ID of an Aurora cluster that becomes the primary
2310
2420
  # cluster in the new global database cluster.
2421
+ #
2422
+ # Valid for: Aurora DB clusters only
2311
2423
  # @return [String]
2312
2424
  #
2313
2425
  # @!attribute [rw] enable_http_endpoint
@@ -2323,6 +2435,8 @@ module Aws::RDS
2323
2435
  # For more information, see [Using the Data API for Aurora
2324
2436
  # Serverless][1] in the *Amazon Aurora User Guide*.
2325
2437
  #
2438
+ # Valid for: Aurora DB clusters only
2439
+ #
2326
2440
  #
2327
2441
  #
2328
2442
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html
@@ -2331,16 +2445,21 @@ module Aws::RDS
2331
2445
  # @!attribute [rw] copy_tags_to_snapshot
2332
2446
  # A value that indicates whether to copy all tags from the DB cluster
2333
2447
  # to snapshots of the DB cluster. The default is not to copy them.
2448
+ #
2449
+ # Valid for: Aurora DB clusters only
2334
2450
  # @return [Boolean]
2335
2451
  #
2336
2452
  # @!attribute [rw] domain
2337
2453
  # The Active Directory directory ID to create the DB cluster in.
2338
2454
  #
2339
2455
  # For Amazon Aurora DB clusters, Amazon RDS can use Kerberos
2340
- # Authentication to authenticate users that connect to the DB cluster.
2341
- # For more information, see [Kerberos Authentication][1] in the
2456
+ # authentication to authenticate users that connect to the DB cluster.
2457
+ #
2458
+ # For more information, see [Kerberos authentication][1] in the
2342
2459
  # *Amazon Aurora User Guide*.
2343
2460
  #
2461
+ # Valid for: Aurora DB clusters only
2462
+ #
2344
2463
  #
2345
2464
  #
2346
2465
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/kerberos-authentication.html
@@ -2349,6 +2468,8 @@ module Aws::RDS
2349
2468
  # @!attribute [rw] domain_iam_role_name
2350
2469
  # Specify the name of the IAM role to be used when making API calls to
2351
2470
  # the Directory Service.
2471
+ #
2472
+ # Valid for: Aurora DB clusters only
2352
2473
  # @return [String]
2353
2474
  #
2354
2475
  # @!attribute [rw] enable_global_write_forwarding
@@ -2365,8 +2486,186 @@ module Aws::RDS
2365
2486
  # the primary DB cluster of an Aurora global database, this value is
2366
2487
  # used immediately if the primary is demoted by the
2367
2488
  # FailoverGlobalCluster API operation, but it does nothing until then.
2489
+ #
2490
+ # Valid for: Aurora DB clusters only
2491
+ # @return [Boolean]
2492
+ #
2493
+ # @!attribute [rw] db_cluster_instance_class
2494
+ # The compute and memory capacity of each DB instance in the Multi-AZ
2495
+ # DB cluster, for example db.m6g.xlarge. Not all DB instance classes
2496
+ # are available in all Amazon Web Services Regions, or for all
2497
+ # database engines.
2498
+ #
2499
+ # For the full list of DB instance classes and availability for your
2500
+ # engine, see [DB instance class][1] in the *Amazon RDS User Guide.*
2501
+ #
2502
+ # This setting is required to create a Multi-AZ DB cluster.
2503
+ #
2504
+ # Valid for: Multi-AZ DB clusters only
2505
+ #
2506
+ #
2507
+ #
2508
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html
2509
+ # @return [String]
2510
+ #
2511
+ # @!attribute [rw] allocated_storage
2512
+ # The amount of storage in gibibytes (GiB) to allocate to each DB
2513
+ # instance in the Multi-AZ DB cluster.
2514
+ #
2515
+ # This setting is required to create a Multi-AZ DB cluster.
2516
+ #
2517
+ # Valid for: Multi-AZ DB clusters only
2518
+ # @return [Integer]
2519
+ #
2520
+ # @!attribute [rw] storage_type
2521
+ # Specifies the storage type to be associated with the DB cluster.
2522
+ #
2523
+ # This setting is required to create a Multi-AZ DB cluster.
2524
+ #
2525
+ # Valid values: `standard | gp2 | io1`
2526
+ #
2527
+ # If you specify `io1`, also include a value for the `Iops` parameter.
2528
+ #
2529
+ # Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
2530
+ #
2531
+ # Valid for: Multi-AZ DB clusters only
2532
+ # @return [String]
2533
+ #
2534
+ # @!attribute [rw] iops
2535
+ # The amount of Provisioned IOPS (input/output operations per second)
2536
+ # to be initially allocated for each DB instance in the Multi-AZ DB
2537
+ # cluster.
2538
+ #
2539
+ # For information about valid `Iops` values, see [Amazon RDS
2540
+ # Provisioned IOPS storage to improve performance][1] in the *Amazon
2541
+ # RDS User Guide*.
2542
+ #
2543
+ # This setting is required to create a Multi-AZ DB cluster.
2544
+ #
2545
+ # Constraints: Must be a multiple between .5 and 50 of the storage
2546
+ # amount for the DB cluster.
2547
+ #
2548
+ # Valid for: Multi-AZ DB clusters only
2549
+ #
2550
+ #
2551
+ #
2552
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html#USER_PIOPS
2553
+ # @return [Integer]
2554
+ #
2555
+ # @!attribute [rw] publicly_accessible
2556
+ # A value that indicates whether the DB cluster is publicly
2557
+ # accessible.
2558
+ #
2559
+ # When the DB cluster is publicly accessible, its Domain Name System
2560
+ # (DNS) endpoint resolves to the private IP address from within the DB
2561
+ # cluster's virtual private cloud (VPC). It resolves to the public IP
2562
+ # address from outside of the DB cluster's VPC. Access to the DB
2563
+ # cluster is ultimately controlled by the security group it uses. That
2564
+ # public access isn't permitted if the security group assigned to the
2565
+ # DB cluster doesn't permit it.
2566
+ #
2567
+ # When the DB cluster isn't publicly accessible, it is an internal DB
2568
+ # cluster with a DNS name that resolves to a private IP address.
2569
+ #
2570
+ # Default: The default behavior varies depending on whether
2571
+ # `DBSubnetGroupName` is specified.
2572
+ #
2573
+ # If `DBSubnetGroupName` isn't specified, and `PubliclyAccessible`
2574
+ # isn't specified, the following applies:
2575
+ #
2576
+ # * If the default VPC in the target Region doesn’t have an internet
2577
+ # gateway attached to it, the DB cluster is private.
2578
+ #
2579
+ # * If the default VPC in the target Region has an internet gateway
2580
+ # attached to it, the DB cluster is public.
2581
+ #
2582
+ # If `DBSubnetGroupName` is specified, and `PubliclyAccessible` isn't
2583
+ # specified, the following applies:
2584
+ #
2585
+ # * If the subnets are part of a VPC that doesn’t have an internet
2586
+ # gateway attached to it, the DB cluster is private.
2587
+ #
2588
+ # * If the subnets are part of a VPC that has an internet gateway
2589
+ # attached to it, the DB cluster is public.
2590
+ #
2591
+ # Valid for: Multi-AZ DB clusters only
2592
+ # @return [Boolean]
2593
+ #
2594
+ # @!attribute [rw] auto_minor_version_upgrade
2595
+ # A value that indicates whether minor engine upgrades are applied
2596
+ # automatically to the DB cluster during the maintenance window. By
2597
+ # default, minor engine upgrades are applied automatically.
2598
+ #
2599
+ # Valid for: Multi-AZ DB clusters only
2600
+ # @return [Boolean]
2601
+ #
2602
+ # @!attribute [rw] monitoring_interval
2603
+ # The interval, in seconds, between points when Enhanced Monitoring
2604
+ # metrics are collected for the DB cluster. To turn off collecting
2605
+ # Enhanced Monitoring metrics, specify 0. The default is 0.
2606
+ #
2607
+ # If `MonitoringRoleArn` is specified, also set `MonitoringInterval`
2608
+ # to a value other than 0.
2609
+ #
2610
+ # Valid Values: `0, 1, 5, 10, 15, 30, 60`
2611
+ #
2612
+ # Valid for: Multi-AZ DB clusters only
2613
+ # @return [Integer]
2614
+ #
2615
+ # @!attribute [rw] monitoring_role_arn
2616
+ # The Amazon Resource Name (ARN) for the IAM role that permits RDS to
2617
+ # send Enhanced Monitoring metrics to Amazon CloudWatch Logs. An
2618
+ # example is `arn:aws:iam:123456789012:role/emaccess`. For information
2619
+ # on creating a monitoring role, see [Setting up and enabling Enhanced
2620
+ # Monitoring][1] in the *Amazon RDS User Guide*.
2621
+ #
2622
+ # If `MonitoringInterval` is set to a value other than 0, supply a
2623
+ # `MonitoringRoleArn` value.
2624
+ #
2625
+ # Valid for: Multi-AZ DB clusters only
2626
+ #
2627
+ #
2628
+ #
2629
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling
2630
+ # @return [String]
2631
+ #
2632
+ # @!attribute [rw] enable_performance_insights
2633
+ # A value that indicates whether to turn on Performance Insights for
2634
+ # the DB cluster.
2635
+ #
2636
+ # For more information, see [ Using Amazon Performance Insights][1] in
2637
+ # the *Amazon RDS User Guide*.
2638
+ #
2639
+ # Valid for: Multi-AZ DB clusters only
2640
+ #
2641
+ #
2642
+ #
2643
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
2368
2644
  # @return [Boolean]
2369
2645
  #
2646
+ # @!attribute [rw] performance_insights_kms_key_id
2647
+ # The Amazon Web Services KMS key identifier for encryption of
2648
+ # Performance Insights data.
2649
+ #
2650
+ # The Amazon Web Services KMS key identifier is the key ARN, key ID,
2651
+ # alias ARN, or alias name for the KMS key.
2652
+ #
2653
+ # If you don't specify a value for `PerformanceInsightsKMSKeyId`,
2654
+ # then Amazon RDS uses your default KMS key. There is a default KMS
2655
+ # key for your Amazon Web Services account. Your Amazon Web Services
2656
+ # account has a different default KMS key for each Amazon Web Services
2657
+ # Region.
2658
+ #
2659
+ # Valid for: Multi-AZ DB clusters only
2660
+ # @return [String]
2661
+ #
2662
+ # @!attribute [rw] performance_insights_retention_period
2663
+ # The amount of time, in days, to retain Performance Insights data.
2664
+ # Valid values are 7 or 731 (2 years).
2665
+ #
2666
+ # Valid for: Multi-AZ DB clusters only
2667
+ # @return [Integer]
2668
+ #
2370
2669
  # @!attribute [rw] source_region
2371
2670
  # The source region of the snapshot. This is only needed when the
2372
2671
  # shapshot is encrypted and in a different region.
@@ -2408,6 +2707,17 @@ module Aws::RDS
2408
2707
  :domain,
2409
2708
  :domain_iam_role_name,
2410
2709
  :enable_global_write_forwarding,
2710
+ :db_cluster_instance_class,
2711
+ :allocated_storage,
2712
+ :storage_type,
2713
+ :iops,
2714
+ :publicly_accessible,
2715
+ :auto_minor_version_upgrade,
2716
+ :monitoring_interval,
2717
+ :monitoring_role_arn,
2718
+ :enable_performance_insights,
2719
+ :performance_insights_kms_key_id,
2720
+ :performance_insights_retention_period,
2411
2721
  :source_region)
2412
2722
  SENSITIVE = []
2413
2723
  include Aws::Structure
@@ -2433,7 +2743,7 @@ module Aws::RDS
2433
2743
  #
2434
2744
  # Constraints:
2435
2745
  #
2436
- # * Must match the name of an existing DB cluster parameter group.
2746
+ # * Must not match the name of an existing DB cluster parameter group.
2437
2747
  #
2438
2748
  # ^
2439
2749
  #
@@ -2457,6 +2767,14 @@ module Aws::RDS
2457
2767
  #
2458
2768
  # Example: `aurora-postgresql9.6`
2459
2769
  #
2770
+ # **RDS for MySQL**
2771
+ #
2772
+ # Example: `mysql8.0`
2773
+ #
2774
+ # **RDS for PostgreSQL**
2775
+ #
2776
+ # Example: `postgres12`
2777
+ #
2460
2778
  # To list all of the available parameter group families for a DB
2461
2779
  # engine, use the following command:
2462
2780
  #
@@ -2481,6 +2799,10 @@ module Aws::RDS
2481
2799
  # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
2482
2800
  #
2483
2801
  # * `aurora-postgresql`
2802
+ #
2803
+ # * `mysql`
2804
+ #
2805
+ # * `postgres`
2484
2806
  # @return [String]
2485
2807
  #
2486
2808
  # @!attribute [rw] description
@@ -2518,10 +2840,39 @@ module Aws::RDS
2518
2840
  end
2519
2841
 
2520
2842
  # @!attribute [rw] db_cluster
2521
- # Contains the details of an Amazon Aurora DB cluster.
2843
+ # Contains the details of an Amazon Aurora DB cluster or Multi-AZ DB
2844
+ # cluster.
2522
2845
  #
2523
- # This data type is used as a response element in the
2524
- # `DescribeDBClusters`, `StopDBCluster`, and `StartDBCluster` actions.
2846
+ # For an Amazon Aurora DB cluster, this data type is used as a
2847
+ # response element in the operations `CreateDBCluster`,
2848
+ # `DeleteDBCluster`, `DescribeDBClusters`, `FailoverDBCluster`,
2849
+ # `ModifyDBCluster`, `PromoteReadReplicaDBCluster`,
2850
+ # `RestoreDBClusterFromS3`, `RestoreDBClusterFromSnapshot`,
2851
+ # `RestoreDBClusterToPointInTime`, `StartDBCluster`, and
2852
+ # `StopDBCluster`.
2853
+ #
2854
+ # For a Multi-AZ DB cluster, this data type is used as a response
2855
+ # element in the operations `CreateDBCluster`, `DeleteDBCluster`,
2856
+ # `DescribeDBClusters`, `FailoverDBCluster`, `ModifyDBCluster`,
2857
+ # `RebootDBCluster`, `RestoreDBClusterFromSnapshot`, and
2858
+ # `RestoreDBClusterToPointInTime`.
2859
+ #
2860
+ # For more information on Amazon Aurora DB clusters, see [ What is
2861
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
2862
+ #
2863
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
2864
+ # deployments with two readable standby DB instances][2] in the
2865
+ # *Amazon RDS User Guide.*
2866
+ #
2867
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
2868
+ # change.
2869
+ #
2870
+ # </note>
2871
+ #
2872
+ #
2873
+ #
2874
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
2875
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
2525
2876
  # @return [Types::DBCluster]
2526
2877
  #
2527
2878
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBClusterResult AWS API Documentation
@@ -2666,6 +3017,7 @@ module Aws::RDS
2666
3017
  # max_allocated_storage: 1,
2667
3018
  # enable_customer_owned_ip: false,
2668
3019
  # custom_iam_instance_profile: "String",
3020
+ # backup_target: "String",
2669
3021
  # }
2670
3022
  #
2671
3023
  # @!attribute [rw] db_name
@@ -2898,11 +3250,11 @@ module Aws::RDS
2898
3250
  # @return [Integer]
2899
3251
  #
2900
3252
  # @!attribute [rw] db_instance_class
2901
- # The compute and memory capacity of the DB instance, for example,
2902
- # `db.m4.large`. Not all DB instance classes are available in all
2903
- # Amazon Web Services Regions, or for all database engines. For the
2904
- # full list of DB instance classes, and availability for your engine,
2905
- # see [DB Instance Class][1] in the *Amazon RDS User Guide.*
3253
+ # The compute and memory capacity of the DB instance, for example
3254
+ # db.m4.large. Not all DB instance classes are available in all Amazon
3255
+ # Web Services Regions, or for all database engines. For the full list
3256
+ # of DB instance classes, and availability for your engine, see [DB
3257
+ # Instance Class][1] in the *Amazon RDS User Guide.*
2906
3258
  #
2907
3259
  #
2908
3260
  #
@@ -2956,59 +3308,13 @@ module Aws::RDS
2956
3308
  # Not applicable. The name for the master user is managed by the DB
2957
3309
  # cluster.
2958
3310
  #
2959
- # **MariaDB**
2960
- #
2961
- # Constraints:
2962
- #
2963
- # * Required for MariaDB.
2964
- #
2965
- # * Must be 1 to 16 letters or numbers.
2966
- #
2967
- # * Can't be a reserved word for the chosen database engine.
2968
- #
2969
- # **Microsoft SQL Server**
2970
- #
2971
- # Constraints:
2972
- #
2973
- # * Required for SQL Server.
2974
- #
2975
- # * Must be 1 to 128 letters or numbers.
2976
- #
2977
- # * The first character must be a letter.
2978
- #
2979
- # * Can't be a reserved word for the chosen database engine.
2980
- #
2981
- # **MySQL**
2982
- #
2983
- # Constraints:
2984
- #
2985
- # * Required for MySQL.
2986
- #
2987
- # * Must be 1 to 16 letters or numbers.
2988
- #
2989
- # * First character must be a letter.
2990
- #
2991
- # * Can't be a reserved word for the chosen database engine.
2992
- #
2993
- # **Oracle**
2994
- #
2995
- # Constraints:
2996
- #
2997
- # * Required for Oracle.
2998
- #
2999
- # * Must be 1 to 30 letters or numbers.
3000
- #
3001
- # * First character must be a letter.
3002
- #
3003
- # * Can't be a reserved word for the chosen database engine.
3004
- #
3005
- # **PostgreSQL**
3311
+ # **Amazon RDS**
3006
3312
  #
3007
3313
  # Constraints:
3008
3314
  #
3009
- # * Required for PostgreSQL.
3315
+ # * Required.
3010
3316
  #
3011
- # * Must be 1 to 63 letters or numbers.
3317
+ # * Must be 1 to 16 letters, numbers, or underscores.
3012
3318
  #
3013
3319
  # * First character must be a letter.
3014
3320
  #
@@ -3268,28 +3574,28 @@ module Aws::RDS
3268
3574
  #
3269
3575
  # **MariaDB**
3270
3576
  #
3271
- # See [MariaDB on Amazon RDS Versions][2] in the *Amazon RDS User
3272
- # Guide.*
3577
+ # For information, see [MariaDB on Amazon RDS Versions][2] in the
3578
+ # *Amazon RDS User Guide.*
3273
3579
  #
3274
3580
  # **Microsoft SQL Server**
3275
3581
  #
3276
- # See [Microsoft SQL Server Versions on Amazon RDS][3] in the *Amazon
3277
- # RDS User Guide.*
3582
+ # For information, see [Microsoft SQL Server Versions on Amazon
3583
+ # RDS][3] in the *Amazon RDS User Guide.*
3278
3584
  #
3279
3585
  # **MySQL**
3280
3586
  #
3281
- # See [MySQL on Amazon RDS Versions][4] in the *Amazon RDS User
3282
- # Guide.*
3587
+ # For information, see [MySQL on Amazon RDS Versions][4] in the
3588
+ # *Amazon RDS User Guide.*
3283
3589
  #
3284
3590
  # **Oracle**
3285
3591
  #
3286
- # See [Oracle Database Engine Release Notes][5] in the *Amazon RDS
3287
- # User Guide.*
3592
+ # For information, see [Oracle Database Engine Release Notes][5] in
3593
+ # the *Amazon RDS User Guide.*
3288
3594
  #
3289
3595
  # **PostgreSQL**
3290
3596
  #
3291
- # See [Amazon RDS for PostgreSQL versions and extensions][6] in the
3292
- # *Amazon RDS User Guide.*
3597
+ # For information, see [Amazon RDS for PostgreSQL versions and
3598
+ # extensions][6] in the *Amazon RDS User Guide.*
3293
3599
  #
3294
3600
  #
3295
3601
  #
@@ -3322,8 +3628,8 @@ module Aws::RDS
3322
3628
  # @!attribute [rw] iops
3323
3629
  # The amount of Provisioned IOPS (input/output operations per second)
3324
3630
  # to be initially allocated for the DB instance. For information about
3325
- # valid Iops values, see [Amazon RDS Provisioned IOPS Storage to
3326
- # Improve Performance][1] in the *Amazon RDS User Guide*.
3631
+ # valid `Iops` values, see [Amazon RDS Provisioned IOPS storage to
3632
+ # improve performance][1] in the *Amazon RDS User Guide*.
3327
3633
  #
3328
3634
  # Constraints: For MariaDB, MySQL, Oracle, and PostgreSQL DB
3329
3635
  # instances, must be a multiple between .5 and 50 of the storage
@@ -3370,12 +3676,13 @@ module Aws::RDS
3370
3676
  # A value that indicates whether the DB instance is publicly
3371
3677
  # accessible.
3372
3678
  #
3373
- # When the DB instance is publicly accessible, its DNS endpoint
3374
- # resolves to the private IP address from within the DB instance's
3375
- # VPC, and to the public IP address from outside of the DB instance's
3376
- # VPC. Access to the DB instance is ultimately controlled by the
3377
- # security group it uses, and that public access is not permitted if
3378
- # the security group assigned to the DB instance doesn't permit it.
3679
+ # When the DB instance is publicly accessible, its Domain Name System
3680
+ # (DNS) endpoint resolves to the private IP address from within the DB
3681
+ # instance's virtual private cloud (VPC). It resolves to the public
3682
+ # IP address from outside of the DB instance's VPC. Access to the DB
3683
+ # instance is ultimately controlled by the security group it uses.
3684
+ # That public access is not permitted if the security group assigned
3685
+ # to the DB instance doesn't permit it.
3379
3686
  #
3380
3687
  # When the DB instance isn't publicly accessible, it is an internal
3381
3688
  # DB instance with a DNS name that resolves to a private IP address.
@@ -3386,19 +3693,19 @@ module Aws::RDS
3386
3693
  # If `DBSubnetGroupName` isn't specified, and `PubliclyAccessible`
3387
3694
  # isn't specified, the following applies:
3388
3695
  #
3389
- # * If the default VPC in the target region doesn’t have an Internet
3696
+ # * If the default VPC in the target Region doesn’t have an internet
3390
3697
  # gateway attached to it, the DB instance is private.
3391
3698
  #
3392
- # * If the default VPC in the target region has an Internet gateway
3699
+ # * If the default VPC in the target Region has an internet gateway
3393
3700
  # attached to it, the DB instance is public.
3394
3701
  #
3395
3702
  # If `DBSubnetGroupName` is specified, and `PubliclyAccessible` isn't
3396
3703
  # specified, the following applies:
3397
3704
  #
3398
- # * If the subnets are part of a VPC that doesn’t have an Internet
3705
+ # * If the subnets are part of a VPC that doesn’t have an internet
3399
3706
  # gateway attached to it, the DB instance is private.
3400
3707
  #
3401
- # * If the subnets are part of a VPC that has an Internet gateway
3708
+ # * If the subnets are part of a VPC that has an internet gateway
3402
3709
  # attached to it, the DB instance is public.
3403
3710
  # @return [Boolean]
3404
3711
  #
@@ -3573,7 +3880,7 @@ module Aws::RDS
3573
3880
  # @!attribute [rw] enable_iam_database_authentication
3574
3881
  # A value that indicates whether to enable mapping of Amazon Web
3575
3882
  # Services Identity and Access Management (IAM) accounts to database
3576
- # accounts. By default, mapping is disabled.
3883
+ # accounts. By default, mapping isn't enabled.
3577
3884
  #
3578
3885
  # This setting doesn't apply to RDS Custom or Amazon Aurora. In
3579
3886
  # Aurora, mapping Amazon Web Services IAM accounts to database
@@ -3673,8 +3980,8 @@ module Aws::RDS
3673
3980
  # @!attribute [rw] deletion_protection
3674
3981
  # A value that indicates whether the DB instance has deletion
3675
3982
  # protection enabled. The database can't be deleted when deletion
3676
- # protection is enabled. By default, deletion protection is disabled.
3677
- # For more information, see [ Deleting a DB Instance][1].
3983
+ # protection is enabled. By default, deletion protection isn't
3984
+ # enabled. For more information, see [ Deleting a DB Instance][1].
3678
3985
  #
3679
3986
  # **Amazon Aurora**
3680
3987
  #
@@ -3750,6 +4057,20 @@ module Aws::RDS
3750
4057
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
3751
4058
  # @return [String]
3752
4059
  #
4060
+ # @!attribute [rw] backup_target
4061
+ # Specifies where automated backups and manual snapshots are stored.
4062
+ #
4063
+ # Possible values are `outposts` (Amazon Web Services Outposts) and
4064
+ # `region` (Amazon Web Services Region). The default is `region`.
4065
+ #
4066
+ # For more information, see [Working with Amazon RDS on Amazon Web
4067
+ # Services Outposts][1] in the *Amazon RDS User Guide*.
4068
+ #
4069
+ #
4070
+ #
4071
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
4072
+ # @return [String]
4073
+ #
3753
4074
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstanceMessage AWS API Documentation
3754
4075
  #
3755
4076
  class CreateDBInstanceMessage < Struct.new(
@@ -3801,7 +4122,8 @@ module Aws::RDS
3801
4122
  :deletion_protection,
3802
4123
  :max_allocated_storage,
3803
4124
  :enable_customer_owned_ip,
3804
- :custom_iam_instance_profile)
4125
+ :custom_iam_instance_profile,
4126
+ :backup_target)
3805
4127
  SENSITIVE = []
3806
4128
  include Aws::Structure
3807
4129
  end
@@ -3883,7 +4205,7 @@ module Aws::RDS
3883
4205
  # Guide*.
3884
4206
  #
3885
4207
  # * Can specify a PostgreSQL DB instance only if the source is running
3886
- # PostgreSQL 9.3.5 or later (9.4.7 and higher for cross-region
4208
+ # PostgreSQL 9.3.5 or later (9.4.7 and higher for cross-Region
3887
4209
  # replication).
3888
4210
  #
3889
4211
  # * The specified DB instance must have automatic backups enabled,
@@ -3907,11 +4229,11 @@ module Aws::RDS
3907
4229
  # @return [String]
3908
4230
  #
3909
4231
  # @!attribute [rw] db_instance_class
3910
- # The compute and memory capacity of the read replica, for example,
3911
- # `db.m4.large`. Not all DB instance classes are available in all
3912
- # Amazon Web Services Regions, or for all database engines. For the
3913
- # full list of DB instance classes, and availability for your engine,
3914
- # see [DB Instance Class][1] in the *Amazon RDS User Guide.*
4232
+ # The compute and memory capacity of the read replica, for example
4233
+ # db.m4.large. Not all DB instance classes are available in all Amazon
4234
+ # Web Services Regions, or for all database engines. For the full list
4235
+ # of DB instance classes, and availability for your engine, see [DB
4236
+ # Instance Class][1] in the *Amazon RDS User Guide.*
3915
4237
  #
3916
4238
  # Default: Inherits from the source DB instance.
3917
4239
  #
@@ -3982,8 +4304,8 @@ module Aws::RDS
3982
4304
  #
3983
4305
  # If you do not specify a value for `DBParameterGroupName`, then
3984
4306
  # Amazon RDS uses the `DBParameterGroup` of source DB instance for a
3985
- # same region read replica, or the default `DBParameterGroup` for the
3986
- # specified DB engine for a cross region read replica.
4307
+ # same Region read replica, or the default `DBParameterGroup` for the
4308
+ # specified DB engine for a cross-Region read replica.
3987
4309
  #
3988
4310
  # Specifying a parameter group for this operation is only supported
3989
4311
  # for Oracle DB instances. It isn't supported for RDS Custom.
@@ -4001,12 +4323,13 @@ module Aws::RDS
4001
4323
  # A value that indicates whether the DB instance is publicly
4002
4324
  # accessible.
4003
4325
  #
4004
- # When the DB instance is publicly accessible, its DNS endpoint
4005
- # resolves to the private IP address from within the DB instance's
4006
- # VPC, and to the public IP address from outside of the DB instance's
4007
- # VPC. Access to the DB instance is ultimately controlled by the
4008
- # security group it uses, and that public access is not permitted if
4009
- # the security group assigned to the DB instance doesn't permit it.
4326
+ # When the DB cluster is publicly accessible, its Domain Name System
4327
+ # (DNS) endpoint resolves to the private IP address from within the DB
4328
+ # cluster's virtual private cloud (VPC). It resolves to the public IP
4329
+ # address from outside of the DB cluster's VPC. Access to the DB
4330
+ # cluster is ultimately controlled by the security group it uses. That
4331
+ # public access isn't permitted if the security group assigned to the
4332
+ # DB cluster doesn't permit it.
4010
4333
  #
4011
4334
  # When the DB instance isn't publicly accessible, it is an internal
4012
4335
  # DB instance with a DNS name that resolves to a private IP address.
@@ -4195,7 +4518,7 @@ module Aws::RDS
4195
4518
  # Region.
4196
4519
  #
4197
4520
  # `SourceRegion` isn't supported for SQL Server, because SQL Server
4198
- # on Amazon RDS doesn't support cross-region read replicas.
4521
+ # on Amazon RDS doesn't support cross-Region read replicas.
4199
4522
  #
4200
4523
  # </note>
4201
4524
  #
@@ -4210,7 +4533,7 @@ module Aws::RDS
4210
4533
  # @!attribute [rw] enable_iam_database_authentication
4211
4534
  # A value that indicates whether to enable mapping of Amazon Web
4212
4535
  # Services Identity and Access Management (IAM) accounts to database
4213
- # accounts. By default, mapping is disabled.
4536
+ # accounts. By default, mapping isn't enabled.
4214
4537
  #
4215
4538
  # For more information about IAM database authentication, see [ IAM
4216
4539
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
@@ -4290,8 +4613,8 @@ module Aws::RDS
4290
4613
  # @!attribute [rw] deletion_protection
4291
4614
  # A value that indicates whether the DB instance has deletion
4292
4615
  # protection enabled. The database can't be deleted when deletion
4293
- # protection is enabled. By default, deletion protection is disabled.
4294
- # For more information, see [ Deleting a DB Instance][1].
4616
+ # protection is enabled. By default, deletion protection isn't
4617
+ # enabled. For more information, see [ Deleting a DB Instance][1].
4295
4618
  #
4296
4619
  #
4297
4620
  #
@@ -4434,8 +4757,13 @@ module Aws::RDS
4434
4757
  # @!attribute [rw] db_instance
4435
4758
  # Contains the details of an Amazon RDS DB instance.
4436
4759
  #
4437
- # This data type is used as a response element in the
4438
- # `DescribeDBInstances` action.
4760
+ # This data type is used as a response element in the operations
4761
+ # `CreateDBInstance`, `CreateDBInstanceReadReplica`,
4762
+ # `DeleteDBInstance`, `DescribeDBInstances`, `ModifyDBInstance`,
4763
+ # `PromoteReadReplica`, `RebootDBInstance`,
4764
+ # `RestoreDBInstanceFromDBSnapshot`, `RestoreDBInstanceFromS3`,
4765
+ # `RestoreDBInstanceToPointInTime`, `StartDBInstance`, and
4766
+ # `StopDBInstance`.
4439
4767
  # @return [Types::DBInstance]
4440
4768
  #
4441
4769
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstanceReadReplicaResult AWS API Documentation
@@ -4449,8 +4777,13 @@ module Aws::RDS
4449
4777
  # @!attribute [rw] db_instance
4450
4778
  # Contains the details of an Amazon RDS DB instance.
4451
4779
  #
4452
- # This data type is used as a response element in the
4453
- # `DescribeDBInstances` action.
4780
+ # This data type is used as a response element in the operations
4781
+ # `CreateDBInstance`, `CreateDBInstanceReadReplica`,
4782
+ # `DeleteDBInstance`, `DescribeDBInstances`, `ModifyDBInstance`,
4783
+ # `PromoteReadReplica`, `RebootDBInstance`,
4784
+ # `RestoreDBInstanceFromDBSnapshot`, `RestoreDBInstanceFromS3`,
4785
+ # `RestoreDBInstanceToPointInTime`, `StartDBInstance`, and
4786
+ # `StopDBInstance`.
4454
4787
  # @return [Types::DBInstance]
4455
4788
  #
4456
4789
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstanceResult AWS API Documentation
@@ -5371,10 +5704,38 @@ module Aws::RDS
5371
5704
  #
5372
5705
  class CustomDBEngineVersionQuotaExceededFault < Aws::EmptyStructure; end
5373
5706
 
5374
- # Contains the details of an Amazon Aurora DB cluster.
5707
+ # Contains the details of an Amazon Aurora DB cluster or Multi-AZ DB
5708
+ # cluster.
5375
5709
  #
5376
- # This data type is used as a response element in the
5377
- # `DescribeDBClusters`, `StopDBCluster`, and `StartDBCluster` actions.
5710
+ # For an Amazon Aurora DB cluster, this data type is used as a response
5711
+ # element in the operations `CreateDBCluster`, `DeleteDBCluster`,
5712
+ # `DescribeDBClusters`, `FailoverDBCluster`, `ModifyDBCluster`,
5713
+ # `PromoteReadReplicaDBCluster`, `RestoreDBClusterFromS3`,
5714
+ # `RestoreDBClusterFromSnapshot`, `RestoreDBClusterToPointInTime`,
5715
+ # `StartDBCluster`, and `StopDBCluster`.
5716
+ #
5717
+ # For a Multi-AZ DB cluster, this data type is used as a response
5718
+ # element in the operations `CreateDBCluster`, `DeleteDBCluster`,
5719
+ # `DescribeDBClusters`, `FailoverDBCluster`, `ModifyDBCluster`,
5720
+ # `RebootDBCluster`, `RestoreDBClusterFromSnapshot`, and
5721
+ # `RestoreDBClusterToPointInTime`.
5722
+ #
5723
+ # For more information on Amazon Aurora DB clusters, see [ What is
5724
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
5725
+ #
5726
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
5727
+ # deployments with two readable standby DB instances][2] in the *Amazon
5728
+ # RDS User Guide.*
5729
+ #
5730
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
5731
+ # change.
5732
+ #
5733
+ # </note>
5734
+ #
5735
+ #
5736
+ #
5737
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
5738
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
5378
5739
  #
5379
5740
  # @!attribute [rw] allocated_storage
5380
5741
  # For all database engines except Amazon Aurora, `AllocatedStorage`
@@ -5727,6 +6088,89 @@ module Aws::RDS
5727
6088
  # changes are identified by subelements.
5728
6089
  # @return [Types::ClusterPendingModifiedValues]
5729
6090
  #
6091
+ # @!attribute [rw] db_cluster_instance_class
6092
+ # The name of the compute and memory capacity class of the DB
6093
+ # instance.
6094
+ #
6095
+ # This setting is only for non-Aurora Multi-AZ DB clusters.
6096
+ # @return [String]
6097
+ #
6098
+ # @!attribute [rw] storage_type
6099
+ # The storage type associated with DB instance.
6100
+ #
6101
+ # This setting is only for non-Aurora Multi-AZ DB clusters.
6102
+ # @return [String]
6103
+ #
6104
+ # @!attribute [rw] iops
6105
+ # The Provisioned IOPS (I/O operations per second) value.
6106
+ #
6107
+ # This setting is only for non-Aurora Multi-AZ DB clusters.
6108
+ # @return [Integer]
6109
+ #
6110
+ # @!attribute [rw] publicly_accessible
6111
+ # Specifies the accessibility options for the DB instance.
6112
+ #
6113
+ # When the DB instance is publicly accessible, its Domain Name System
6114
+ # (DNS) endpoint resolves to the private IP address from within the DB
6115
+ # instance's virtual private cloud (VPC). It resolves to the public
6116
+ # IP address from outside of the DB instance's VPC. Access to the DB
6117
+ # instance is ultimately controlled by the security group it uses.
6118
+ # That public access is not permitted if the security group assigned
6119
+ # to the DB instance doesn't permit it.
6120
+ #
6121
+ # When the DB instance isn't publicly accessible, it is an internal
6122
+ # DB instance with a DNS name that resolves to a private IP address.
6123
+ #
6124
+ # For more information, see CreateDBInstance.
6125
+ #
6126
+ # This setting is only for non-Aurora Multi-AZ DB clusters.
6127
+ # @return [Boolean]
6128
+ #
6129
+ # @!attribute [rw] auto_minor_version_upgrade
6130
+ # A value that indicates that minor version patches are applied
6131
+ # automatically.
6132
+ #
6133
+ # This setting is only for non-Aurora Multi-AZ DB clusters.
6134
+ # @return [Boolean]
6135
+ #
6136
+ # @!attribute [rw] monitoring_interval
6137
+ # The interval, in seconds, between points when Enhanced Monitoring
6138
+ # metrics are collected for the DB cluster.
6139
+ #
6140
+ # This setting is only for non-Aurora Multi-AZ DB clusters.
6141
+ # @return [Integer]
6142
+ #
6143
+ # @!attribute [rw] monitoring_role_arn
6144
+ # The ARN for the IAM role that permits RDS to send Enhanced
6145
+ # Monitoring metrics to Amazon CloudWatch Logs.
6146
+ #
6147
+ # This setting is only for non-Aurora Multi-AZ DB clusters.
6148
+ # @return [String]
6149
+ #
6150
+ # @!attribute [rw] performance_insights_enabled
6151
+ # True if Performance Insights is enabled for the DB cluster, and
6152
+ # otherwise false.
6153
+ #
6154
+ # This setting is only for non-Aurora Multi-AZ DB clusters.
6155
+ # @return [Boolean]
6156
+ #
6157
+ # @!attribute [rw] performance_insights_kms_key_id
6158
+ # The Amazon Web Services KMS key identifier for encryption of
6159
+ # Performance Insights data.
6160
+ #
6161
+ # The Amazon Web Services KMS key identifier is the key ARN, key ID,
6162
+ # alias ARN, or alias name for the KMS key.
6163
+ #
6164
+ # This setting is only for non-Aurora Multi-AZ DB clusters.
6165
+ # @return [String]
6166
+ #
6167
+ # @!attribute [rw] performance_insights_retention_period
6168
+ # The amount of time, in days, to retain Performance Insights data.
6169
+ # Valid values are 7 or 731 (2 years).
6170
+ #
6171
+ # This setting is only for non-Aurora Multi-AZ DB clusters.
6172
+ # @return [Integer]
6173
+ #
5730
6174
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBCluster AWS API Documentation
5731
6175
  #
5732
6176
  class DBCluster < Struct.new(
@@ -5786,7 +6230,17 @@ module Aws::RDS
5786
6230
  :tag_list,
5787
6231
  :global_write_forwarding_status,
5788
6232
  :global_write_forwarding_requested,
5789
- :pending_modified_values)
6233
+ :pending_modified_values,
6234
+ :db_cluster_instance_class,
6235
+ :storage_type,
6236
+ :iops,
6237
+ :publicly_accessible,
6238
+ :auto_minor_version_upgrade,
6239
+ :monitoring_interval,
6240
+ :monitoring_role_arn,
6241
+ :performance_insights_enabled,
6242
+ :performance_insights_kms_key_id,
6243
+ :performance_insights_retention_period)
5790
6244
  SENSITIVE = []
5791
6245
  include Aws::Structure
5792
6246
  end
@@ -6739,8 +7193,12 @@ module Aws::RDS
6739
7193
 
6740
7194
  # Contains the details of an Amazon RDS DB instance.
6741
7195
  #
6742
- # This data type is used as a response element in the
6743
- # `DescribeDBInstances` action.
7196
+ # This data type is used as a response element in the operations
7197
+ # `CreateDBInstance`, `CreateDBInstanceReadReplica`, `DeleteDBInstance`,
7198
+ # `DescribeDBInstances`, `ModifyDBInstance`, `PromoteReadReplica`,
7199
+ # `RebootDBInstance`, `RestoreDBInstanceFromDBSnapshot`,
7200
+ # `RestoreDBInstanceFromS3`, `RestoreDBInstanceToPointInTime`,
7201
+ # `StartDBInstance`, and `StopDBInstance`.
6744
7202
  #
6745
7203
  # @!attribute [rw] db_instance_identifier
6746
7204
  # Contains a user-supplied database identifier. This identifier is the
@@ -6892,10 +7350,10 @@ module Aws::RDS
6892
7350
  # @!attribute [rw] read_replica_db_cluster_identifiers
6893
7351
  # Contains one or more identifiers of Aurora DB clusters to which the
6894
7352
  # RDS DB instance is replicated as a read replica. For example, when
6895
- # you create an Aurora read replica of an RDS MySQL DB instance, the
6896
- # Aurora MySQL DB cluster for the Aurora read replica is shown. This
6897
- # output does not contain information about cross region Aurora read
6898
- # replicas.
7353
+ # you create an Aurora read replica of an RDS for MySQL DB instance,
7354
+ # the Aurora MySQL DB cluster for the Aurora read replica is shown.
7355
+ # This output doesn't contain information about cross-Region Aurora
7356
+ # read replicas.
6899
7357
  #
6900
7358
  # <note markdown="1"> Currently, each RDS DB instance can have only one Aurora read
6901
7359
  # replica.
@@ -6949,12 +7407,13 @@ module Aws::RDS
6949
7407
  # @!attribute [rw] publicly_accessible
6950
7408
  # Specifies the accessibility options for the DB instance.
6951
7409
  #
6952
- # When the DB instance is publicly accessible, its DNS endpoint
6953
- # resolves to the private IP address from within the DB instance's
6954
- # VPC, and to the public IP address from outside of the DB instance's
6955
- # VPC. Access to the DB instance is ultimately controlled by the
6956
- # security group it uses, and that public access is not permitted if
6957
- # the security group assigned to the DB instance doesn't permit it.
7410
+ # When the DB cluster is publicly accessible, its Domain Name System
7411
+ # (DNS) endpoint resolves to the private IP address from within the DB
7412
+ # cluster's virtual private cloud (VPC). It resolves to the public IP
7413
+ # address from outside of the DB cluster's VPC. Access to the DB
7414
+ # cluster is ultimately controlled by the security group it uses. That
7415
+ # public access isn't permitted if the security group assigned to the
7416
+ # DB cluster doesn't permit it.
6958
7417
  #
6959
7418
  # When the DB instance isn't publicly accessible, it is an internal
6960
7419
  # DB instance with a DNS name that resolves to a private IP address.
@@ -7243,6 +7702,11 @@ module Aws::RDS
7243
7702
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
7244
7703
  # @return [String]
7245
7704
  #
7705
+ # @!attribute [rw] backup_target
7706
+ # Specifies where automated backups and manual snapshots are stored:
7707
+ # Amazon Web Services Outposts or the Amazon Web Services Region.
7708
+ # @return [String]
7709
+ #
7246
7710
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBInstance AWS API Documentation
7247
7711
  #
7248
7712
  class DBInstance < Struct.new(
@@ -7318,7 +7782,8 @@ module Aws::RDS
7318
7782
  :activity_stream_engine_native_audit_fields_included,
7319
7783
  :automation_mode,
7320
7784
  :resume_full_automation_mode_time,
7321
- :custom_iam_instance_profile)
7785
+ :custom_iam_instance_profile,
7786
+ :backup_target)
7322
7787
  SENSITIVE = []
7323
7788
  include Aws::Structure
7324
7789
  end
@@ -7466,6 +7931,11 @@ module Aws::RDS
7466
7931
  # associated with the automated backup.
7467
7932
  # @return [Array<Types::DBInstanceAutomatedBackupsReplication>]
7468
7933
  #
7934
+ # @!attribute [rw] backup_target
7935
+ # Specifies where automated backups are stored: Amazon Web Services
7936
+ # Outposts or the Amazon Web Services Region.
7937
+ # @return [String]
7938
+ #
7469
7939
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBInstanceAutomatedBackup AWS API Documentation
7470
7940
  #
7471
7941
  class DBInstanceAutomatedBackup < Struct.new(
@@ -7494,7 +7964,8 @@ module Aws::RDS
7494
7964
  :iam_database_authentication_enabled,
7495
7965
  :backup_retention_period,
7496
7966
  :db_instance_automated_backups_arn,
7497
- :db_instance_automated_backups_replications)
7967
+ :db_instance_automated_backups_replications,
7968
+ :backup_target)
7498
7969
  SENSITIVE = []
7499
7970
  include Aws::Structure
7500
7971
  end
@@ -8489,6 +8960,11 @@ module Aws::RDS
8489
8960
  # Universal Time (UTC). Doesn't change when the snapshot is copied.
8490
8961
  # @return [Time]
8491
8962
  #
8963
+ # @!attribute [rw] snapshot_target
8964
+ # Specifies where manual snapshots are stored: Amazon Web Services
8965
+ # Outposts or the Amazon Web Services Region.
8966
+ # @return [String]
8967
+ #
8492
8968
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBSnapshot AWS API Documentation
8493
8969
  #
8494
8970
  class DBSnapshot < Struct.new(
@@ -8521,7 +8997,8 @@ module Aws::RDS
8521
8997
  :processor_features,
8522
8998
  :dbi_resource_id,
8523
8999
  :tag_list,
8524
- :original_snapshot_create_time)
9000
+ :original_snapshot_create_time,
9001
+ :snapshot_target)
8525
9002
  SENSITIVE = []
8526
9003
  include Aws::Structure
8527
9004
  end
@@ -8909,10 +9386,39 @@ module Aws::RDS
8909
9386
  end
8910
9387
 
8911
9388
  # @!attribute [rw] db_cluster
8912
- # Contains the details of an Amazon Aurora DB cluster.
9389
+ # Contains the details of an Amazon Aurora DB cluster or Multi-AZ DB
9390
+ # cluster.
8913
9391
  #
8914
- # This data type is used as a response element in the
8915
- # `DescribeDBClusters`, `StopDBCluster`, and `StartDBCluster` actions.
9392
+ # For an Amazon Aurora DB cluster, this data type is used as a
9393
+ # response element in the operations `CreateDBCluster`,
9394
+ # `DeleteDBCluster`, `DescribeDBClusters`, `FailoverDBCluster`,
9395
+ # `ModifyDBCluster`, `PromoteReadReplicaDBCluster`,
9396
+ # `RestoreDBClusterFromS3`, `RestoreDBClusterFromSnapshot`,
9397
+ # `RestoreDBClusterToPointInTime`, `StartDBCluster`, and
9398
+ # `StopDBCluster`.
9399
+ #
9400
+ # For a Multi-AZ DB cluster, this data type is used as a response
9401
+ # element in the operations `CreateDBCluster`, `DeleteDBCluster`,
9402
+ # `DescribeDBClusters`, `FailoverDBCluster`, `ModifyDBCluster`,
9403
+ # `RebootDBCluster`, `RestoreDBClusterFromSnapshot`, and
9404
+ # `RestoreDBClusterToPointInTime`.
9405
+ #
9406
+ # For more information on Amazon Aurora DB clusters, see [ What is
9407
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
9408
+ #
9409
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
9410
+ # deployments with two readable standby DB instances][2] in the
9411
+ # *Amazon RDS User Guide.*
9412
+ #
9413
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
9414
+ # change.
9415
+ #
9416
+ # </note>
9417
+ #
9418
+ #
9419
+ #
9420
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
9421
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
8916
9422
  # @return [Types::DBCluster]
8917
9423
  #
8918
9424
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBClusterResult AWS API Documentation
@@ -9093,8 +9599,13 @@ module Aws::RDS
9093
9599
  # @!attribute [rw] db_instance
9094
9600
  # Contains the details of an Amazon RDS DB instance.
9095
9601
  #
9096
- # This data type is used as a response element in the
9097
- # `DescribeDBInstances` action.
9602
+ # This data type is used as a response element in the operations
9603
+ # `CreateDBInstance`, `CreateDBInstanceReadReplica`,
9604
+ # `DeleteDBInstance`, `DescribeDBInstances`, `ModifyDBInstance`,
9605
+ # `PromoteReadReplica`, `RebootDBInstance`,
9606
+ # `RestoreDBInstanceFromDBSnapshot`, `RestoreDBInstanceFromS3`,
9607
+ # `RestoreDBInstanceToPointInTime`, `StartDBInstance`, and
9608
+ # `StopDBInstance`.
9098
9609
  # @return [Types::DBInstance]
9099
9610
  #
9100
9611
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBInstanceResult AWS API Documentation
@@ -11715,6 +12226,8 @@ module Aws::RDS
11715
12226
  #
11716
12227
  # * `failed`
11717
12228
  #
12229
+ # * `in_progress`
12230
+ #
11718
12231
  # * `starting`
11719
12232
  # @return [Array<Types::Filter>]
11720
12233
  #
@@ -13155,10 +13668,14 @@ module Aws::RDS
13155
13668
  # @return [String]
13156
13669
  #
13157
13670
  # @!attribute [rw] target_db_instance_identifier
13158
- # The name of the instance to promote to the primary instance.
13671
+ # The name of the DB instance to promote to the primary DB instance.
13672
+ #
13673
+ # Specify the DB instance identifier for an Aurora Replica or a
13674
+ # Multi-AZ readable standby in the DB cluster, for example
13675
+ # `mydbcluster-replica1`.
13159
13676
  #
13160
- # You must specify the instance identifier for an Aurora Replica in
13161
- # the DB cluster. For example, `mydbcluster-replica1`.
13677
+ # This setting isn't supported for RDS for MySQL Multi-AZ DB
13678
+ # clusters.
13162
13679
  # @return [String]
13163
13680
  #
13164
13681
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/FailoverDBClusterMessage AWS API Documentation
@@ -13171,10 +13688,39 @@ module Aws::RDS
13171
13688
  end
13172
13689
 
13173
13690
  # @!attribute [rw] db_cluster
13174
- # Contains the details of an Amazon Aurora DB cluster.
13691
+ # Contains the details of an Amazon Aurora DB cluster or Multi-AZ DB
13692
+ # cluster.
13175
13693
  #
13176
- # This data type is used as a response element in the
13177
- # `DescribeDBClusters`, `StopDBCluster`, and `StartDBCluster` actions.
13694
+ # For an Amazon Aurora DB cluster, this data type is used as a
13695
+ # response element in the operations `CreateDBCluster`,
13696
+ # `DeleteDBCluster`, `DescribeDBClusters`, `FailoverDBCluster`,
13697
+ # `ModifyDBCluster`, `PromoteReadReplicaDBCluster`,
13698
+ # `RestoreDBClusterFromS3`, `RestoreDBClusterFromSnapshot`,
13699
+ # `RestoreDBClusterToPointInTime`, `StartDBCluster`, and
13700
+ # `StopDBCluster`.
13701
+ #
13702
+ # For a Multi-AZ DB cluster, this data type is used as a response
13703
+ # element in the operations `CreateDBCluster`, `DeleteDBCluster`,
13704
+ # `DescribeDBClusters`, `FailoverDBCluster`, `ModifyDBCluster`,
13705
+ # `RebootDBCluster`, `RestoreDBClusterFromSnapshot`, and
13706
+ # `RestoreDBClusterToPointInTime`.
13707
+ #
13708
+ # For more information on Amazon Aurora DB clusters, see [ What is
13709
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
13710
+ #
13711
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
13712
+ # deployments with two readable standby DB instances][2] in the
13713
+ # *Amazon RDS User Guide.*
13714
+ #
13715
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
13716
+ # change.
13717
+ #
13718
+ # </note>
13719
+ #
13720
+ #
13721
+ #
13722
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
13723
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
13178
13724
  # @return [Types::DBCluster]
13179
13725
  #
13180
13726
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/FailoverDBClusterResult AWS API Documentation
@@ -14210,6 +14756,16 @@ module Aws::RDS
14210
14756
  # enable_http_endpoint: false,
14211
14757
  # copy_tags_to_snapshot: false,
14212
14758
  # enable_global_write_forwarding: false,
14759
+ # db_cluster_instance_class: "String",
14760
+ # allocated_storage: 1,
14761
+ # storage_type: "String",
14762
+ # iops: 1,
14763
+ # auto_minor_version_upgrade: false,
14764
+ # monitoring_interval: 1,
14765
+ # monitoring_role_arn: "String",
14766
+ # enable_performance_insights: false,
14767
+ # performance_insights_kms_key_id: "String",
14768
+ # performance_insights_retention_period: 1,
14213
14769
  # }
14214
14770
  #
14215
14771
  # @!attribute [rw] db_cluster_identifier
@@ -14218,6 +14774,8 @@ module Aws::RDS
14218
14774
  #
14219
14775
  # Constraints: This identifier must match the identifier of an
14220
14776
  # existing DB cluster.
14777
+ #
14778
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
14221
14779
  # @return [String]
14222
14780
  #
14223
14781
  # @!attribute [rw] new_db_cluster_identifier
@@ -14233,6 +14791,8 @@ module Aws::RDS
14233
14791
  # * Can't end with a hyphen or contain two consecutive hyphens
14234
14792
  #
14235
14793
  # Example: `my-cluster2`
14794
+ #
14795
+ # Valid for: Aurora DB clusters only
14236
14796
  # @return [String]
14237
14797
  #
14238
14798
  # @!attribute [rw] apply_immediately
@@ -14252,11 +14812,13 @@ module Aws::RDS
14252
14812
  # `ApplyImmediately` parameter.
14253
14813
  #
14254
14814
  # By default, this parameter is disabled.
14815
+ #
14816
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
14255
14817
  # @return [Boolean]
14256
14818
  #
14257
14819
  # @!attribute [rw] backup_retention_period
14258
- # The number of days for which automated backups are retained. You
14259
- # must specify a minimum value of 1.
14820
+ # The number of days for which automated backups are retained. Specify
14821
+ # a minimum value of 1.
14260
14822
  #
14261
14823
  # Default: 1
14262
14824
  #
@@ -14265,15 +14827,21 @@ module Aws::RDS
14265
14827
  # * Must be a value from 1 to 35
14266
14828
  #
14267
14829
  # ^
14830
+ #
14831
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
14268
14832
  # @return [Integer]
14269
14833
  #
14270
14834
  # @!attribute [rw] db_cluster_parameter_group_name
14271
14835
  # The name of the DB cluster parameter group to use for the DB
14272
14836
  # cluster.
14837
+ #
14838
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
14273
14839
  # @return [String]
14274
14840
  #
14275
14841
  # @!attribute [rw] vpc_security_group_ids
14276
14842
  # A list of VPC security groups that the DB cluster will belong to.
14843
+ #
14844
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
14277
14845
  # @return [Array<String>]
14278
14846
  #
14279
14847
  # @!attribute [rw] port
@@ -14282,6 +14850,8 @@ module Aws::RDS
14282
14850
  # Constraints: Value must be `1150-65535`
14283
14851
  #
14284
14852
  # Default: The same port as the original DB cluster.
14853
+ #
14854
+ # Valid for: Aurora DB clusters only
14285
14855
  # @return [Integer]
14286
14856
  #
14287
14857
  # @!attribute [rw] master_user_password
@@ -14290,21 +14860,16 @@ module Aws::RDS
14290
14860
  # "@".
14291
14861
  #
14292
14862
  # Constraints: Must contain from 8 to 41 characters.
14863
+ #
14864
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
14293
14865
  # @return [String]
14294
14866
  #
14295
14867
  # @!attribute [rw] option_group_name
14296
14868
  # A value that indicates that the DB cluster should be associated with
14297
- # the specified option group. Changing this parameter doesn't result
14298
- # in an outage except in the following case, and the change is applied
14299
- # during the next maintenance window unless the `ApplyImmediately` is
14300
- # enabled for this request. If the parameter change results in an
14301
- # option group that enables OEM, this change can cause a brief
14302
- # (sub-second) period during which new connections are rejected but
14303
- # existing connections are not interrupted.
14304
- #
14305
- # Permanent options can't be removed from an option group. The option
14306
- # group can't be removed from a DB cluster once it is associated with
14307
- # a DB cluster.
14869
+ # the specified option group.
14870
+ #
14871
+ # DB clusters are associated with a default option group that can't
14872
+ # be modified.
14308
14873
  # @return [String]
14309
14874
  #
14310
14875
  # @!attribute [rw] preferred_backup_window
@@ -14327,6 +14892,8 @@ module Aws::RDS
14327
14892
  #
14328
14893
  # * Must be at least 30 minutes.
14329
14894
  #
14895
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
14896
+ #
14330
14897
  #
14331
14898
  #
14332
14899
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Managing.Backups.html#Aurora.Managing.Backups.BackupWindow
@@ -14348,6 +14915,8 @@ module Aws::RDS
14348
14915
  #
14349
14916
  # Constraints: Minimum 30-minute window.
14350
14917
  #
14918
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
14919
+ #
14351
14920
  #
14352
14921
  #
14353
14922
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#AdjustingTheMaintenanceWindow.Aurora
@@ -14356,11 +14925,13 @@ module Aws::RDS
14356
14925
  # @!attribute [rw] enable_iam_database_authentication
14357
14926
  # A value that indicates whether to enable mapping of Amazon Web
14358
14927
  # Services Identity and Access Management (IAM) accounts to database
14359
- # accounts. By default, mapping is disabled.
14928
+ # accounts. By default, mapping isn't enabled.
14360
14929
  #
14361
14930
  # For more information, see [ IAM Database Authentication][1] in the
14362
14931
  # *Amazon Aurora User Guide.*
14363
14932
  #
14933
+ # Valid for: Aurora DB clusters only
14934
+ #
14364
14935
  #
14365
14936
  #
14366
14937
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.html
@@ -14370,10 +14941,6 @@ module Aws::RDS
14370
14941
  # The target backtrack window, in seconds. To disable backtracking,
14371
14942
  # set this value to 0.
14372
14943
  #
14373
- # <note markdown="1"> Currently, Backtrack is only supported for Aurora MySQL DB clusters.
14374
- #
14375
- # </note>
14376
- #
14377
14944
  # Default: 0
14378
14945
  #
14379
14946
  # Constraints:
@@ -14382,11 +14949,15 @@ module Aws::RDS
14382
14949
  # (72 hours).
14383
14950
  #
14384
14951
  # ^
14952
+ #
14953
+ # Valid for: Aurora MySQL DB clusters only
14385
14954
  # @return [Integer]
14386
14955
  #
14387
14956
  # @!attribute [rw] cloudwatch_logs_export_configuration
14388
14957
  # The configuration setting for the log types to be enabled for export
14389
14958
  # to CloudWatch Logs for a specific DB cluster.
14959
+ #
14960
+ # Valid for: Aurora DB clusters only
14390
14961
  # @return [Types::CloudwatchLogsExportConfiguration]
14391
14962
  #
14392
14963
  # @!attribute [rw] engine_version
@@ -14395,23 +14966,37 @@ module Aws::RDS
14395
14966
  # applied during the next maintenance window unless `ApplyImmediately`
14396
14967
  # is enabled.
14397
14968
  #
14398
- # To list all of the available engine versions for `aurora` (for MySQL
14399
- # 5.6-compatible Aurora), use the following command:
14969
+ # To list all of the available engine versions for MySQL
14970
+ # 5.6-compatible Aurora, use the following command:
14400
14971
  #
14401
14972
  # `aws rds describe-db-engine-versions --engine aurora --query
14402
14973
  # "DBEngineVersions[].EngineVersion"`
14403
14974
  #
14404
- # To list all of the available engine versions for `aurora-mysql` (for
14405
- # MySQL 5.7-compatible Aurora), use the following command:
14975
+ # To list all of the available engine versions for MySQL
14976
+ # 5.7-compatible Aurora, use the following command:
14406
14977
  #
14407
14978
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
14408
14979
  # "DBEngineVersions[].EngineVersion"`
14409
14980
  #
14410
- # To list all of the available engine versions for
14411
- # `aurora-postgresql`, use the following command:
14981
+ # To list all of the available engine versions for Aurora PostgreSQL,
14982
+ # use the following command:
14412
14983
  #
14413
14984
  # `aws rds describe-db-engine-versions --engine aurora-postgresql
14414
14985
  # --query "DBEngineVersions[].EngineVersion"`
14986
+ #
14987
+ # To list all of the available engine versions for RDS for MySQL, use
14988
+ # the following command:
14989
+ #
14990
+ # `aws rds describe-db-engine-versions --engine mysql --query
14991
+ # "DBEngineVersions[].EngineVersion"`
14992
+ #
14993
+ # To list all of the available engine versions for RDS for PostgreSQL,
14994
+ # use the following command:
14995
+ #
14996
+ # `aws rds describe-db-engine-versions --engine postgres --query
14997
+ # "DBEngineVersions[].EngineVersion"`
14998
+ #
14999
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
14415
15000
  # @return [String]
14416
15001
  #
14417
15002
  # @!attribute [rw] allow_major_version_upgrade
@@ -14420,6 +15005,8 @@ module Aws::RDS
14420
15005
  # Constraints: You must allow major version upgrades when specifying a
14421
15006
  # value for the `EngineVersion` parameter that is a different major
14422
15007
  # version than the DB cluster's current version.
15008
+ #
15009
+ # Valid for: Aurora DB clusters only
14423
15010
  # @return [Boolean]
14424
15011
  #
14425
15012
  # @!attribute [rw] db_instance_parameter_group_name
@@ -14443,6 +15030,8 @@ module Aws::RDS
14443
15030
  #
14444
15031
  # * The `DBInstanceParameterGroupName` parameter is only valid in
14445
15032
  # combination with the `AllowMajorVersionUpgrade` parameter.
15033
+ #
15034
+ # Valid for: Aurora DB clusters only
14446
15035
  # @return [String]
14447
15036
  #
14448
15037
  # @!attribute [rw] domain
@@ -14453,6 +15042,8 @@ module Aws::RDS
14453
15042
  # For more information, see [Kerberos Authentication][1] in the
14454
15043
  # *Amazon Aurora User Guide*.
14455
15044
  #
15045
+ # Valid for: Aurora DB clusters only
15046
+ #
14456
15047
  #
14457
15048
  #
14458
15049
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/kerberos-authentication.html
@@ -14461,17 +15052,24 @@ module Aws::RDS
14461
15052
  # @!attribute [rw] domain_iam_role_name
14462
15053
  # Specify the name of the IAM role to be used when making API calls to
14463
15054
  # the Directory Service.
15055
+ #
15056
+ # Valid for: Aurora DB clusters only
14464
15057
  # @return [String]
14465
15058
  #
14466
15059
  # @!attribute [rw] scaling_configuration
14467
15060
  # The scaling properties of the DB cluster. You can only modify
14468
15061
  # scaling properties for DB clusters in `serverless` DB engine mode.
15062
+ #
15063
+ # Valid for: Aurora DB clusters only
14469
15064
  # @return [Types::ScalingConfiguration]
14470
15065
  #
14471
15066
  # @!attribute [rw] deletion_protection
14472
15067
  # A value that indicates whether the DB cluster has deletion
14473
15068
  # protection enabled. The database can't be deleted when deletion
14474
- # protection is enabled. By default, deletion protection is disabled.
15069
+ # protection is enabled. By default, deletion protection isn't
15070
+ # enabled.
15071
+ #
15072
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
14475
15073
  # @return [Boolean]
14476
15074
  #
14477
15075
  # @!attribute [rw] enable_http_endpoint
@@ -14487,6 +15085,8 @@ module Aws::RDS
14487
15085
  # For more information, see [Using the Data API for Aurora
14488
15086
  # Serverless][1] in the *Amazon Aurora User Guide*.
14489
15087
  #
15088
+ # Valid for: Aurora DB clusters only
15089
+ #
14490
15090
  #
14491
15091
  #
14492
15092
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html
@@ -14495,6 +15095,8 @@ module Aws::RDS
14495
15095
  # @!attribute [rw] copy_tags_to_snapshot
14496
15096
  # A value that indicates whether to copy all tags from the DB cluster
14497
15097
  # to snapshots of the DB cluster. The default is not to copy them.
15098
+ #
15099
+ # Valid for: Aurora DB clusters only
14498
15100
  # @return [Boolean]
14499
15101
  #
14500
15102
  # @!attribute [rw] enable_global_write_forwarding
@@ -14511,8 +15113,142 @@ module Aws::RDS
14511
15113
  # the primary DB cluster of an Aurora global database, this value is
14512
15114
  # used immediately if the primary is demoted by the
14513
15115
  # FailoverGlobalCluster API operation, but it does nothing until then.
15116
+ #
15117
+ # Valid for: Aurora DB clusters only
15118
+ # @return [Boolean]
15119
+ #
15120
+ # @!attribute [rw] db_cluster_instance_class
15121
+ # The compute and memory capacity of each DB instance in the Multi-AZ
15122
+ # DB cluster, for example db.m6g.xlarge. Not all DB instance classes
15123
+ # are available in all Amazon Web Services Regions, or for all
15124
+ # database engines.
15125
+ #
15126
+ # For the full list of DB instance classes and availability for your
15127
+ # engine, see [DB Instance Class][1] in the *Amazon RDS User Guide.*
15128
+ #
15129
+ # Valid for: Multi-AZ DB clusters only
15130
+ #
15131
+ #
15132
+ #
15133
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html
15134
+ # @return [String]
15135
+ #
15136
+ # @!attribute [rw] allocated_storage
15137
+ # The amount of storage in gibibytes (GiB) to allocate to each DB
15138
+ # instance in the Multi-AZ DB cluster.
15139
+ #
15140
+ # Type: Integer
15141
+ #
15142
+ # Valid for: Multi-AZ DB clusters only
15143
+ # @return [Integer]
15144
+ #
15145
+ # @!attribute [rw] storage_type
15146
+ # Specifies the storage type to be associated with the DB cluster.
15147
+ #
15148
+ # Valid values: `standard | gp2 | io1`
15149
+ #
15150
+ # If you specify `io1`, you must also include a value for the `Iops`
15151
+ # parameter.
15152
+ #
15153
+ # Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
15154
+ #
15155
+ # Valid for: Multi-AZ DB clusters only
15156
+ # @return [String]
15157
+ #
15158
+ # @!attribute [rw] iops
15159
+ # The amount of Provisioned IOPS (input/output operations per second)
15160
+ # to be initially allocated for each DB instance in the Multi-AZ DB
15161
+ # cluster.
15162
+ #
15163
+ # For information about valid Iops values, see [Amazon RDS Provisioned
15164
+ # IOPS Storage to Improve Performance][1] in the *Amazon RDS User
15165
+ # Guide*.
15166
+ #
15167
+ # Constraints: Must be a multiple between .5 and 50 of the storage
15168
+ # amount for the DB cluster.
15169
+ #
15170
+ # Valid for: Multi-AZ DB clusters only
15171
+ #
15172
+ #
15173
+ #
15174
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html#USER_PIOPS
15175
+ # @return [Integer]
15176
+ #
15177
+ # @!attribute [rw] auto_minor_version_upgrade
15178
+ # A value that indicates whether minor engine upgrades are applied
15179
+ # automatically to the DB cluster during the maintenance window. By
15180
+ # default, minor engine upgrades are applied automatically.
15181
+ #
15182
+ # Valid for: Multi-AZ DB clusters only
15183
+ # @return [Boolean]
15184
+ #
15185
+ # @!attribute [rw] monitoring_interval
15186
+ # The interval, in seconds, between points when Enhanced Monitoring
15187
+ # metrics are collected for the DB cluster. To turn off collecting
15188
+ # Enhanced Monitoring metrics, specify 0. The default is 0.
15189
+ #
15190
+ # If `MonitoringRoleArn` is specified, also set `MonitoringInterval`
15191
+ # to a value other than 0.
15192
+ #
15193
+ # Valid Values: `0, 1, 5, 10, 15, 30, 60`
15194
+ #
15195
+ # Valid for: Multi-AZ DB clusters only
15196
+ # @return [Integer]
15197
+ #
15198
+ # @!attribute [rw] monitoring_role_arn
15199
+ # The Amazon Resource Name (ARN) for the IAM role that permits RDS to
15200
+ # send Enhanced Monitoring metrics to Amazon CloudWatch Logs. An
15201
+ # example is `arn:aws:iam:123456789012:role/emaccess`. For information
15202
+ # on creating a monitoring role, see [To create an IAM role for Amazon
15203
+ # RDS Enhanced Monitoring][1] in the *Amazon RDS User Guide.*
15204
+ #
15205
+ # If `MonitoringInterval` is set to a value other than 0, supply a
15206
+ # `MonitoringRoleArn` value.
15207
+ #
15208
+ # Valid for: Multi-AZ DB clusters only
15209
+ #
15210
+ #
15211
+ #
15212
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.html#USER_Monitoring.OS.IAMRole
15213
+ # @return [String]
15214
+ #
15215
+ # @!attribute [rw] enable_performance_insights
15216
+ # A value that indicates whether to turn on Performance Insights for
15217
+ # the DB cluster.
15218
+ #
15219
+ # For more information, see [ Using Amazon Performance Insights][1] in
15220
+ # the *Amazon RDS User Guide*.
15221
+ #
15222
+ # Valid for: Multi-AZ DB clusters only
15223
+ #
15224
+ #
15225
+ #
15226
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
14514
15227
  # @return [Boolean]
14515
15228
  #
15229
+ # @!attribute [rw] performance_insights_kms_key_id
15230
+ # The Amazon Web Services KMS key identifier for encryption of
15231
+ # Performance Insights data.
15232
+ #
15233
+ # The Amazon Web Services KMS key identifier is the key ARN, key ID,
15234
+ # alias ARN, or alias name for the KMS key.
15235
+ #
15236
+ # If you don't specify a value for `PerformanceInsightsKMSKeyId`,
15237
+ # then Amazon RDS uses your default KMS key. There is a default KMS
15238
+ # key for your Amazon Web Services account. Your Amazon Web Services
15239
+ # account has a different default KMS key for each Amazon Web Services
15240
+ # Region.
15241
+ #
15242
+ # Valid for: Multi-AZ DB clusters only
15243
+ # @return [String]
15244
+ #
15245
+ # @!attribute [rw] performance_insights_retention_period
15246
+ # The amount of time, in days, to retain Performance Insights data.
15247
+ # Valid values are 7 or 731 (2 years).
15248
+ #
15249
+ # Valid for: Multi-AZ DB clusters only
15250
+ # @return [Integer]
15251
+ #
14516
15252
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBClusterMessage AWS API Documentation
14517
15253
  #
14518
15254
  class ModifyDBClusterMessage < Struct.new(
@@ -14539,7 +15275,17 @@ module Aws::RDS
14539
15275
  :deletion_protection,
14540
15276
  :enable_http_endpoint,
14541
15277
  :copy_tags_to_snapshot,
14542
- :enable_global_write_forwarding)
15278
+ :enable_global_write_forwarding,
15279
+ :db_cluster_instance_class,
15280
+ :allocated_storage,
15281
+ :storage_type,
15282
+ :iops,
15283
+ :auto_minor_version_upgrade,
15284
+ :monitoring_interval,
15285
+ :monitoring_role_arn,
15286
+ :enable_performance_insights,
15287
+ :performance_insights_kms_key_id,
15288
+ :performance_insights_retention_period)
14543
15289
  SENSITIVE = []
14544
15290
  include Aws::Structure
14545
15291
  end
@@ -14600,10 +15346,39 @@ module Aws::RDS
14600
15346
  end
14601
15347
 
14602
15348
  # @!attribute [rw] db_cluster
14603
- # Contains the details of an Amazon Aurora DB cluster.
15349
+ # Contains the details of an Amazon Aurora DB cluster or Multi-AZ DB
15350
+ # cluster.
14604
15351
  #
14605
- # This data type is used as a response element in the
14606
- # `DescribeDBClusters`, `StopDBCluster`, and `StartDBCluster` actions.
15352
+ # For an Amazon Aurora DB cluster, this data type is used as a
15353
+ # response element in the operations `CreateDBCluster`,
15354
+ # `DeleteDBCluster`, `DescribeDBClusters`, `FailoverDBCluster`,
15355
+ # `ModifyDBCluster`, `PromoteReadReplicaDBCluster`,
15356
+ # `RestoreDBClusterFromS3`, `RestoreDBClusterFromSnapshot`,
15357
+ # `RestoreDBClusterToPointInTime`, `StartDBCluster`, and
15358
+ # `StopDBCluster`.
15359
+ #
15360
+ # For a Multi-AZ DB cluster, this data type is used as a response
15361
+ # element in the operations `CreateDBCluster`, `DeleteDBCluster`,
15362
+ # `DescribeDBClusters`, `FailoverDBCluster`, `ModifyDBCluster`,
15363
+ # `RebootDBCluster`, `RestoreDBClusterFromSnapshot`, and
15364
+ # `RestoreDBClusterToPointInTime`.
15365
+ #
15366
+ # For more information on Amazon Aurora DB clusters, see [ What is
15367
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
15368
+ #
15369
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
15370
+ # deployments with two readable standby DB instances][2] in the
15371
+ # *Amazon RDS User Guide.*
15372
+ #
15373
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
15374
+ # change.
15375
+ #
15376
+ # </note>
15377
+ #
15378
+ #
15379
+ #
15380
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
15381
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
14607
15382
  # @return [Types::DBCluster]
14608
15383
  #
14609
15384
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBClusterResult AWS API Documentation
@@ -14784,11 +15559,11 @@ module Aws::RDS
14784
15559
  # @return [Integer]
14785
15560
  #
14786
15561
  # @!attribute [rw] db_instance_class
14787
- # The new compute and memory capacity of the DB instance, for example,
14788
- # `db.m4.large`. Not all DB instance classes are available in all
14789
- # Amazon Web Services Regions, or for all database engines. For the
14790
- # full list of DB instance classes, and availability for your engine,
14791
- # see [DB Instance Class][1] in the *Amazon RDS User Guide*.
15562
+ # The new compute and memory capacity of the DB instance, for example
15563
+ # db.m4.large. Not all DB instance classes are available in all Amazon
15564
+ # Web Services Regions, or for all database engines. For the full list
15565
+ # of DB instance classes, and availability for your engine, see [DB
15566
+ # Instance Class][1] in the *Amazon RDS User Guide*.
14792
15567
  #
14793
15568
  # If you modify the DB instance class, an outage occurs during the
14794
15569
  # change. The change is applied during the next maintenance window,
@@ -15331,12 +16106,13 @@ module Aws::RDS
15331
16106
  # A value that indicates whether the DB instance is publicly
15332
16107
  # accessible.
15333
16108
  #
15334
- # When the DB instance is publicly accessible, its DNS endpoint
15335
- # resolves to the private IP address from within the DB instance's
15336
- # VPC, and to the public IP address from outside of the DB instance's
15337
- # VPC. Access to the DB instance is ultimately controlled by the
15338
- # security group it uses, and that public access is not permitted if
15339
- # the security group assigned to the DB instance doesn't permit it.
16109
+ # When the DB cluster is publicly accessible, its Domain Name System
16110
+ # (DNS) endpoint resolves to the private IP address from within the DB
16111
+ # cluster's virtual private cloud (VPC). It resolves to the public IP
16112
+ # address from outside of the DB cluster's VPC. Access to the DB
16113
+ # cluster is ultimately controlled by the security group it uses. That
16114
+ # public access isn't permitted if the security group assigned to the
16115
+ # DB cluster doesn't permit it.
15340
16116
  #
15341
16117
  # When the DB instance isn't publicly accessible, it is an internal
15342
16118
  # DB instance with a DNS name that resolves to a private IP address.
@@ -15396,7 +16172,7 @@ module Aws::RDS
15396
16172
  # @!attribute [rw] enable_iam_database_authentication
15397
16173
  # A value that indicates whether to enable mapping of Amazon Web
15398
16174
  # Services Identity and Access Management (IAM) accounts to database
15399
- # accounts. By default, mapping is disabled.
16175
+ # accounts. By default, mapping isn't enabled.
15400
16176
  #
15401
16177
  # This setting doesn't apply to Amazon Aurora. Mapping Amazon Web
15402
16178
  # Services IAM accounts to database accounts is managed by the DB
@@ -15478,8 +16254,8 @@ module Aws::RDS
15478
16254
  # @!attribute [rw] deletion_protection
15479
16255
  # A value that indicates whether the DB instance has deletion
15480
16256
  # protection enabled. The database can't be deleted when deletion
15481
- # protection is enabled. By default, deletion protection is disabled.
15482
- # For more information, see [ Deleting a DB Instance][1].
16257
+ # protection is enabled. By default, deletion protection isn't
16258
+ # enabled. For more information, see [ Deleting a DB Instance][1].
15483
16259
  #
15484
16260
  #
15485
16261
  #
@@ -15655,8 +16431,13 @@ module Aws::RDS
15655
16431
  # @!attribute [rw] db_instance
15656
16432
  # Contains the details of an Amazon RDS DB instance.
15657
16433
  #
15658
- # This data type is used as a response element in the
15659
- # `DescribeDBInstances` action.
16434
+ # This data type is used as a response element in the operations
16435
+ # `CreateDBInstance`, `CreateDBInstanceReadReplica`,
16436
+ # `DeleteDBInstance`, `DescribeDBInstances`, `ModifyDBInstance`,
16437
+ # `PromoteReadReplica`, `RebootDBInstance`,
16438
+ # `RestoreDBInstanceFromDBSnapshot`, `RestoreDBInstanceFromS3`,
16439
+ # `RestoreDBInstanceToPointInTime`, `StartDBInstance`, and
16440
+ # `StopDBInstance`.
15660
16441
  # @return [Types::DBInstance]
15661
16442
  #
15662
16443
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBInstanceResult AWS API Documentation
@@ -17051,6 +17832,21 @@ module Aws::RDS
17051
17832
  # with a specific combination of other DB engine attributes.
17052
17833
  # @return [Boolean]
17053
17834
  #
17835
+ # @!attribute [rw] supports_clusters
17836
+ # Whether DB instances can be configured as a Multi-AZ DB cluster.
17837
+ #
17838
+ # The Multi-AZ DB clusters feature is in preview and is subject to
17839
+ # change.
17840
+ #
17841
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
17842
+ # deployments with two readable standby DB instances][1] in the
17843
+ # *Amazon RDS User Guide.*
17844
+ #
17845
+ #
17846
+ #
17847
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
17848
+ # @return [Boolean]
17849
+ #
17054
17850
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/OrderableDBInstanceOption AWS API Documentation
17055
17851
  #
17056
17852
  class OrderableDBInstanceOption < Struct.new(
@@ -17081,7 +17877,8 @@ module Aws::RDS
17081
17877
  :supports_kerberos_authentication,
17082
17878
  :outpost_capable,
17083
17879
  :supported_activity_stream_modes,
17084
- :supports_global_databases)
17880
+ :supports_global_databases,
17881
+ :supports_clusters)
17085
17882
  SENSITIVE = []
17086
17883
  include Aws::Structure
17087
17884
  end
@@ -17547,10 +18344,39 @@ module Aws::RDS
17547
18344
  end
17548
18345
 
17549
18346
  # @!attribute [rw] db_cluster
17550
- # Contains the details of an Amazon Aurora DB cluster.
18347
+ # Contains the details of an Amazon Aurora DB cluster or Multi-AZ DB
18348
+ # cluster.
17551
18349
  #
17552
- # This data type is used as a response element in the
17553
- # `DescribeDBClusters`, `StopDBCluster`, and `StartDBCluster` actions.
18350
+ # For an Amazon Aurora DB cluster, this data type is used as a
18351
+ # response element in the operations `CreateDBCluster`,
18352
+ # `DeleteDBCluster`, `DescribeDBClusters`, `FailoverDBCluster`,
18353
+ # `ModifyDBCluster`, `PromoteReadReplicaDBCluster`,
18354
+ # `RestoreDBClusterFromS3`, `RestoreDBClusterFromSnapshot`,
18355
+ # `RestoreDBClusterToPointInTime`, `StartDBCluster`, and
18356
+ # `StopDBCluster`.
18357
+ #
18358
+ # For a Multi-AZ DB cluster, this data type is used as a response
18359
+ # element in the operations `CreateDBCluster`, `DeleteDBCluster`,
18360
+ # `DescribeDBClusters`, `FailoverDBCluster`, `ModifyDBCluster`,
18361
+ # `RebootDBCluster`, `RestoreDBClusterFromSnapshot`, and
18362
+ # `RestoreDBClusterToPointInTime`.
18363
+ #
18364
+ # For more information on Amazon Aurora DB clusters, see [ What is
18365
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
18366
+ #
18367
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
18368
+ # deployments with two readable standby DB instances][2] in the
18369
+ # *Amazon RDS User Guide.*
18370
+ #
18371
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
18372
+ # change.
18373
+ #
18374
+ # </note>
18375
+ #
18376
+ #
18377
+ #
18378
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
18379
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
17554
18380
  # @return [Types::DBCluster]
17555
18381
  #
17556
18382
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PromoteReadReplicaDBClusterResult AWS API Documentation
@@ -17636,8 +18462,13 @@ module Aws::RDS
17636
18462
  # @!attribute [rw] db_instance
17637
18463
  # Contains the details of an Amazon RDS DB instance.
17638
18464
  #
17639
- # This data type is used as a response element in the
17640
- # `DescribeDBInstances` action.
18465
+ # This data type is used as a response element in the operations
18466
+ # `CreateDBInstance`, `CreateDBInstanceReadReplica`,
18467
+ # `DeleteDBInstance`, `DescribeDBInstances`, `ModifyDBInstance`,
18468
+ # `PromoteReadReplica`, `RebootDBInstance`,
18469
+ # `RestoreDBInstanceFromDBSnapshot`, `RestoreDBInstanceFromS3`,
18470
+ # `RestoreDBInstanceToPointInTime`, `StartDBInstance`, and
18471
+ # `StopDBInstance`.
17641
18472
  # @return [Types::DBInstance]
17642
18473
  #
17643
18474
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PromoteReadReplicaResult AWS API Documentation
@@ -17749,6 +18580,76 @@ module Aws::RDS
17749
18580
  include Aws::Structure
17750
18581
  end
17751
18582
 
18583
+ # @note When making an API call, you may pass RebootDBClusterMessage
18584
+ # data as a hash:
18585
+ #
18586
+ # {
18587
+ # db_cluster_identifier: "String", # required
18588
+ # }
18589
+ #
18590
+ # @!attribute [rw] db_cluster_identifier
18591
+ # The DB cluster identifier. This parameter is stored as a lowercase
18592
+ # string.
18593
+ #
18594
+ # Constraints:
18595
+ #
18596
+ # * Must match the identifier of an existing DBCluster.
18597
+ #
18598
+ # ^
18599
+ # @return [String]
18600
+ #
18601
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RebootDBClusterMessage AWS API Documentation
18602
+ #
18603
+ class RebootDBClusterMessage < Struct.new(
18604
+ :db_cluster_identifier)
18605
+ SENSITIVE = []
18606
+ include Aws::Structure
18607
+ end
18608
+
18609
+ # @!attribute [rw] db_cluster
18610
+ # Contains the details of an Amazon Aurora DB cluster or Multi-AZ DB
18611
+ # cluster.
18612
+ #
18613
+ # For an Amazon Aurora DB cluster, this data type is used as a
18614
+ # response element in the operations `CreateDBCluster`,
18615
+ # `DeleteDBCluster`, `DescribeDBClusters`, `FailoverDBCluster`,
18616
+ # `ModifyDBCluster`, `PromoteReadReplicaDBCluster`,
18617
+ # `RestoreDBClusterFromS3`, `RestoreDBClusterFromSnapshot`,
18618
+ # `RestoreDBClusterToPointInTime`, `StartDBCluster`, and
18619
+ # `StopDBCluster`.
18620
+ #
18621
+ # For a Multi-AZ DB cluster, this data type is used as a response
18622
+ # element in the operations `CreateDBCluster`, `DeleteDBCluster`,
18623
+ # `DescribeDBClusters`, `FailoverDBCluster`, `ModifyDBCluster`,
18624
+ # `RebootDBCluster`, `RestoreDBClusterFromSnapshot`, and
18625
+ # `RestoreDBClusterToPointInTime`.
18626
+ #
18627
+ # For more information on Amazon Aurora DB clusters, see [ What is
18628
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
18629
+ #
18630
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
18631
+ # deployments with two readable standby DB instances][2] in the
18632
+ # *Amazon RDS User Guide.*
18633
+ #
18634
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
18635
+ # change.
18636
+ #
18637
+ # </note>
18638
+ #
18639
+ #
18640
+ #
18641
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
18642
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
18643
+ # @return [Types::DBCluster]
18644
+ #
18645
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RebootDBClusterResult AWS API Documentation
18646
+ #
18647
+ class RebootDBClusterResult < Struct.new(
18648
+ :db_cluster)
18649
+ SENSITIVE = []
18650
+ include Aws::Structure
18651
+ end
18652
+
17752
18653
  # @note When making an API call, you may pass RebootDBInstanceMessage
17753
18654
  # data as a hash:
17754
18655
  #
@@ -17788,8 +18689,13 @@ module Aws::RDS
17788
18689
  # @!attribute [rw] db_instance
17789
18690
  # Contains the details of an Amazon RDS DB instance.
17790
18691
  #
17791
- # This data type is used as a response element in the
17792
- # `DescribeDBInstances` action.
18692
+ # This data type is used as a response element in the operations
18693
+ # `CreateDBInstance`, `CreateDBInstanceReadReplica`,
18694
+ # `DeleteDBInstance`, `DescribeDBInstances`, `ModifyDBInstance`,
18695
+ # `PromoteReadReplica`, `RebootDBInstance`,
18696
+ # `RestoreDBInstanceFromDBSnapshot`, `RestoreDBInstanceFromS3`,
18697
+ # `RestoreDBInstanceToPointInTime`, `StartDBInstance`, and
18698
+ # `StopDBInstance`.
17793
18699
  # @return [Types::DBInstance]
17794
18700
  #
17795
18701
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RebootDBInstanceResult AWS API Documentation
@@ -18695,7 +19601,7 @@ module Aws::RDS
18695
19601
  # @!attribute [rw] enable_iam_database_authentication
18696
19602
  # A value that indicates whether to enable mapping of Amazon Web
18697
19603
  # Services Identity and Access Management (IAM) accounts to database
18698
- # accounts. By default, mapping is disabled.
19604
+ # accounts. By default, mapping isn't enabled.
18699
19605
  #
18700
19606
  # For more information, see [ IAM Database Authentication][1] in the
18701
19607
  # *Amazon Aurora User Guide.*
@@ -18770,7 +19676,8 @@ module Aws::RDS
18770
19676
  # @!attribute [rw] deletion_protection
18771
19677
  # A value that indicates whether the DB cluster has deletion
18772
19678
  # protection enabled. The database can't be deleted when deletion
18773
- # protection is enabled. By default, deletion protection is disabled.
19679
+ # protection is enabled. By default, deletion protection isn't
19680
+ # enabled.
18774
19681
  # @return [Boolean]
18775
19682
  #
18776
19683
  # @!attribute [rw] copy_tags_to_snapshot
@@ -18837,10 +19744,39 @@ module Aws::RDS
18837
19744
  end
18838
19745
 
18839
19746
  # @!attribute [rw] db_cluster
18840
- # Contains the details of an Amazon Aurora DB cluster.
19747
+ # Contains the details of an Amazon Aurora DB cluster or Multi-AZ DB
19748
+ # cluster.
18841
19749
  #
18842
- # This data type is used as a response element in the
18843
- # `DescribeDBClusters`, `StopDBCluster`, and `StartDBCluster` actions.
19750
+ # For an Amazon Aurora DB cluster, this data type is used as a
19751
+ # response element in the operations `CreateDBCluster`,
19752
+ # `DeleteDBCluster`, `DescribeDBClusters`, `FailoverDBCluster`,
19753
+ # `ModifyDBCluster`, `PromoteReadReplicaDBCluster`,
19754
+ # `RestoreDBClusterFromS3`, `RestoreDBClusterFromSnapshot`,
19755
+ # `RestoreDBClusterToPointInTime`, `StartDBCluster`, and
19756
+ # `StopDBCluster`.
19757
+ #
19758
+ # For a Multi-AZ DB cluster, this data type is used as a response
19759
+ # element in the operations `CreateDBCluster`, `DeleteDBCluster`,
19760
+ # `DescribeDBClusters`, `FailoverDBCluster`, `ModifyDBCluster`,
19761
+ # `RebootDBCluster`, `RestoreDBClusterFromSnapshot`, and
19762
+ # `RestoreDBClusterToPointInTime`.
19763
+ #
19764
+ # For more information on Amazon Aurora DB clusters, see [ What is
19765
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
19766
+ #
19767
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
19768
+ # deployments with two readable standby DB instances][2] in the
19769
+ # *Amazon RDS User Guide.*
19770
+ #
19771
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
19772
+ # change.
19773
+ #
19774
+ # </note>
19775
+ #
19776
+ #
19777
+ #
19778
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
19779
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
18844
19780
  # @return [Types::DBCluster]
18845
19781
  #
18846
19782
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBClusterFromS3Result AWS API Documentation
@@ -18889,11 +19825,17 @@ module Aws::RDS
18889
19825
  # copy_tags_to_snapshot: false,
18890
19826
  # domain: "String",
18891
19827
  # domain_iam_role_name: "String",
19828
+ # db_cluster_instance_class: "String",
19829
+ # storage_type: "String",
19830
+ # iops: 1,
19831
+ # publicly_accessible: false,
18892
19832
  # }
18893
19833
  #
18894
19834
  # @!attribute [rw] availability_zones
18895
19835
  # Provides the list of Availability Zones (AZs) where instances in the
18896
19836
  # restored DB cluster can be created.
19837
+ #
19838
+ # Valid for: Aurora DB clusters only
18897
19839
  # @return [Array<String>]
18898
19840
  #
18899
19841
  # @!attribute [rw] db_cluster_identifier
@@ -18909,6 +19851,8 @@ module Aws::RDS
18909
19851
  # * Can't end with a hyphen or contain two consecutive hyphens
18910
19852
  #
18911
19853
  # Example: `my-snapshot-id`
19854
+ #
19855
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18912
19856
  # @return [String]
18913
19857
  #
18914
19858
  # @!attribute [rw] snapshot_identifier
@@ -18924,6 +19868,8 @@ module Aws::RDS
18924
19868
  # * Must match the identifier of an existing Snapshot.
18925
19869
  #
18926
19870
  # ^
19871
+ #
19872
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18927
19873
  # @return [String]
18928
19874
  #
18929
19875
  # @!attribute [rw] engine
@@ -18932,42 +19878,71 @@ module Aws::RDS
18932
19878
  # Default: The same as source
18933
19879
  #
18934
19880
  # Constraint: Must be compatible with the engine of the source
19881
+ #
19882
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18935
19883
  # @return [String]
18936
19884
  #
18937
19885
  # @!attribute [rw] engine_version
18938
19886
  # The version of the database engine to use for the new DB cluster.
18939
19887
  #
18940
- # To list all of the available engine versions for `aurora` (for MySQL
18941
- # 5.6-compatible Aurora), use the following command:
19888
+ # To list all of the available engine versions for MySQL
19889
+ # 5.6-compatible Aurora, use the following command:
18942
19890
  #
18943
19891
  # `aws rds describe-db-engine-versions --engine aurora --query
18944
19892
  # "DBEngineVersions[].EngineVersion"`
18945
19893
  #
18946
- # To list all of the available engine versions for `aurora-mysql` (for
18947
- # MySQL 5.7-compatible Aurora), use the following command:
19894
+ # To list all of the available engine versions for MySQL
19895
+ # 5.7-compatible Aurora, use the following command:
18948
19896
  #
18949
19897
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
18950
19898
  # "DBEngineVersions[].EngineVersion"`
18951
19899
  #
18952
- # To list all of the available engine versions for
18953
- # `aurora-postgresql`, use the following command:
19900
+ # To list all of the available engine versions for Aurora PostgreSQL,
19901
+ # use the following command:
18954
19902
  #
18955
19903
  # `aws rds describe-db-engine-versions --engine aurora-postgresql
18956
19904
  # --query "DBEngineVersions[].EngineVersion"`
18957
19905
  #
18958
- # <note markdown="1"> If you aren't using the default engine version, then you must
18959
- # specify the engine version.
19906
+ # To list all of the available engine versions for RDS for MySQL, use
19907
+ # the following command:
18960
19908
  #
18961
- # </note>
19909
+ # `aws rds describe-db-engine-versions --engine mysql --query
19910
+ # "DBEngineVersions[].EngineVersion"`
19911
+ #
19912
+ # To list all of the available engine versions for RDS for PostgreSQL,
19913
+ # use the following command:
19914
+ #
19915
+ # `aws rds describe-db-engine-versions --engine postgres --query
19916
+ # "DBEngineVersions[].EngineVersion"`
18962
19917
  #
18963
19918
  # **Aurora MySQL**
18964
19919
  #
18965
- # Example: `5.6.10a`, `5.6.mysql_aurora.1.19.2`, `5.7.12`,
18966
- # `5.7.mysql_aurora.2.04.5`
19920
+ # See [MySQL on Amazon RDS Versions][1] in the *Amazon Aurora User
19921
+ # Guide.*
18967
19922
  #
18968
19923
  # **Aurora PostgreSQL**
18969
19924
  #
18970
- # Example: `9.6.3`, `10.7`
19925
+ # See [Amazon Aurora PostgreSQL releases and engine versions][2] in
19926
+ # the *Amazon Aurora User Guide.*
19927
+ #
19928
+ # **MySQL**
19929
+ #
19930
+ # See [MySQL on Amazon RDS Versions][3] in the *Amazon RDS User
19931
+ # Guide.*
19932
+ #
19933
+ # **PostgreSQL**
19934
+ #
19935
+ # See [Amazon RDS for PostgreSQL versions and extensions][4] in the
19936
+ # *Amazon RDS User Guide.*
19937
+ #
19938
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19939
+ #
19940
+ #
19941
+ #
19942
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Updates.html
19943
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Updates.20180305.html
19944
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
19945
+ # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
18971
19946
  # @return [String]
18972
19947
  #
18973
19948
  # @!attribute [rw] port
@@ -18976,6 +19951,8 @@ module Aws::RDS
18976
19951
  # Constraints: This value must be `1150-65535`
18977
19952
  #
18978
19953
  # Default: The same port as the original DB cluster.
19954
+ #
19955
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18979
19956
  # @return [Integer]
18980
19957
  #
18981
19958
  # @!attribute [rw] db_subnet_group_name
@@ -18985,23 +19962,34 @@ module Aws::RDS
18985
19962
  # subnet group.
18986
19963
  #
18987
19964
  # Example: `mySubnetgroup`
19965
+ #
19966
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18988
19967
  # @return [String]
18989
19968
  #
18990
19969
  # @!attribute [rw] database_name
18991
19970
  # The database name for the restored DB cluster.
19971
+ #
19972
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
18992
19973
  # @return [String]
18993
19974
  #
18994
19975
  # @!attribute [rw] option_group_name
18995
19976
  # The name of the option group to use for the restored DB cluster.
19977
+ #
19978
+ # DB clusters are associated with a default option group that can't
19979
+ # be modified.
18996
19980
  # @return [String]
18997
19981
  #
18998
19982
  # @!attribute [rw] vpc_security_group_ids
18999
19983
  # A list of VPC security groups that the new DB cluster will belong
19000
19984
  # to.
19985
+ #
19986
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19001
19987
  # @return [Array<String>]
19002
19988
  #
19003
19989
  # @!attribute [rw] tags
19004
19990
  # The tags to be assigned to the restored DB cluster.
19991
+ #
19992
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19005
19993
  # @return [Array<Types::Tag>]
19006
19994
  #
19007
19995
  # @!attribute [rw] kms_key_id
@@ -19023,16 +20011,20 @@ module Aws::RDS
19023
20011
  #
19024
20012
  # * If the DB snapshot or DB cluster snapshot in `SnapshotIdentifier`
19025
20013
  # isn't encrypted, then the restored DB cluster isn't encrypted.
20014
+ #
20015
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19026
20016
  # @return [String]
19027
20017
  #
19028
20018
  # @!attribute [rw] enable_iam_database_authentication
19029
20019
  # A value that indicates whether to enable mapping of Amazon Web
19030
20020
  # Services Identity and Access Management (IAM) accounts to database
19031
- # accounts. By default, mapping is disabled.
20021
+ # accounts. By default, mapping isn't enabled.
19032
20022
  #
19033
20023
  # For more information, see [ IAM Database Authentication][1] in the
19034
20024
  # *Amazon Aurora User Guide.*
19035
20025
  #
20026
+ # Valid for: Aurora DB clusters only
20027
+ #
19036
20028
  #
19037
20029
  #
19038
20030
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.html
@@ -19054,13 +20046,19 @@ module Aws::RDS
19054
20046
  # (72 hours).
19055
20047
  #
19056
20048
  # ^
20049
+ #
20050
+ # Valid for: Aurora DB clusters only
19057
20051
  # @return [Integer]
19058
20052
  #
19059
20053
  # @!attribute [rw] enable_cloudwatch_logs_exports
19060
20054
  # The list of logs that the restored DB cluster is to export to Amazon
19061
20055
  # CloudWatch Logs. The values in the list depend on the DB engine
19062
- # being used. For more information, see [Publishing Database Logs to
19063
- # Amazon CloudWatch Logs ][1] in the *Amazon Aurora User Guide*.
20056
+ # being used.
20057
+ #
20058
+ # For more information, see [Publishing Database Logs to Amazon
20059
+ # CloudWatch Logs ][1] in the *Amazon Aurora User Guide*.
20060
+ #
20061
+ # Valid for: Aurora DB clusters only
19064
20062
  #
19065
20063
  #
19066
20064
  #
@@ -19073,6 +20071,8 @@ module Aws::RDS
19073
20071
  #
19074
20072
  # For more information, see [ CreateDBCluster][1].
19075
20073
  #
20074
+ # Valid for: Aurora DB clusters only
20075
+ #
19076
20076
  #
19077
20077
  #
19078
20078
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html
@@ -19081,6 +20081,8 @@ module Aws::RDS
19081
20081
  # @!attribute [rw] scaling_configuration
19082
20082
  # For DB clusters in `serverless` DB engine mode, the scaling
19083
20083
  # properties of the DB cluster.
20084
+ #
20085
+ # Valid for: Aurora DB clusters only
19084
20086
  # @return [Types::ScalingConfiguration]
19085
20087
  #
19086
20088
  # @!attribute [rw] db_cluster_parameter_group_name
@@ -19098,18 +20100,25 @@ module Aws::RDS
19098
20100
  # * First character must be a letter.
19099
20101
  #
19100
20102
  # * Can't end with a hyphen or contain two consecutive hyphens.
20103
+ #
20104
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19101
20105
  # @return [String]
19102
20106
  #
19103
20107
  # @!attribute [rw] deletion_protection
19104
20108
  # A value that indicates whether the DB cluster has deletion
19105
20109
  # protection enabled. The database can't be deleted when deletion
19106
- # protection is enabled. By default, deletion protection is disabled.
20110
+ # protection is enabled. By default, deletion protection isn't
20111
+ # enabled.
20112
+ #
20113
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19107
20114
  # @return [Boolean]
19108
20115
  #
19109
20116
  # @!attribute [rw] copy_tags_to_snapshot
19110
20117
  # A value that indicates whether to copy all tags from the restored DB
19111
20118
  # cluster to snapshots of the restored DB cluster. The default is not
19112
20119
  # to copy them.
20120
+ #
20121
+ # Valid for: Aurora DB clusters only
19113
20122
  # @return [Boolean]
19114
20123
  #
19115
20124
  # @!attribute [rw] domain
@@ -19121,6 +20130,8 @@ module Aws::RDS
19121
20130
  # For more information, see [ Kerberos Authentication][1] in the
19122
20131
  # *Amazon RDS User Guide*.
19123
20132
  #
20133
+ # Valid for: Aurora DB clusters only
20134
+ #
19124
20135
  #
19125
20136
  #
19126
20137
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
@@ -19129,8 +20140,98 @@ module Aws::RDS
19129
20140
  # @!attribute [rw] domain_iam_role_name
19130
20141
  # Specify the name of the IAM role to be used when making API calls to
19131
20142
  # the Directory Service.
20143
+ #
20144
+ # Valid for: Aurora DB clusters only
20145
+ # @return [String]
20146
+ #
20147
+ # @!attribute [rw] db_cluster_instance_class
20148
+ # The compute and memory capacity of the each DB instance in the
20149
+ # Multi-AZ DB cluster, for example db.m6g.xlarge. Not all DB instance
20150
+ # classes are available in all Amazon Web Services Regions, or for all
20151
+ # database engines.
20152
+ #
20153
+ # For the full list of DB instance classes, and availability for your
20154
+ # engine, see [DB Instance Class][1] in the *Amazon RDS User Guide.*
20155
+ #
20156
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
20157
+ #
20158
+ #
20159
+ #
20160
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html
20161
+ # @return [String]
20162
+ #
20163
+ # @!attribute [rw] storage_type
20164
+ # Specifies the storage type to be associated with the each DB
20165
+ # instance in the Multi-AZ DB cluster.
20166
+ #
20167
+ # Valid values: `standard | gp2 | io1`
20168
+ #
20169
+ # If you specify `io1`, you must also include a value for the `Iops`
20170
+ # parameter.
20171
+ #
20172
+ # Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
20173
+ #
20174
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19132
20175
  # @return [String]
19133
20176
  #
20177
+ # @!attribute [rw] iops
20178
+ # The amount of Provisioned IOPS (input/output operations per second)
20179
+ # to be initially allocated for each DB instance in the Multi-AZ DB
20180
+ # cluster.
20181
+ #
20182
+ # For information about valid Iops values, see [Amazon RDS Provisioned
20183
+ # IOPS Storage to Improve Performance][1] in the *Amazon RDS User
20184
+ # Guide*.
20185
+ #
20186
+ # Constraints: Must be a multiple between .5 and 50 of the storage
20187
+ # amount for the DB instance.
20188
+ #
20189
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
20190
+ #
20191
+ #
20192
+ #
20193
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html#USER_PIOPS
20194
+ # @return [Integer]
20195
+ #
20196
+ # @!attribute [rw] publicly_accessible
20197
+ # A value that indicates whether the DB cluster is publicly
20198
+ # accessible.
20199
+ #
20200
+ # When the DB cluster is publicly accessible, its Domain Name System
20201
+ # (DNS) endpoint resolves to the private IP address from within the DB
20202
+ # cluster's virtual private cloud (VPC). It resolves to the public IP
20203
+ # address from outside of the DB cluster's VPC. Access to the DB
20204
+ # cluster is ultimately controlled by the security group it uses. That
20205
+ # public access is not permitted if the security group assigned to the
20206
+ # DB cluster doesn't permit it.
20207
+ #
20208
+ # When the DB cluster isn't publicly accessible, it is an internal DB
20209
+ # cluster with a DNS name that resolves to a private IP address.
20210
+ #
20211
+ # Default: The default behavior varies depending on whether
20212
+ # `DBSubnetGroupName` is specified.
20213
+ #
20214
+ # If `DBSubnetGroupName` isn't specified, and `PubliclyAccessible`
20215
+ # isn't specified, the following applies:
20216
+ #
20217
+ # * If the default VPC in the target Region doesn’t have an internet
20218
+ # gateway attached to it, the DB cluster is private.
20219
+ #
20220
+ # * If the default VPC in the target Region has an internet gateway
20221
+ # attached to it, the DB cluster is public.
20222
+ #
20223
+ # If `DBSubnetGroupName` is specified, and `PubliclyAccessible` isn't
20224
+ # specified, the following applies:
20225
+ #
20226
+ # * If the subnets are part of a VPC that doesn’t have an internet
20227
+ # gateway attached to it, the DB cluster is private.
20228
+ #
20229
+ # * If the subnets are part of a VPC that has an internet gateway
20230
+ # attached to it, the DB cluster is public.
20231
+ #
20232
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
20233
+ # @return [Boolean]
20234
+ #
19134
20235
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBClusterFromSnapshotMessage AWS API Documentation
19135
20236
  #
19136
20237
  class RestoreDBClusterFromSnapshotMessage < Struct.new(
@@ -19155,16 +20256,49 @@ module Aws::RDS
19155
20256
  :deletion_protection,
19156
20257
  :copy_tags_to_snapshot,
19157
20258
  :domain,
19158
- :domain_iam_role_name)
20259
+ :domain_iam_role_name,
20260
+ :db_cluster_instance_class,
20261
+ :storage_type,
20262
+ :iops,
20263
+ :publicly_accessible)
19159
20264
  SENSITIVE = []
19160
20265
  include Aws::Structure
19161
20266
  end
19162
20267
 
19163
20268
  # @!attribute [rw] db_cluster
19164
- # Contains the details of an Amazon Aurora DB cluster.
20269
+ # Contains the details of an Amazon Aurora DB cluster or Multi-AZ DB
20270
+ # cluster.
19165
20271
  #
19166
- # This data type is used as a response element in the
19167
- # `DescribeDBClusters`, `StopDBCluster`, and `StartDBCluster` actions.
20272
+ # For an Amazon Aurora DB cluster, this data type is used as a
20273
+ # response element in the operations `CreateDBCluster`,
20274
+ # `DeleteDBCluster`, `DescribeDBClusters`, `FailoverDBCluster`,
20275
+ # `ModifyDBCluster`, `PromoteReadReplicaDBCluster`,
20276
+ # `RestoreDBClusterFromS3`, `RestoreDBClusterFromSnapshot`,
20277
+ # `RestoreDBClusterToPointInTime`, `StartDBCluster`, and
20278
+ # `StopDBCluster`.
20279
+ #
20280
+ # For a Multi-AZ DB cluster, this data type is used as a response
20281
+ # element in the operations `CreateDBCluster`, `DeleteDBCluster`,
20282
+ # `DescribeDBClusters`, `FailoverDBCluster`, `ModifyDBCluster`,
20283
+ # `RebootDBCluster`, `RestoreDBClusterFromSnapshot`, and
20284
+ # `RestoreDBClusterToPointInTime`.
20285
+ #
20286
+ # For more information on Amazon Aurora DB clusters, see [ What is
20287
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
20288
+ #
20289
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
20290
+ # deployments with two readable standby DB instances][2] in the
20291
+ # *Amazon RDS User Guide.*
20292
+ #
20293
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
20294
+ # change.
20295
+ #
20296
+ # </note>
20297
+ #
20298
+ #
20299
+ #
20300
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
20301
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
19168
20302
  # @return [Types::DBCluster]
19169
20303
  #
19170
20304
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBClusterFromSnapshotResult AWS API Documentation
@@ -19212,6 +20346,10 @@ module Aws::RDS
19212
20346
  # seconds_before_timeout: 1,
19213
20347
  # },
19214
20348
  # engine_mode: "String",
20349
+ # db_cluster_instance_class: "String",
20350
+ # storage_type: "String",
20351
+ # publicly_accessible: false,
20352
+ # iops: 1,
19215
20353
  # }
19216
20354
  #
19217
20355
  # @!attribute [rw] db_cluster_identifier
@@ -19224,6 +20362,8 @@ module Aws::RDS
19224
20362
  # * First character must be a letter
19225
20363
  #
19226
20364
  # * Can't end with a hyphen or contain two consecutive hyphens
20365
+ #
20366
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19227
20367
  # @return [String]
19228
20368
  #
19229
20369
  # @!attribute [rw] restore_type
@@ -19241,6 +20381,8 @@ module Aws::RDS
19241
20381
  #
19242
20382
  # If you don't specify a `RestoreType` value, then the new DB cluster
19243
20383
  # is restored as a full copy of the source DB cluster.
20384
+ #
20385
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19244
20386
  # @return [String]
19245
20387
  #
19246
20388
  # @!attribute [rw] source_db_cluster_identifier
@@ -19251,6 +20393,8 @@ module Aws::RDS
19251
20393
  # * Must match the identifier of an existing DBCluster.
19252
20394
  #
19253
20395
  # ^
20396
+ #
20397
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19254
20398
  # @return [String]
19255
20399
  #
19256
20400
  # @!attribute [rw] restore_to_time
@@ -19273,6 +20417,8 @@ module Aws::RDS
19273
20417
  # `copy-on-write`
19274
20418
  #
19275
20419
  # Example: `2015-03-07T23:45:00Z`
20420
+ #
20421
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19276
20422
  # @return [Time]
19277
20423
  #
19278
20424
  # @!attribute [rw] use_latest_restorable_time
@@ -19282,6 +20428,8 @@ module Aws::RDS
19282
20428
  #
19283
20429
  # Constraints: Can't be specified if `RestoreToTime` parameter is
19284
20430
  # provided.
20431
+ #
20432
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19285
20433
  # @return [Boolean]
19286
20434
  #
19287
20435
  # @!attribute [rw] port
@@ -19290,6 +20438,8 @@ module Aws::RDS
19290
20438
  # Constraints: A value from `1150-65535`.
19291
20439
  #
19292
20440
  # Default: The default port for the engine.
20441
+ #
20442
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19293
20443
  # @return [Integer]
19294
20444
  #
19295
20445
  # @!attribute [rw] db_subnet_group_name
@@ -19299,14 +20449,21 @@ module Aws::RDS
19299
20449
  # DBSubnetGroup.
19300
20450
  #
19301
20451
  # Example: `mySubnetgroup`
20452
+ #
20453
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19302
20454
  # @return [String]
19303
20455
  #
19304
20456
  # @!attribute [rw] option_group_name
19305
20457
  # The name of the option group for the new DB cluster.
20458
+ #
20459
+ # DB clusters are associated with a default option group that can't
20460
+ # be modified.
19306
20461
  # @return [String]
19307
20462
  #
19308
20463
  # @!attribute [rw] vpc_security_group_ids
19309
20464
  # A list of VPC security groups that the new DB cluster belongs to.
20465
+ #
20466
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19310
20467
  # @return [Array<String>]
19311
20468
  #
19312
20469
  # @!attribute [rw] tags
@@ -19344,16 +20501,20 @@ module Aws::RDS
19344
20501
  #
19345
20502
  # If `DBClusterIdentifier` refers to a DB cluster that isn't
19346
20503
  # encrypted, then the restore request is rejected.
20504
+ #
20505
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19347
20506
  # @return [String]
19348
20507
  #
19349
20508
  # @!attribute [rw] enable_iam_database_authentication
19350
20509
  # A value that indicates whether to enable mapping of Amazon Web
19351
20510
  # Services Identity and Access Management (IAM) accounts to database
19352
- # accounts. By default, mapping is disabled.
20511
+ # accounts. By default, mapping isn't enabled.
19353
20512
  #
19354
20513
  # For more information, see [ IAM Database Authentication][1] in the
19355
20514
  # *Amazon Aurora User Guide.*
19356
20515
  #
20516
+ # Valid for: Aurora DB clusters only
20517
+ #
19357
20518
  #
19358
20519
  #
19359
20520
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.html
@@ -19363,10 +20524,6 @@ module Aws::RDS
19363
20524
  # The target backtrack window, in seconds. To disable backtracking,
19364
20525
  # set this value to 0.
19365
20526
  #
19366
- # <note markdown="1"> Currently, Backtrack is only supported for Aurora MySQL DB clusters.
19367
- #
19368
- # </note>
19369
- #
19370
20527
  # Default: 0
19371
20528
  #
19372
20529
  # Constraints:
@@ -19375,13 +20532,19 @@ module Aws::RDS
19375
20532
  # (72 hours).
19376
20533
  #
19377
20534
  # ^
20535
+ #
20536
+ # Valid for: Aurora MySQL DB clusters only
19378
20537
  # @return [Integer]
19379
20538
  #
19380
20539
  # @!attribute [rw] enable_cloudwatch_logs_exports
19381
20540
  # The list of logs that the restored DB cluster is to export to
19382
20541
  # CloudWatch Logs. The values in the list depend on the DB engine
19383
- # being used. For more information, see [Publishing Database Logs to
19384
- # Amazon CloudWatch Logs][1] in the *Amazon Aurora User Guide*.
20542
+ # being used.
20543
+ #
20544
+ # For more information, see [Publishing Database Logs to Amazon
20545
+ # CloudWatch Logs][1] in the *Amazon Aurora User Guide*.
20546
+ #
20547
+ # Valid for: Aurora DB clusters only
19385
20548
  #
19386
20549
  #
19387
20550
  #
@@ -19403,18 +20566,25 @@ module Aws::RDS
19403
20566
  # * First character must be a letter.
19404
20567
  #
19405
20568
  # * Can't end with a hyphen or contain two consecutive hyphens.
20569
+ #
20570
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19406
20571
  # @return [String]
19407
20572
  #
19408
20573
  # @!attribute [rw] deletion_protection
19409
20574
  # A value that indicates whether the DB cluster has deletion
19410
20575
  # protection enabled. The database can't be deleted when deletion
19411
- # protection is enabled. By default, deletion protection is disabled.
20576
+ # protection is enabled. By default, deletion protection isn't
20577
+ # enabled.
20578
+ #
20579
+ # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19412
20580
  # @return [Boolean]
19413
20581
  #
19414
20582
  # @!attribute [rw] copy_tags_to_snapshot
19415
20583
  # A value that indicates whether to copy all tags from the restored DB
19416
20584
  # cluster to snapshots of the restored DB cluster. The default is not
19417
20585
  # to copy them.
20586
+ #
20587
+ # Valid for: Aurora DB clusters only
19418
20588
  # @return [Boolean]
19419
20589
  #
19420
20590
  # @!attribute [rw] domain
@@ -19426,6 +20596,8 @@ module Aws::RDS
19426
20596
  # For more information, see [Kerberos Authentication][1] in the
19427
20597
  # *Amazon Aurora User Guide*.
19428
20598
  #
20599
+ # Valid for: Aurora DB clusters only
20600
+ #
19429
20601
  #
19430
20602
  #
19431
20603
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/kerberos-authentication.html
@@ -19434,11 +20606,15 @@ module Aws::RDS
19434
20606
  # @!attribute [rw] domain_iam_role_name
19435
20607
  # Specify the name of the IAM role to be used when making API calls to
19436
20608
  # the Directory Service.
20609
+ #
20610
+ # Valid for: Aurora DB clusters only
19437
20611
  # @return [String]
19438
20612
  #
19439
20613
  # @!attribute [rw] scaling_configuration
19440
20614
  # For DB clusters in `serverless` DB engine mode, the scaling
19441
20615
  # properties of the DB cluster.
20616
+ #
20617
+ # Valid for: Aurora DB clusters only
19442
20618
  # @return [Types::ScalingConfiguration]
19443
20619
  #
19444
20620
  # @!attribute [rw] engine_mode
@@ -19449,8 +20625,97 @@ module Aws::RDS
19449
20625
  # To create a clone that is an Aurora Serverless cluster, the original
19450
20626
  # cluster must be an Aurora Serverless cluster or an encrypted
19451
20627
  # provisioned cluster.
20628
+ #
20629
+ # Valid for: Aurora DB clusters only
20630
+ # @return [String]
20631
+ #
20632
+ # @!attribute [rw] db_cluster_instance_class
20633
+ # The compute and memory capacity of the each DB instance in the
20634
+ # Multi-AZ DB cluster, for example db.m6g.xlarge. Not all DB instance
20635
+ # classes are available in all Amazon Web Services Regions, or for all
20636
+ # database engines.
20637
+ #
20638
+ # For the full list of DB instance classes, and availability for your
20639
+ # engine, see [DB instance class][1] in the *Amazon RDS User Guide.*
20640
+ #
20641
+ # Valid for: Multi-AZ DB clusters only
20642
+ #
20643
+ #
20644
+ #
20645
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html
19452
20646
  # @return [String]
19453
20647
  #
20648
+ # @!attribute [rw] storage_type
20649
+ # Specifies the storage type to be associated with the each DB
20650
+ # instance in the Multi-AZ DB cluster.
20651
+ #
20652
+ # Valid values: `standard | gp2 | io1`
20653
+ #
20654
+ # If you specify `io1`, also include a value for the `Iops` parameter.
20655
+ #
20656
+ # Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
20657
+ #
20658
+ # Valid for: Multi-AZ DB clusters only
20659
+ # @return [String]
20660
+ #
20661
+ # @!attribute [rw] publicly_accessible
20662
+ # A value that indicates whether the DB cluster is publicly
20663
+ # accessible.
20664
+ #
20665
+ # When the DB cluster is publicly accessible, its Domain Name System
20666
+ # (DNS) endpoint resolves to the private IP address from within the DB
20667
+ # cluster's virtual private cloud (VPC). It resolves to the public IP
20668
+ # address from outside of the DB cluster's VPC. Access to the DB
20669
+ # cluster is ultimately controlled by the security group it uses. That
20670
+ # public access is not permitted if the security group assigned to the
20671
+ # DB cluster doesn't permit it.
20672
+ #
20673
+ # When the DB cluster isn't publicly accessible, it is an internal DB
20674
+ # cluster with a DNS name that resolves to a private IP address.
20675
+ #
20676
+ # Default: The default behavior varies depending on whether
20677
+ # `DBSubnetGroupName` is specified.
20678
+ #
20679
+ # If `DBSubnetGroupName` isn't specified, and `PubliclyAccessible`
20680
+ # isn't specified, the following applies:
20681
+ #
20682
+ # * If the default VPC in the target Region doesn’t have an internet
20683
+ # gateway attached to it, the DB cluster is private.
20684
+ #
20685
+ # * If the default VPC in the target Region has an internet gateway
20686
+ # attached to it, the DB cluster is public.
20687
+ #
20688
+ # If `DBSubnetGroupName` is specified, and `PubliclyAccessible` isn't
20689
+ # specified, the following applies:
20690
+ #
20691
+ # * If the subnets are part of a VPC that doesn’t have an internet
20692
+ # gateway attached to it, the DB cluster is private.
20693
+ #
20694
+ # * If the subnets are part of a VPC that has an internet gateway
20695
+ # attached to it, the DB cluster is public.
20696
+ #
20697
+ # Valid for: Multi-AZ DB clusters only
20698
+ # @return [Boolean]
20699
+ #
20700
+ # @!attribute [rw] iops
20701
+ # The amount of Provisioned IOPS (input/output operations per second)
20702
+ # to be initially allocated for each DB instance in the Multi-AZ DB
20703
+ # cluster.
20704
+ #
20705
+ # For information about valid `Iops` values, see [Amazon RDS
20706
+ # Provisioned IOPS storage to improve performance][1] in the *Amazon
20707
+ # RDS User Guide*.
20708
+ #
20709
+ # Constraints: Must be a multiple between .5 and 50 of the storage
20710
+ # amount for the DB instance.
20711
+ #
20712
+ # Valid for: Multi-AZ DB clusters only
20713
+ #
20714
+ #
20715
+ #
20716
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html#USER_PIOPS
20717
+ # @return [Integer]
20718
+ #
19454
20719
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBClusterToPointInTimeMessage AWS API Documentation
19455
20720
  #
19456
20721
  class RestoreDBClusterToPointInTimeMessage < Struct.new(
@@ -19474,16 +20739,49 @@ module Aws::RDS
19474
20739
  :domain,
19475
20740
  :domain_iam_role_name,
19476
20741
  :scaling_configuration,
19477
- :engine_mode)
20742
+ :engine_mode,
20743
+ :db_cluster_instance_class,
20744
+ :storage_type,
20745
+ :publicly_accessible,
20746
+ :iops)
19478
20747
  SENSITIVE = []
19479
20748
  include Aws::Structure
19480
20749
  end
19481
20750
 
19482
20751
  # @!attribute [rw] db_cluster
19483
- # Contains the details of an Amazon Aurora DB cluster.
20752
+ # Contains the details of an Amazon Aurora DB cluster or Multi-AZ DB
20753
+ # cluster.
19484
20754
  #
19485
- # This data type is used as a response element in the
19486
- # `DescribeDBClusters`, `StopDBCluster`, and `StartDBCluster` actions.
20755
+ # For an Amazon Aurora DB cluster, this data type is used as a
20756
+ # response element in the operations `CreateDBCluster`,
20757
+ # `DeleteDBCluster`, `DescribeDBClusters`, `FailoverDBCluster`,
20758
+ # `ModifyDBCluster`, `PromoteReadReplicaDBCluster`,
20759
+ # `RestoreDBClusterFromS3`, `RestoreDBClusterFromSnapshot`,
20760
+ # `RestoreDBClusterToPointInTime`, `StartDBCluster`, and
20761
+ # `StopDBCluster`.
20762
+ #
20763
+ # For a Multi-AZ DB cluster, this data type is used as a response
20764
+ # element in the operations `CreateDBCluster`, `DeleteDBCluster`,
20765
+ # `DescribeDBClusters`, `FailoverDBCluster`, `ModifyDBCluster`,
20766
+ # `RebootDBCluster`, `RestoreDBClusterFromSnapshot`, and
20767
+ # `RestoreDBClusterToPointInTime`.
20768
+ #
20769
+ # For more information on Amazon Aurora DB clusters, see [ What is
20770
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
20771
+ #
20772
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
20773
+ # deployments with two readable standby DB instances][2] in the
20774
+ # *Amazon RDS User Guide.*
20775
+ #
20776
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
20777
+ # change.
20778
+ #
20779
+ # </note>
20780
+ #
20781
+ #
20782
+ #
20783
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
20784
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
19487
20785
  # @return [Types::DBCluster]
19488
20786
  #
19489
20787
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBClusterToPointInTimeResult AWS API Documentation
@@ -19538,6 +20836,7 @@ module Aws::RDS
19538
20836
  # deletion_protection: false,
19539
20837
  # enable_customer_owned_ip: false,
19540
20838
  # custom_iam_instance_profile: "String",
20839
+ # backup_target: "String",
19541
20840
  # }
19542
20841
  #
19543
20842
  # @!attribute [rw] db_instance_identifier
@@ -19568,7 +20867,7 @@ module Aws::RDS
19568
20867
  #
19569
20868
  # @!attribute [rw] db_instance_class
19570
20869
  # The compute and memory capacity of the Amazon RDS DB instance, for
19571
- # example, `db.m4.large`. Not all DB instance classes are available in
20870
+ # example db.m4.large. Not all DB instance classes are available in
19572
20871
  # all Amazon Web Services Regions, or for all database engines. For
19573
20872
  # the full list of DB instance classes, and availability for your
19574
20873
  # engine, see [DB Instance Class][1] in the *Amazon RDS User Guide.*
@@ -19622,12 +20921,13 @@ module Aws::RDS
19622
20921
  # A value that indicates whether the DB instance is publicly
19623
20922
  # accessible.
19624
20923
  #
19625
- # When the DB instance is publicly accessible, its DNS endpoint
19626
- # resolves to the private IP address from within the DB instance's
19627
- # VPC, and to the public IP address from outside of the DB instance's
19628
- # VPC. Access to the DB instance is ultimately controlled by the
19629
- # security group it uses, and that public access is not permitted if
19630
- # the security group assigned to the DB instance doesn't permit it.
20924
+ # When the DB instance is publicly accessible, its Domain Name System
20925
+ # (DNS) endpoint resolves to the private IP address from within the DB
20926
+ # instance's virtual private cloud (VPC). It resolves to the public
20927
+ # IP address from outside of the DB instance's VPC. Access to the DB
20928
+ # instance is ultimately controlled by the security group it uses.
20929
+ # That public access is not permitted if the security group assigned
20930
+ # to the DB instance doesn't permit it.
19631
20931
  #
19632
20932
  # When the DB instance isn't publicly accessible, it is an internal
19633
20933
  # DB instance with a DNS name that resolves to a private IP address.
@@ -19866,8 +21166,8 @@ module Aws::RDS
19866
21166
  # @!attribute [rw] deletion_protection
19867
21167
  # A value that indicates whether the DB instance has deletion
19868
21168
  # protection enabled. The database can't be deleted when deletion
19869
- # protection is enabled. By default, deletion protection is disabled.
19870
- # For more information, see [ Deleting a DB Instance][1].
21169
+ # protection is enabled. By default, deletion protection isn't
21170
+ # enabled. For more information, see [ Deleting a DB Instance][1].
19871
21171
  #
19872
21172
  #
19873
21173
  #
@@ -19923,6 +21223,21 @@ module Aws::RDS
19923
21223
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
19924
21224
  # @return [String]
19925
21225
  #
21226
+ # @!attribute [rw] backup_target
21227
+ # Specifies where automated backups and manual snapshots are stored
21228
+ # for the restored DB instance.
21229
+ #
21230
+ # Possible values are `outposts` (Amazon Web Services Outposts) and
21231
+ # `region` (Amazon Web Services Region). The default is `region`.
21232
+ #
21233
+ # For more information, see [Working with Amazon RDS on Amazon Web
21234
+ # Services Outposts][1] in the *Amazon RDS User Guide*.
21235
+ #
21236
+ #
21237
+ #
21238
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
21239
+ # @return [String]
21240
+ #
19926
21241
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromDBSnapshotMessage AWS API Documentation
19927
21242
  #
19928
21243
  class RestoreDBInstanceFromDBSnapshotMessage < Struct.new(
@@ -19955,7 +21270,8 @@ module Aws::RDS
19955
21270
  :db_parameter_group_name,
19956
21271
  :deletion_protection,
19957
21272
  :enable_customer_owned_ip,
19958
- :custom_iam_instance_profile)
21273
+ :custom_iam_instance_profile,
21274
+ :backup_target)
19959
21275
  SENSITIVE = []
19960
21276
  include Aws::Structure
19961
21277
  end
@@ -19963,8 +21279,13 @@ module Aws::RDS
19963
21279
  # @!attribute [rw] db_instance
19964
21280
  # Contains the details of an Amazon RDS DB instance.
19965
21281
  #
19966
- # This data type is used as a response element in the
19967
- # `DescribeDBInstances` action.
21282
+ # This data type is used as a response element in the operations
21283
+ # `CreateDBInstance`, `CreateDBInstanceReadReplica`,
21284
+ # `DeleteDBInstance`, `DescribeDBInstances`, `ModifyDBInstance`,
21285
+ # `PromoteReadReplica`, `RebootDBInstance`,
21286
+ # `RestoreDBInstanceFromDBSnapshot`, `RestoreDBInstanceFromS3`,
21287
+ # `RestoreDBInstanceToPointInTime`, `StartDBInstance`, and
21288
+ # `StopDBInstance`.
19968
21289
  # @return [Types::DBInstance]
19969
21290
  #
19970
21291
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromDBSnapshotResult AWS API Documentation
@@ -20068,11 +21389,11 @@ module Aws::RDS
20068
21389
  # @return [Integer]
20069
21390
  #
20070
21391
  # @!attribute [rw] db_instance_class
20071
- # The compute and memory capacity of the DB instance, for example,
20072
- # `db.m4.large`. Not all DB instance classes are available in all
20073
- # Amazon Web Services Regions, or for all database engines. For the
20074
- # full list of DB instance classes, and availability for your engine,
20075
- # see [DB Instance Class][1] in the *Amazon RDS User Guide.*
21392
+ # The compute and memory capacity of the DB instance, for example
21393
+ # db.m4.large. Not all DB instance classes are available in all Amazon
21394
+ # Web Services Regions, or for all database engines. For the full list
21395
+ # of DB instance classes, and availability for your engine, see [DB
21396
+ # Instance Class][1] in the *Amazon RDS User Guide.*
20076
21397
  #
20077
21398
  # Importing from Amazon S3 isn't supported on the db.t2.micro DB
20078
21399
  # instance class.
@@ -20253,12 +21574,13 @@ module Aws::RDS
20253
21574
  # A value that indicates whether the DB instance is publicly
20254
21575
  # accessible.
20255
21576
  #
20256
- # When the DB instance is publicly accessible, its DNS endpoint
20257
- # resolves to the private IP address from within the DB instance's
20258
- # VPC, and to the public IP address from outside of the DB instance's
20259
- # VPC. Access to the DB instance is ultimately controlled by the
20260
- # security group it uses, and that public access is not permitted if
20261
- # the security group assigned to the DB instance doesn't permit it.
21577
+ # When the DB instance is publicly accessible, its Domain Name System
21578
+ # (DNS) endpoint resolves to the private IP address from within the DB
21579
+ # instance's virtual private cloud (VPC). It resolves to the public
21580
+ # IP address from outside of the DB instance's VPC. Access to the DB
21581
+ # instance is ultimately controlled by the security group it uses.
21582
+ # That public access is not permitted if the security group assigned
21583
+ # to the DB instance doesn't permit it.
20262
21584
  #
20263
21585
  # When the DB instance isn't publicly accessible, it is an internal
20264
21586
  # DB instance with a DNS name that resolves to a private IP address.
@@ -20344,7 +21666,7 @@ module Aws::RDS
20344
21666
  # @!attribute [rw] enable_iam_database_authentication
20345
21667
  # A value that indicates whether to enable mapping of Amazon Web
20346
21668
  # Services Identity and Access Management (IAM) accounts to database
20347
- # accounts. By default, mapping is disabled.
21669
+ # accounts. By default, mapping isn't enabled.
20348
21670
  #
20349
21671
  # For more information about IAM database authentication, see [ IAM
20350
21672
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
@@ -20438,8 +21760,8 @@ module Aws::RDS
20438
21760
  # @!attribute [rw] deletion_protection
20439
21761
  # A value that indicates whether the DB instance has deletion
20440
21762
  # protection enabled. The database can't be deleted when deletion
20441
- # protection is enabled. By default, deletion protection is disabled.
20442
- # For more information, see [ Deleting a DB Instance][1].
21763
+ # protection is enabled. By default, deletion protection isn't
21764
+ # enabled. For more information, see [ Deleting a DB Instance][1].
20443
21765
  #
20444
21766
  #
20445
21767
  #
@@ -20513,8 +21835,13 @@ module Aws::RDS
20513
21835
  # @!attribute [rw] db_instance
20514
21836
  # Contains the details of an Amazon RDS DB instance.
20515
21837
  #
20516
- # This data type is used as a response element in the
20517
- # `DescribeDBInstances` action.
21838
+ # This data type is used as a response element in the operations
21839
+ # `CreateDBInstance`, `CreateDBInstanceReadReplica`,
21840
+ # `DeleteDBInstance`, `DescribeDBInstances`, `ModifyDBInstance`,
21841
+ # `PromoteReadReplica`, `RebootDBInstance`,
21842
+ # `RestoreDBInstanceFromDBSnapshot`, `RestoreDBInstanceFromS3`,
21843
+ # `RestoreDBInstanceToPointInTime`, `StartDBInstance`, and
21844
+ # `StopDBInstance`.
20518
21845
  # @return [Types::DBInstance]
20519
21846
  #
20520
21847
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromS3Result AWS API Documentation
@@ -20574,6 +21901,7 @@ module Aws::RDS
20574
21901
  # source_db_instance_automated_backups_arn: "String",
20575
21902
  # enable_customer_owned_ip: false,
20576
21903
  # custom_iam_instance_profile: "String",
21904
+ # backup_target: "String",
20577
21905
  # }
20578
21906
  #
20579
21907
  # @!attribute [rw] source_db_instance_identifier
@@ -20625,7 +21953,7 @@ module Aws::RDS
20625
21953
  #
20626
21954
  # @!attribute [rw] db_instance_class
20627
21955
  # The compute and memory capacity of the Amazon RDS DB instance, for
20628
- # example, `db.m4.large`. Not all DB instance classes are available in
21956
+ # example db.m4.large. Not all DB instance classes are available in
20629
21957
  # all Amazon Web Services Regions, or for all database engines. For
20630
21958
  # the full list of DB instance classes, and availability for your
20631
21959
  # engine, see [DB Instance Class][1] in the *Amazon RDS User Guide.*
@@ -20679,12 +22007,13 @@ module Aws::RDS
20679
22007
  # A value that indicates whether the DB instance is publicly
20680
22008
  # accessible.
20681
22009
  #
20682
- # When the DB instance is publicly accessible, its DNS endpoint
20683
- # resolves to the private IP address from within the DB instance's
20684
- # VPC, and to the public IP address from outside of the DB instance's
20685
- # VPC. Access to the DB instance is ultimately controlled by the
20686
- # security group it uses, and that public access is not permitted if
20687
- # the security group assigned to the DB instance doesn't permit it.
22010
+ # When the DB cluster is publicly accessible, its Domain Name System
22011
+ # (DNS) endpoint resolves to the private IP address from within the DB
22012
+ # cluster's virtual private cloud (VPC). It resolves to the public IP
22013
+ # address from outside of the DB cluster's VPC. Access to the DB
22014
+ # cluster is ultimately controlled by the security group it uses. That
22015
+ # public access isn't permitted if the security group assigned to the
22016
+ # DB cluster doesn't permit it.
20688
22017
  #
20689
22018
  # When the DB instance isn't publicly accessible, it is an internal
20690
22019
  # DB instance with a DNS name that resolves to a private IP address.
@@ -20851,7 +22180,7 @@ module Aws::RDS
20851
22180
  # @!attribute [rw] enable_iam_database_authentication
20852
22181
  # A value that indicates whether to enable mapping of Amazon Web
20853
22182
  # Services Identity and Access Management (IAM) accounts to database
20854
- # accounts. By default, mapping is disabled.
22183
+ # accounts. By default, mapping isn't enabled.
20855
22184
  #
20856
22185
  # This setting doesn't apply to RDS Custom.
20857
22186
  #
@@ -20914,8 +22243,8 @@ module Aws::RDS
20914
22243
  # @!attribute [rw] deletion_protection
20915
22244
  # A value that indicates whether the DB instance has deletion
20916
22245
  # protection enabled. The database can't be deleted when deletion
20917
- # protection is enabled. By default, deletion protection is disabled.
20918
- # For more information, see [ Deleting a DB Instance][1].
22246
+ # protection is enabled. By default, deletion protection isn't
22247
+ # enabled. For more information, see [ Deleting a DB Instance][1].
20919
22248
  #
20920
22249
  #
20921
22250
  #
@@ -20998,6 +22327,21 @@ module Aws::RDS
20998
22327
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
20999
22328
  # @return [String]
21000
22329
  #
22330
+ # @!attribute [rw] backup_target
22331
+ # Specifies where automated backups and manual snapshots are stored
22332
+ # for the restored DB instance.
22333
+ #
22334
+ # Possible values are `outposts` (Amazon Web Services Outposts) and
22335
+ # `region` (Amazon Web Services Region). The default is `region`.
22336
+ #
22337
+ # For more information, see [Working with Amazon RDS on Amazon Web
22338
+ # Services Outposts][1] in the *Amazon RDS User Guide*.
22339
+ #
22340
+ #
22341
+ #
22342
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
22343
+ # @return [String]
22344
+ #
21001
22345
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceToPointInTimeMessage AWS API Documentation
21002
22346
  #
21003
22347
  class RestoreDBInstanceToPointInTimeMessage < Struct.new(
@@ -21035,7 +22379,8 @@ module Aws::RDS
21035
22379
  :max_allocated_storage,
21036
22380
  :source_db_instance_automated_backups_arn,
21037
22381
  :enable_customer_owned_ip,
21038
- :custom_iam_instance_profile)
22382
+ :custom_iam_instance_profile,
22383
+ :backup_target)
21039
22384
  SENSITIVE = []
21040
22385
  include Aws::Structure
21041
22386
  end
@@ -21043,8 +22388,13 @@ module Aws::RDS
21043
22388
  # @!attribute [rw] db_instance
21044
22389
  # Contains the details of an Amazon RDS DB instance.
21045
22390
  #
21046
- # This data type is used as a response element in the
21047
- # `DescribeDBInstances` action.
22391
+ # This data type is used as a response element in the operations
22392
+ # `CreateDBInstance`, `CreateDBInstanceReadReplica`,
22393
+ # `DeleteDBInstance`, `DescribeDBInstances`, `ModifyDBInstance`,
22394
+ # `PromoteReadReplica`, `RebootDBInstance`,
22395
+ # `RestoreDBInstanceFromDBSnapshot`, `RestoreDBInstanceFromS3`,
22396
+ # `RestoreDBInstanceToPointInTime`, `StartDBInstance`, and
22397
+ # `StopDBInstance`.
21048
22398
  # @return [Types::DBInstance]
21049
22399
  #
21050
22400
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceToPointInTimeResult AWS API Documentation
@@ -21531,10 +22881,39 @@ module Aws::RDS
21531
22881
  end
21532
22882
 
21533
22883
  # @!attribute [rw] db_cluster
21534
- # Contains the details of an Amazon Aurora DB cluster.
22884
+ # Contains the details of an Amazon Aurora DB cluster or Multi-AZ DB
22885
+ # cluster.
21535
22886
  #
21536
- # This data type is used as a response element in the
21537
- # `DescribeDBClusters`, `StopDBCluster`, and `StartDBCluster` actions.
22887
+ # For an Amazon Aurora DB cluster, this data type is used as a
22888
+ # response element in the operations `CreateDBCluster`,
22889
+ # `DeleteDBCluster`, `DescribeDBClusters`, `FailoverDBCluster`,
22890
+ # `ModifyDBCluster`, `PromoteReadReplicaDBCluster`,
22891
+ # `RestoreDBClusterFromS3`, `RestoreDBClusterFromSnapshot`,
22892
+ # `RestoreDBClusterToPointInTime`, `StartDBCluster`, and
22893
+ # `StopDBCluster`.
22894
+ #
22895
+ # For a Multi-AZ DB cluster, this data type is used as a response
22896
+ # element in the operations `CreateDBCluster`, `DeleteDBCluster`,
22897
+ # `DescribeDBClusters`, `FailoverDBCluster`, `ModifyDBCluster`,
22898
+ # `RebootDBCluster`, `RestoreDBClusterFromSnapshot`, and
22899
+ # `RestoreDBClusterToPointInTime`.
22900
+ #
22901
+ # For more information on Amazon Aurora DB clusters, see [ What is
22902
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
22903
+ #
22904
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
22905
+ # deployments with two readable standby DB instances][2] in the
22906
+ # *Amazon RDS User Guide.*
22907
+ #
22908
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
22909
+ # change.
22910
+ #
22911
+ # </note>
22912
+ #
22913
+ #
22914
+ #
22915
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
22916
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
21538
22917
  # @return [Types::DBCluster]
21539
22918
  #
21540
22919
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StartDBClusterResult AWS API Documentation
@@ -21637,8 +23016,13 @@ module Aws::RDS
21637
23016
  # @!attribute [rw] db_instance
21638
23017
  # Contains the details of an Amazon RDS DB instance.
21639
23018
  #
21640
- # This data type is used as a response element in the
21641
- # `DescribeDBInstances` action.
23019
+ # This data type is used as a response element in the operations
23020
+ # `CreateDBInstance`, `CreateDBInstanceReadReplica`,
23021
+ # `DeleteDBInstance`, `DescribeDBInstances`, `ModifyDBInstance`,
23022
+ # `PromoteReadReplica`, `RebootDBInstance`,
23023
+ # `RestoreDBInstanceFromDBSnapshot`, `RestoreDBInstanceFromS3`,
23024
+ # `RestoreDBInstanceToPointInTime`, `StartDBInstance`, and
23025
+ # `StopDBInstance`.
21642
23026
  # @return [Types::DBInstance]
21643
23027
  #
21644
23028
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StartDBInstanceResult AWS API Documentation
@@ -21825,10 +23209,39 @@ module Aws::RDS
21825
23209
  end
21826
23210
 
21827
23211
  # @!attribute [rw] db_cluster
21828
- # Contains the details of an Amazon Aurora DB cluster.
23212
+ # Contains the details of an Amazon Aurora DB cluster or Multi-AZ DB
23213
+ # cluster.
21829
23214
  #
21830
- # This data type is used as a response element in the
21831
- # `DescribeDBClusters`, `StopDBCluster`, and `StartDBCluster` actions.
23215
+ # For an Amazon Aurora DB cluster, this data type is used as a
23216
+ # response element in the operations `CreateDBCluster`,
23217
+ # `DeleteDBCluster`, `DescribeDBClusters`, `FailoverDBCluster`,
23218
+ # `ModifyDBCluster`, `PromoteReadReplicaDBCluster`,
23219
+ # `RestoreDBClusterFromS3`, `RestoreDBClusterFromSnapshot`,
23220
+ # `RestoreDBClusterToPointInTime`, `StartDBCluster`, and
23221
+ # `StopDBCluster`.
23222
+ #
23223
+ # For a Multi-AZ DB cluster, this data type is used as a response
23224
+ # element in the operations `CreateDBCluster`, `DeleteDBCluster`,
23225
+ # `DescribeDBClusters`, `FailoverDBCluster`, `ModifyDBCluster`,
23226
+ # `RebootDBCluster`, `RestoreDBClusterFromSnapshot`, and
23227
+ # `RestoreDBClusterToPointInTime`.
23228
+ #
23229
+ # For more information on Amazon Aurora DB clusters, see [ What is
23230
+ # Amazon Aurora?][1] in the *Amazon Aurora User Guide.*
23231
+ #
23232
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ
23233
+ # deployments with two readable standby DB instances][2] in the
23234
+ # *Amazon RDS User Guide.*
23235
+ #
23236
+ # <note markdown="1"> The Multi-AZ DB clusters feature is in preview and is subject to
23237
+ # change.
23238
+ #
23239
+ # </note>
23240
+ #
23241
+ #
23242
+ #
23243
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
23244
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
21832
23245
  # @return [Types::DBCluster]
21833
23246
  #
21834
23247
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StopDBClusterResult AWS API Documentation
@@ -21903,8 +23316,13 @@ module Aws::RDS
21903
23316
  # @!attribute [rw] db_instance
21904
23317
  # Contains the details of an Amazon RDS DB instance.
21905
23318
  #
21906
- # This data type is used as a response element in the
21907
- # `DescribeDBInstances` action.
23319
+ # This data type is used as a response element in the operations
23320
+ # `CreateDBInstance`, `CreateDBInstanceReadReplica`,
23321
+ # `DeleteDBInstance`, `DescribeDBInstances`, `ModifyDBInstance`,
23322
+ # `PromoteReadReplica`, `RebootDBInstance`,
23323
+ # `RestoreDBInstanceFromDBSnapshot`, `RestoreDBInstanceFromS3`,
23324
+ # `RestoreDBInstanceToPointInTime`, `StartDBInstance`, and
23325
+ # `StopDBInstance`.
21908
23326
  # @return [Types::DBInstance]
21909
23327
  #
21910
23328
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StopDBInstanceResult AWS API Documentation