aws-sdk-rds 1.171.0 → 1.173.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.
@@ -691,7 +691,7 @@ module Aws::RDS
691
691
  end
692
692
 
693
693
  # @!attribute [rw] export_task_identifier
694
- # The identifier of the snapshot export task to cancel.
694
+ # The identifier of the snapshot or cluster export task to cancel.
695
695
  # @return [String]
696
696
  #
697
697
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CancelExportTaskMessage AWS API Documentation
@@ -1767,6 +1767,12 @@ module Aws::RDS
1767
1767
  include Aws::Structure
1768
1768
  end
1769
1769
 
1770
+ # An error occurred while trying to create the CEV.
1771
+ #
1772
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateCustomDBEngineVersionFault AWS API Documentation
1773
+ #
1774
+ class CreateCustomDBEngineVersionFault < Aws::EmptyStructure; end
1775
+
1770
1776
  # @!attribute [rw] engine
1771
1777
  # The database engine to use for your custom engine version (CEV). The
1772
1778
  # only supported value is `custom-oracle-ee`.
@@ -2028,10 +2034,7 @@ module Aws::RDS
2028
2034
  #
2029
2035
  # Valid Values:
2030
2036
  #
2031
- # * `aurora` (for MySQL 5.6-compatible Aurora)
2032
- #
2033
- # * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
2034
- # Aurora)
2037
+ # * `aurora-mysql`
2035
2038
  #
2036
2039
  # * `aurora-postgresql`
2037
2040
  #
@@ -2045,19 +2048,16 @@ module Aws::RDS
2045
2048
  # @!attribute [rw] engine_version
2046
2049
  # The version number of the database engine to use.
2047
2050
  #
2048
- # To list all of the available engine versions for MySQL
2049
- # 5.6-compatible Aurora, use the following command:
2050
- #
2051
- # `aws rds describe-db-engine-versions --engine aurora --query
2052
- # "DBEngineVersions[].EngineVersion"`
2053
- #
2054
- # To list all of the available engine versions for MySQL
2055
- # 5.7-compatible and MySQL 8.0-compatible Aurora, use the following
2056
- # command:
2051
+ # To list all of the available engine versions for Aurora MySQL
2052
+ # version 2 (5.7-compatible) and version 3 (MySQL 8.0-compatible), use
2053
+ # the following command:
2057
2054
  #
2058
2055
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
2059
2056
  # "DBEngineVersions[].EngineVersion"`
2060
2057
  #
2058
+ # You can supply either `5.7` or `8.0` to use the default engine
2059
+ # version for Aurora MySQL version 2 or version 3, respectively.
2060
+ #
2061
2061
  # To list all of the available engine versions for Aurora PostgreSQL,
2062
2062
  # use the following command:
2063
2063
  #
@@ -2078,8 +2078,8 @@ module Aws::RDS
2078
2078
  #
2079
2079
  # **Aurora MySQL**
2080
2080
  #
2081
- # For information, see [MySQL on Amazon RDS Versions][1] in the
2082
- # *Amazon Aurora User Guide*.
2081
+ # For information, see [Database engine updates for Amazon Aurora
2082
+ # MySQL][1] in the *Amazon Aurora User Guide*.
2083
2083
  #
2084
2084
  # **Aurora PostgreSQL**
2085
2085
  #
@@ -2088,13 +2088,13 @@ module Aws::RDS
2088
2088
  #
2089
2089
  # **MySQL**
2090
2090
  #
2091
- # For information, see [MySQL on Amazon RDS Versions][3] in the
2092
- # *Amazon RDS User Guide*.
2091
+ # For information, see [Amazon RDS for MySQL][3] in the *Amazon RDS
2092
+ # User Guide*.
2093
2093
  #
2094
2094
  # **PostgreSQL**
2095
2095
  #
2096
- # For information, see [Amazon RDS for PostgreSQL versions and
2097
- # extensions][4] in the *Amazon RDS User Guide*.
2096
+ # For information, see [Amazon RDS for PostgreSQL][4] in the *Amazon
2097
+ # RDS User Guide*.
2098
2098
  #
2099
2099
  # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2100
2100
  #
@@ -2214,7 +2214,8 @@ module Aws::RDS
2214
2214
  # The Amazon Resource Name (ARN) of the source DB instance or DB
2215
2215
  # cluster if this DB cluster is created as a read replica.
2216
2216
  #
2217
- # Valid for: Aurora DB clusters only
2217
+ # Valid for: Aurora DB clusters and RDS for PostgreSQL Multi-AZ DB
2218
+ # clusters
2218
2219
  # @return [String]
2219
2220
  #
2220
2221
  # @!attribute [rw] tags
@@ -2238,7 +2239,7 @@ module Aws::RDS
2238
2239
  # different Amazon Web Services account, specify the key ARN or alias
2239
2240
  # ARN.
2240
2241
  #
2241
- # When a KMS key isn't specified in `KmsKeyId`\:
2242
+ # When a KMS key isn't specified in `KmsKeyId`:
2242
2243
  #
2243
2244
  # * If `ReplicationSourceIdentifier` identifies an encrypted source,
2244
2245
  # then Amazon RDS will use the KMS key used to encrypt the source.
@@ -2384,40 +2385,23 @@ module Aws::RDS
2384
2385
  # @return [Array<String>]
2385
2386
  #
2386
2387
  # @!attribute [rw] engine_mode
2387
- # The DB engine mode of the DB cluster, either `provisioned`,
2388
- # `serverless`, `parallelquery`, `global`, or `multimaster`.
2389
- #
2390
- # The `parallelquery` engine mode isn't required for Aurora MySQL
2391
- # version 1.23 and higher 1.x versions, and version 2.09 and higher
2392
- # 2.x versions.
2393
- #
2394
- # The `global` engine mode isn't required for Aurora MySQL version
2395
- # 1.22 and higher 1.x versions, and `global` engine mode isn't
2396
- # required for any 2.x versions.
2397
- #
2398
- # The `multimaster` engine mode only applies for DB clusters created
2399
- # with Aurora MySQL version 5.6.10a.
2388
+ # The DB engine mode of the DB cluster, either `provisioned` or
2389
+ # `serverless`.
2400
2390
  #
2401
2391
  # The `serverless` engine mode only applies for Aurora Serverless v1
2402
2392
  # DB clusters.
2403
2393
  #
2404
- # For Aurora PostgreSQL, the `global` engine mode isn't required, and
2405
- # both the `parallelquery` and the `multimaster` engine modes
2406
- # currently aren't supported.
2407
- #
2408
2394
  # Limitations and requirements apply to some DB engine modes. For more
2409
2395
  # information, see the following sections in the *Amazon Aurora User
2410
- # Guide*\:
2396
+ # Guide*:
2411
2397
  #
2412
2398
  # * [Limitations of Aurora Serverless v1][1]
2413
2399
  #
2414
2400
  # * [Requirements for Aurora Serverless v2][2]
2415
2401
  #
2416
- # * [Limitations of Parallel Query][3]
2417
- #
2418
- # * [Limitations of Aurora Global Databases][4]
2402
+ # * [Limitations of parallel query][3]
2419
2403
  #
2420
- # * [Limitations of Multi-Master Clusters][5]
2404
+ # * [Limitations of Aurora global databases][4]
2421
2405
  #
2422
2406
  # Valid for: Aurora DB clusters only
2423
2407
  #
@@ -2427,7 +2411,6 @@ module Aws::RDS
2427
2411
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.requirements.html
2428
2412
  # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-mysql-parallel-query.html#aurora-mysql-parallel-query-limitations
2429
2413
  # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database.html#aurora-global-database.limitations
2430
- # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-multi-master.html#aurora-multi-master-limitations
2431
2414
  # @return [String]
2432
2415
  #
2433
2416
  # @!attribute [rw] scaling_configuration
@@ -2567,8 +2550,8 @@ module Aws::RDS
2567
2550
  # to be initially allocated for each DB instance in the Multi-AZ DB
2568
2551
  # cluster.
2569
2552
  #
2570
- # For information about valid IOPS values, see [Amazon RDS Provisioned
2571
- # IOPS storage][1] in the *Amazon RDS User Guide*.
2553
+ # For information about valid IOPS values, see [Provisioned IOPS
2554
+ # storage][1] in the *Amazon RDS User Guide*.
2572
2555
  #
2573
2556
  # This setting is required to create a Multi-AZ DB cluster.
2574
2557
  #
@@ -4964,9 +4947,9 @@ module Aws::RDS
4964
4947
  # read replica. Follow the allocation rules specified in
4965
4948
  # `CreateDBInstance`.
4966
4949
  #
4967
- # <note markdown="1"> Be sure to allocate enough memory for your read replica so that the
4950
+ # <note markdown="1"> Be sure to allocate enough storage for your read replica so that the
4968
4951
  # create operation can succeed. You can also allocate additional
4969
- # memory for future growth.
4952
+ # storage for future growth.
4970
4953
  #
4971
4954
  # </note>
4972
4955
  # @return [Integer]
@@ -9569,7 +9552,12 @@ module Aws::RDS
9569
9552
  #
9570
9553
  # @!attribute [rw] delete_target
9571
9554
  # A value that indicates whether to delete the resources in the green
9572
- # environment.
9555
+ # environment. You can't specify this option if the blue/green
9556
+ # deployment [status][1] is `SWITCHOVER_COMPLETED`.
9557
+ #
9558
+ #
9559
+ #
9560
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_BlueGreenDeployment.html
9573
9561
  # @return [Boolean]
9574
9562
  #
9575
9563
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteBlueGreenDeploymentRequest AWS API Documentation
@@ -10767,8 +10755,6 @@ module Aws::RDS
10767
10755
  #
10768
10756
  # Valid Values:
10769
10757
  #
10770
- # * `aurora` (for MySQL 5.6-compatible Aurora)
10771
- #
10772
10758
  # * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
10773
10759
  # Aurora)
10774
10760
  #
@@ -12126,28 +12112,29 @@ module Aws::RDS
12126
12112
  end
12127
12113
 
12128
12114
  # @!attribute [rw] export_task_identifier
12129
- # The identifier of the snapshot export task to be described.
12115
+ # The identifier of the snapshot or cluster export task to be
12116
+ # described.
12130
12117
  # @return [String]
12131
12118
  #
12132
12119
  # @!attribute [rw] source_arn
12133
- # The Amazon Resource Name (ARN) of the snapshot exported to Amazon
12134
- # S3.
12120
+ # The Amazon Resource Name (ARN) of the snapshot or cluster exported
12121
+ # to Amazon S3.
12135
12122
  # @return [String]
12136
12123
  #
12137
12124
  # @!attribute [rw] filters
12138
- # Filters specify one or more snapshot exports to describe. The
12139
- # filters are specified as name-value pairs that define what to
12125
+ # Filters specify one or more snapshot or cluster exports to describe.
12126
+ # The filters are specified as name-value pairs that define what to
12140
12127
  # include in the output. Filter names and values are case-sensitive.
12141
12128
  #
12142
12129
  # Supported filters include the following:
12143
12130
  #
12144
- # * `export-task-identifier` - An identifier for the snapshot export
12145
- # task.
12131
+ # * `export-task-identifier` - An identifier for the snapshot or
12132
+ # cluster export task.
12146
12133
  #
12147
- # * `s3-bucket` - The Amazon S3 bucket the snapshot is exported to.
12134
+ # * `s3-bucket` - The Amazon S3 bucket the data is exported to.
12148
12135
  #
12149
- # * `source-arn` - The Amazon Resource Name (ARN) of the snapshot
12150
- # exported to Amazon S3
12136
+ # * `source-arn` - The Amazon Resource Name (ARN) of the snapshot or
12137
+ # cluster exported to Amazon S3.
12151
12138
  #
12152
12139
  # * `status` - The status of the export task. Must be lowercase. Valid
12153
12140
  # statuses are the following:
@@ -12393,8 +12380,6 @@ module Aws::RDS
12393
12380
  #
12394
12381
  # Valid Values:
12395
12382
  #
12396
- # * `aurora` (for MySQL 5.6-compatible Aurora)
12397
- #
12398
12383
  # * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
12399
12384
  # Aurora)
12400
12385
  #
@@ -13245,34 +13230,35 @@ module Aws::RDS
13245
13230
  include Aws::Structure
13246
13231
  end
13247
13232
 
13248
- # Contains the details of a snapshot export to Amazon S3.
13233
+ # Contains the details of a snapshot or cluster export to Amazon S3.
13249
13234
  #
13250
13235
  # This data type is used as a response element in the
13251
13236
  # `DescribeExportTasks` action.
13252
13237
  #
13253
13238
  # @!attribute [rw] export_task_identifier
13254
- # A unique identifier for the snapshot export task. This ID isn't an
13255
- # identifier for the Amazon S3 bucket where the snapshot is exported
13256
- # to.
13239
+ # A unique identifier for the snapshot or cluster export task. This ID
13240
+ # isn't an identifier for the Amazon S3 bucket where the data is
13241
+ # exported.
13257
13242
  # @return [String]
13258
13243
  #
13259
13244
  # @!attribute [rw] source_arn
13260
- # The Amazon Resource Name (ARN) of the snapshot exported to Amazon
13261
- # S3.
13245
+ # The Amazon Resource Name (ARN) of the snapshot or cluster exported
13246
+ # to Amazon S3.
13262
13247
  # @return [String]
13263
13248
  #
13264
13249
  # @!attribute [rw] export_only
13265
- # The data exported from the snapshot. Valid values are the following:
13250
+ # The data exported from the snapshot or cluster. Valid values are the
13251
+ # following:
13266
13252
  #
13267
13253
  # * `database` - Export all the data from a specified database.
13268
13254
  #
13269
- # * `database.table` *table-name* - Export a table of the snapshot.
13270
- # This format is valid only for RDS for MySQL, RDS for MariaDB, and
13271
- # Aurora MySQL.
13255
+ # * `database.table` *table-name* - Export a table of the snapshot or
13256
+ # cluster. This format is valid only for RDS for MySQL, RDS for
13257
+ # MariaDB, and Aurora MySQL.
13272
13258
  #
13273
13259
  # * `database.schema` *schema-name* - Export a database schema of the
13274
- # snapshot. This format is valid only for RDS for PostgreSQL and
13275
- # Aurora PostgreSQL.
13260
+ # snapshot or cluster. This format is valid only for RDS for
13261
+ # PostgreSQL and Aurora PostgreSQL.
13276
13262
  #
13277
13263
  # * `database.schema.table` *table-name* - Export a table of the
13278
13264
  # database schema. This format is valid only for RDS for PostgreSQL
@@ -13284,41 +13270,54 @@ module Aws::RDS
13284
13270
  # @return [Time]
13285
13271
  #
13286
13272
  # @!attribute [rw] task_start_time
13287
- # The time that the snapshot export task started.
13273
+ # The time that the snapshot or cluster export task started.
13288
13274
  # @return [Time]
13289
13275
  #
13290
13276
  # @!attribute [rw] task_end_time
13291
- # The time that the snapshot export task completed.
13277
+ # The time that the snapshot or cluster export task ended.
13292
13278
  # @return [Time]
13293
13279
  #
13294
13280
  # @!attribute [rw] s3_bucket
13295
- # The Amazon S3 bucket that the snapshot is exported to.
13281
+ # The Amazon S3 bucket that the snapshot or cluster is exported to.
13296
13282
  # @return [String]
13297
13283
  #
13298
13284
  # @!attribute [rw] s3_prefix
13299
13285
  # The Amazon S3 bucket prefix that is the file name and path of the
13300
- # exported snapshot.
13286
+ # exported data.
13301
13287
  # @return [String]
13302
13288
  #
13303
13289
  # @!attribute [rw] iam_role_arn
13304
13290
  # The name of the IAM role that is used to write to Amazon S3 when
13305
- # exporting a snapshot.
13291
+ # exporting a snapshot or cluster.
13306
13292
  # @return [String]
13307
13293
  #
13308
13294
  # @!attribute [rw] kms_key_id
13309
13295
  # The key identifier of the Amazon Web Services KMS key that is used
13310
- # to encrypt the snapshot when it's exported to Amazon S3. The KMS
13311
- # key identifier is its key ARN, key ID, alias ARN, or alias name. The
13312
- # IAM role used for the snapshot export must have encryption and
13313
- # decryption permissions to use this KMS key.
13296
+ # to encrypt the data when it's exported to Amazon S3. The KMS key
13297
+ # identifier is its key ARN, key ID, alias ARN, or alias name. The IAM
13298
+ # role used for the export must have encryption and decryption
13299
+ # permissions to use this KMS key.
13314
13300
  # @return [String]
13315
13301
  #
13316
13302
  # @!attribute [rw] status
13317
- # The progress status of the export task.
13303
+ # The progress status of the export task. The status can be one of the
13304
+ # following:
13305
+ #
13306
+ # * `CANCELED`
13307
+ #
13308
+ # * `CANCELING`
13309
+ #
13310
+ # * `COMPLETE`
13311
+ #
13312
+ # * `FAILED`
13313
+ #
13314
+ # * `IN_PROGRESS`
13315
+ #
13316
+ # * `STARTING`
13318
13317
  # @return [String]
13319
13318
  #
13320
13319
  # @!attribute [rw] percent_progress
13321
- # The progress of the snapshot export task as a percentage.
13320
+ # The progress of the snapshot or cluster export task as a percentage.
13322
13321
  # @return [Integer]
13323
13322
  #
13324
13323
  # @!attribute [rw] total_extracted_data_in_gb
@@ -13330,7 +13329,7 @@ module Aws::RDS
13330
13329
  # @return [String]
13331
13330
  #
13332
13331
  # @!attribute [rw] warning_message
13333
- # A warning about the snapshot export task.
13332
+ # A warning about the snapshot or cluster export task.
13334
13333
  # @return [String]
13335
13334
  #
13336
13335
  # @!attribute [rw] source_type
@@ -13379,7 +13378,7 @@ module Aws::RDS
13379
13378
  # @return [String]
13380
13379
  #
13381
13380
  # @!attribute [rw] export_tasks
13382
- # Information about an export of a snapshot to Amazon S3.
13381
+ # Information about an export of a snapshot or cluster to Amazon S3.
13383
13382
  # @return [Array<Types::ExportTask>]
13384
13383
  #
13385
13384
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ExportTasksMessage AWS API Documentation
@@ -13633,8 +13632,8 @@ module Aws::RDS
13633
13632
  # @return [Boolean]
13634
13633
  #
13635
13634
  # @!attribute [rw] global_cluster_members
13636
- # The list of cluster IDs for secondary clusters within the global
13637
- # database cluster. Currently limited to 1 item.
13635
+ # The list of primary and secondary clusters within the global
13636
+ # database cluster.
13638
13637
  # @return [Array<Types::GlobalClusterMember>]
13639
13638
  #
13640
13639
  # @!attribute [rw] failover_state
@@ -14092,8 +14091,8 @@ module Aws::RDS
14092
14091
  end
14093
14092
 
14094
14093
  # @!attribute [rw] resource_arn
14095
- # The Amazon Resource Name (ARN) of the RDS for Oracle DB instance,
14096
- # for example,
14094
+ # The Amazon Resource Name (ARN) of the RDS for Oracle or Microsoft
14095
+ # SQL Server DB instance. For example,
14097
14096
  # `arn:aws:rds:us-east-1:12345667890:instance:my-orcl-db`.
14098
14097
  # @return [String]
14099
14098
  #
@@ -14567,15 +14566,9 @@ module Aws::RDS
14567
14566
  # applied during the next maintenance window unless `ApplyImmediately`
14568
14567
  # is enabled.
14569
14568
  #
14570
- # To list all of the available engine versions for MySQL
14571
- # 5.6-compatible Aurora, use the following command:
14572
- #
14573
- # `aws rds describe-db-engine-versions --engine aurora --query
14574
- # "DBEngineVersions[].EngineVersion"`
14575
- #
14576
- # To list all of the available engine versions for MySQL
14577
- # 5.7-compatible and MySQL 8.0-compatible Aurora, use the following
14578
- # command:
14569
+ # To list all of the available engine versions for Aurora MySQL
14570
+ # version 2 (5.7-compatible) and version 3 (MySQL 8.0-compatible), use
14571
+ # the following command:
14579
14572
  #
14580
14573
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
14581
14574
  # "DBEngineVersions[].EngineVersion"`
@@ -18950,22 +18943,15 @@ module Aws::RDS
18950
18943
  # @!attribute [rw] engine
18951
18944
  # The name of the database engine to be used for this DB cluster.
18952
18945
  #
18953
- # Valid Values: `aurora` (for MySQL 5.6-compatible Aurora) and
18954
- # `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
18955
- # Aurora)
18946
+ # Valid Values: `aurora-mysql` (for MySQL 5.7-compatible and MySQL
18947
+ # 8.0-compatible Aurora)
18956
18948
  # @return [String]
18957
18949
  #
18958
18950
  # @!attribute [rw] engine_version
18959
18951
  # The version number of the database engine to use.
18960
18952
  #
18961
- # To list all of the available engine versions for `aurora` (for MySQL
18962
- # 5.6-compatible Aurora), use the following command:
18963
- #
18964
- # `aws rds describe-db-engine-versions --engine aurora --query
18965
- # "DBEngineVersions[].EngineVersion"`
18966
- #
18967
- # To list all of the available engine versions for `aurora-mysql` (for
18968
- # MySQL 5.7-compatible and MySQL 8.0-compatible Aurora), use the
18953
+ # To list all of the available engine versions for `aurora-mysql`
18954
+ # (MySQL 5.7-compatible and MySQL 8.0-compatible Aurora), use the
18969
18955
  # following command:
18970
18956
  #
18971
18957
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
@@ -18973,8 +18959,7 @@ module Aws::RDS
18973
18959
  #
18974
18960
  # **Aurora MySQL**
18975
18961
  #
18976
- # Example: `5.6.10a`, `5.6.mysql_aurora.1.19.2`,
18977
- # `5.7.mysql_aurora.2.07.1`, `8.0.mysql_aurora.3.02.0`
18962
+ # Examples: `5.7.mysql_aurora.2.07.1`, `8.0.mysql_aurora.3.02.0`
18978
18963
  # @return [String]
18979
18964
  #
18980
18965
  # @!attribute [rw] port
@@ -19164,10 +19149,6 @@ module Aws::RDS
19164
19149
  #
19165
19150
  # Possible values are `audit`, `error`, `general`, and `slowquery`.
19166
19151
  #
19167
- # **Aurora PostgreSQL**
19168
- #
19169
- # Possible value is `postgresql`.
19170
- #
19171
19152
  # For more information about exporting CloudWatch Logs for Amazon
19172
19153
  # Aurora, see [Publishing Database Logs to Amazon CloudWatch Logs][1]
19173
19154
  # in the *Amazon Aurora User Guide*.
@@ -19421,13 +19402,9 @@ module Aws::RDS
19421
19402
  # @return [String]
19422
19403
  #
19423
19404
  # @!attribute [rw] engine_version
19424
- # The version of the database engine to use for the new DB cluster.
19425
- #
19426
- # To list all of the available engine versions for MySQL
19427
- # 5.6-compatible Aurora, use the following command:
19428
- #
19429
- # `aws rds describe-db-engine-versions --engine aurora --query
19430
- # "DBEngineVersions[].EngineVersion"`
19405
+ # The version of the database engine to use for the new DB cluster. If
19406
+ # you don't specify an engine version, the default version for the
19407
+ # database engine in the Amazon Web Services Region is used.
19431
19408
  #
19432
19409
  # To list all of the available engine versions for MySQL
19433
19410
  # 5.7-compatible and MySQL 8.0-compatible Aurora, use the following
@@ -19456,8 +19433,8 @@ module Aws::RDS
19456
19433
  #
19457
19434
  # **Aurora MySQL**
19458
19435
  #
19459
- # See [MySQL on Amazon RDS Versions][1] in the *Amazon Aurora User
19460
- # Guide*.
19436
+ # See [Database engine updates for Amazon Aurora MySQL][1] in the
19437
+ # *Amazon Aurora User Guide*.
19461
19438
  #
19462
19439
  # **Aurora PostgreSQL**
19463
19440
  #
@@ -19466,8 +19443,7 @@ module Aws::RDS
19466
19443
  #
19467
19444
  # **MySQL**
19468
19445
  #
19469
- # See [MySQL on Amazon RDS Versions][3] in the *Amazon RDS User
19470
- # Guide.*
19446
+ # See [Amazon RDS for MySQL][3] in the *Amazon RDS User Guide.*
19471
19447
  #
19472
19448
  # **PostgreSQL**
19473
19449
  #
@@ -20840,9 +20816,8 @@ module Aws::RDS
20840
20816
  # The identifier for the RDS for MySQL Multi-AZ DB cluster snapshot to
20841
20817
  # restore from.
20842
20818
  #
20843
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
20844
- # deployments with two readable standby DB instances][1] in the
20845
- # *Amazon RDS User Guide*.
20819
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
20820
+ # cluster deployments][1] in the *Amazon RDS User Guide*.
20846
20821
  #
20847
20822
  # Constraints:
20848
20823
  #
@@ -20872,9 +20847,9 @@ module Aws::RDS
20872
20847
  # DB instance. Follow the allocation rules specified in
20873
20848
  # CreateDBInstance.
20874
20849
  #
20875
- # <note markdown="1"> Be sure to allocate enough memory for your new DB instance so that
20850
+ # <note markdown="1"> Be sure to allocate enough storage for your new DB instance so that
20876
20851
  # the restore operation can succeed. You can also allocate additional
20877
- # memory for future growth.
20852
+ # storage for future growth.
20878
20853
  #
20879
20854
  # </note>
20880
20855
  # @return [Integer]
@@ -20966,9 +20941,9 @@ module Aws::RDS
20966
20941
  # DB instance. Follow the allocation rules specified in
20967
20942
  # `CreateDBInstance`.
20968
20943
  #
20969
- # <note markdown="1"> Be sure to allocate enough memory for your new DB instance so that
20944
+ # <note markdown="1"> Be sure to allocate enough storage for your new DB instance so that
20970
20945
  # the restore operation can succeed. You can also allocate additional
20971
- # memory for future growth.
20946
+ # storage for future growth.
20972
20947
  #
20973
20948
  # </note>
20974
20949
  # @return [Integer]
@@ -22025,9 +22000,9 @@ module Aws::RDS
22025
22000
  # DB instance. Follow the allocation rules specified in
22026
22001
  # `CreateDBInstance`.
22027
22002
  #
22028
- # <note markdown="1"> Be sure to allocate enough memory for your new DB instance so that
22003
+ # <note markdown="1"> Be sure to allocate enough storage for your new DB instance so that
22029
22004
  # the restore operation can succeed. You can also allocate additional
22030
- # memory for future growth.
22005
+ # storage for future growth.
22031
22006
  #
22032
22007
  # </note>
22033
22008
  # @return [Integer]
@@ -22540,8 +22515,9 @@ module Aws::RDS
22540
22515
  #
22541
22516
  # @!attribute [rw] engine_native_audit_fields_included
22542
22517
  # Specifies whether the database activity stream includes
22543
- # engine-native audit fields. This option only applies to an Oracle DB
22544
- # instance. By default, no engine-native audit fields are included.
22518
+ # engine-native audit fields. This option applies to an Oracle or
22519
+ # Microsoft SQL Server DB instance. By default, no engine-native audit
22520
+ # fields are included.
22545
22521
  # @return [Boolean]
22546
22522
  #
22547
22523
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StartActivityStreamRequest AWS API Documentation
@@ -22764,32 +22740,55 @@ module Aws::RDS
22764
22740
  end
22765
22741
 
22766
22742
  # @!attribute [rw] export_task_identifier
22767
- # A unique identifier for the snapshot export task. This ID isn't an
22768
- # identifier for the Amazon S3 bucket where the snapshot is to be
22769
- # exported to.
22743
+ # A unique identifier for the export task. This ID isn't an
22744
+ # identifier for the Amazon S3 bucket where the data is to be
22745
+ # exported.
22770
22746
  # @return [String]
22771
22747
  #
22772
22748
  # @!attribute [rw] source_arn
22773
- # The Amazon Resource Name (ARN) of the snapshot to export to Amazon
22774
- # S3.
22749
+ # The Amazon Resource Name (ARN) of the snapshot or cluster to export
22750
+ # to Amazon S3.
22775
22751
  # @return [String]
22776
22752
  #
22777
22753
  # @!attribute [rw] s3_bucket_name
22778
- # The name of the Amazon S3 bucket to export the snapshot to.
22754
+ # The name of the Amazon S3 bucket to export the snapshot or cluster
22755
+ # data to.
22779
22756
  # @return [String]
22780
22757
  #
22781
22758
  # @!attribute [rw] iam_role_arn
22782
22759
  # The name of the IAM role to use for writing to the Amazon S3 bucket
22783
- # when exporting a snapshot.
22760
+ # when exporting a snapshot or cluster.
22761
+ #
22762
+ # In the IAM policy attached to your IAM role, include the following
22763
+ # required actions to allow the transfer of files from Amazon RDS or
22764
+ # Amazon Aurora to an S3 bucket:
22765
+ #
22766
+ # * s3:PutObject*
22767
+ #
22768
+ # * s3:GetObject*
22769
+ #
22770
+ # * s3:ListBucket
22771
+ #
22772
+ # * s3:DeleteObject*
22773
+ #
22774
+ # * s3:GetBucketLocation
22775
+ #
22776
+ # In the policy, include the resources to identify the S3 bucket and
22777
+ # objects in the bucket. The following list of resources shows the
22778
+ # Amazon Resource Name (ARN) format for accessing S3:
22779
+ #
22780
+ # * `arn:aws:s3:::your-s3-bucket `
22781
+ #
22782
+ # * `arn:aws:s3:::your-s3-bucket/*`
22784
22783
  # @return [String]
22785
22784
  #
22786
22785
  # @!attribute [rw] kms_key_id
22787
- # The ID of the Amazon Web Services KMS key to use to encrypt the
22788
- # snapshot exported to Amazon S3. The Amazon Web Services KMS key
22789
- # identifier is the key ARN, key ID, alias ARN, or alias name for the
22790
- # KMS key. The caller of this operation must be authorized to run the
22791
- # following operations. These can be set in the Amazon Web Services
22792
- # KMS key policy:
22786
+ # The ID of the Amazon Web Services KMS key to use to encrypt the data
22787
+ # exported to Amazon S3. The Amazon Web Services KMS key identifier is
22788
+ # the key ARN, key ID, alias ARN, or alias name for the KMS key. The
22789
+ # caller of this operation must be authorized to run the following
22790
+ # operations. These can be set in the Amazon Web Services KMS key
22791
+ # policy:
22793
22792
  #
22794
22793
  # * kms:Encrypt
22795
22794
  #
@@ -22812,23 +22811,23 @@ module Aws::RDS
22812
22811
  #
22813
22812
  # @!attribute [rw] s3_prefix
22814
22813
  # The Amazon S3 bucket prefix to use as the file name and path of the
22815
- # exported snapshot.
22814
+ # exported data.
22816
22815
  # @return [String]
22817
22816
  #
22818
22817
  # @!attribute [rw] export_only
22819
- # The data to be exported from the snapshot. If this parameter is not
22820
- # provided, all the snapshot data is exported. Valid values are the
22821
- # following:
22818
+ # The data to be exported from the snapshot or cluster. If this
22819
+ # parameter is not provided, all of the data is exported. Valid values
22820
+ # are the following:
22822
22821
  #
22823
22822
  # * `database` - Export all the data from a specified database.
22824
22823
  #
22825
- # * `database.table` *table-name* - Export a table of the snapshot.
22826
- # This format is valid only for RDS for MySQL, RDS for MariaDB, and
22827
- # Aurora MySQL.
22824
+ # * `database.table` *table-name* - Export a table of the snapshot or
22825
+ # cluster. This format is valid only for RDS for MySQL, RDS for
22826
+ # MariaDB, and Aurora MySQL.
22828
22827
  #
22829
22828
  # * `database.schema` *schema-name* - Export a database schema of the
22830
- # snapshot. This format is valid only for RDS for PostgreSQL and
22831
- # Aurora PostgreSQL.
22829
+ # snapshot or cluster. This format is valid only for RDS for
22830
+ # PostgreSQL and Aurora PostgreSQL.
22832
22831
  #
22833
22832
  # * `database.schema.table` *table-name* - Export a table of the
22834
22833
  # database schema. This format is valid only for RDS for PostgreSQL
@@ -23147,7 +23146,7 @@ module Aws::RDS
23147
23146
  # Contains the details about a blue/green deployment.
23148
23147
  #
23149
23148
  # For more information, see [Using Amazon RDS Blue/Green Deployments for
23150
- # database updates][1] in the *Amazon RDS User Guide* and [ Using Amazon
23149
+ # database updates][1] in the *Amazon RDS User Guide* and [Using Amazon
23151
23150
  # RDS Blue/Green Deployments for database updates][2] in the *Amazon
23152
23151
  # Aurora User Guide*.
23153
23152
  #
@@ -23171,17 +23170,20 @@ module Aws::RDS
23171
23170
  #
23172
23171
  # Values:
23173
23172
  #
23174
- # * `preparing-for-switchover` - The resource is being prepared to
23175
- # switch over.
23173
+ # * `PROVISIONING` - The resource is being prepared to switch over.
23176
23174
  #
23177
- # * `ready-for-switchover` - The resource is ready to switch over.
23175
+ # * `AVAILABLE` - The resource is ready to switch over.
23178
23176
  #
23179
- # * `switchover-in-progress` - The resource is being switched over.
23177
+ # * `SWITCHOVER_IN_PROGRESS` - The resource is being switched over.
23180
23178
  #
23181
- # * `switchover-completed` - The resource has been switched over.
23179
+ # * `SWITCHOVER_COMPLETED` - The resource has been switched over.
23182
23180
  #
23183
- # * `switchover-failed` - The resource attempted to switch over but
23181
+ # * `SWITCHOVER_FAILED` - The resource attempted to switch over but
23184
23182
  # failed.
23183
+ #
23184
+ # * `MISSING_SOURCE` - The source resource has been deleted.
23185
+ #
23186
+ # * `MISSING_TARGET` - The target resource has been deleted.
23185
23187
  # @return [String]
23186
23188
  #
23187
23189
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/SwitchoverDetail AWS API Documentation