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.
@@ -885,12 +885,12 @@ module Aws::RDS
885
885
  req.send_request(options)
886
886
  end
887
887
 
888
- # Cancels an export task in progress that is exporting a snapshot to
889
- # Amazon S3. Any data that has already been written to the S3 bucket
890
- # isn't removed.
888
+ # Cancels an export task in progress that is exporting a snapshot or
889
+ # cluster to Amazon S3. Any data that has already been written to the S3
890
+ # bucket isn't removed.
891
891
  #
892
892
  # @option params [required, String] :export_task_identifier
893
- # The identifier of the snapshot export task to cancel.
893
+ # The identifier of the snapshot or cluster export task to cancel.
894
894
  #
895
895
  # @return [Types::ExportTask] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
896
896
  #
@@ -1080,9 +1080,8 @@ module Aws::RDS
1080
1080
  # For more information on Amazon Aurora DB clusters, see [ What is
1081
1081
  # Amazon Aurora?][2] in the *Amazon Aurora User Guide*.
1082
1082
  #
1083
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
1084
- # deployments with two readable standby DB instances][3] in the *Amazon
1085
- # RDS User Guide*.
1083
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
1084
+ # cluster deployments][3] in the *Amazon RDS User Guide*.
1086
1085
  #
1087
1086
  #
1088
1087
  #
@@ -2132,21 +2131,29 @@ module Aws::RDS
2132
2131
 
2133
2132
  # Creates a new Amazon Aurora DB cluster or Multi-AZ DB cluster.
2134
2133
  #
2134
+ # If you create an Aurora DB cluster, the request creates an empty
2135
+ # cluster. You must explicitly create the writer instance for your DB
2136
+ # cluster using the [CreateDBInstance][1] operation. If you create a
2137
+ # Multi-AZ DB cluster, the request creates a writer and two reader DB
2138
+ # instances for you, each in a different Availability Zone.
2139
+ #
2135
2140
  # You can use the `ReplicationSourceIdentifier` parameter to create an
2136
2141
  # Amazon Aurora DB cluster as a read replica of another DB cluster or
2137
- # Amazon RDS MySQL or PostgreSQL DB instance.
2138
- #
2139
- # For more information on Amazon Aurora, see [ What is Amazon
2140
- # Aurora?][1] in the *Amazon Aurora User Guide*.
2142
+ # Amazon RDS MySQL or PostgreSQL DB instance. For more information about
2143
+ # Amazon Aurora, see [What is Amazon Aurora?][2] in the *Amazon Aurora
2144
+ # User Guide*.
2141
2145
  #
2142
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
2143
- # deployments with two readable standby DB instances][2] in the *Amazon
2144
- # RDS User Guide*.
2146
+ # You can also use the `ReplicationSourceIdentifier` parameter to create
2147
+ # a Multi-AZ DB cluster read replica with an RDS for PostgreSQL DB
2148
+ # instance as the source. For more information about Multi-AZ DB
2149
+ # clusters, see [Multi-AZ DB cluster deployments][3] in the *Amazon RDS
2150
+ # User Guide*.
2145
2151
  #
2146
2152
  #
2147
2153
  #
2148
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
2149
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
2154
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html
2155
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
2156
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
2150
2157
  #
2151
2158
  # @option params [Array<String>] :availability_zones
2152
2159
  # A list of Availability Zones (AZs) where DB instances in the DB
@@ -2240,10 +2247,7 @@ module Aws::RDS
2240
2247
  #
2241
2248
  # Valid Values:
2242
2249
  #
2243
- # * `aurora` (for MySQL 5.6-compatible Aurora)
2244
- #
2245
- # * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
2246
- # Aurora)
2250
+ # * `aurora-mysql`
2247
2251
  #
2248
2252
  # * `aurora-postgresql`
2249
2253
  #
@@ -2256,18 +2260,16 @@ module Aws::RDS
2256
2260
  # @option params [String] :engine_version
2257
2261
  # The version number of the database engine to use.
2258
2262
  #
2259
- # To list all of the available engine versions for MySQL 5.6-compatible
2260
- # Aurora, use the following command:
2261
- #
2262
- # `aws rds describe-db-engine-versions --engine aurora --query
2263
- # "DBEngineVersions[].EngineVersion"`
2264
- #
2265
- # To list all of the available engine versions for MySQL 5.7-compatible
2266
- # and MySQL 8.0-compatible Aurora, use the following command:
2263
+ # To list all of the available engine versions for Aurora MySQL version
2264
+ # 2 (5.7-compatible) and version 3 (MySQL 8.0-compatible), use the
2265
+ # following command:
2267
2266
  #
2268
2267
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
2269
2268
  # "DBEngineVersions[].EngineVersion"`
2270
2269
  #
2270
+ # You can supply either `5.7` or `8.0` to use the default engine version
2271
+ # for Aurora MySQL version 2 or version 3, respectively.
2272
+ #
2271
2273
  # To list all of the available engine versions for Aurora PostgreSQL,
2272
2274
  # use the following command:
2273
2275
  #
@@ -2288,8 +2290,8 @@ module Aws::RDS
2288
2290
  #
2289
2291
  # **Aurora MySQL**
2290
2292
  #
2291
- # For information, see [MySQL on Amazon RDS Versions][1] in the *Amazon
2292
- # Aurora User Guide*.
2293
+ # For information, see [Database engine updates for Amazon Aurora
2294
+ # MySQL][1] in the *Amazon Aurora User Guide*.
2293
2295
  #
2294
2296
  # **Aurora PostgreSQL**
2295
2297
  #
@@ -2298,13 +2300,13 @@ module Aws::RDS
2298
2300
  #
2299
2301
  # **MySQL**
2300
2302
  #
2301
- # For information, see [MySQL on Amazon RDS Versions][3] in the *Amazon
2302
- # RDS User Guide*.
2303
+ # For information, see [Amazon RDS for MySQL][3] in the *Amazon RDS User
2304
+ # Guide*.
2303
2305
  #
2304
2306
  # **PostgreSQL**
2305
2307
  #
2306
- # For information, see [Amazon RDS for PostgreSQL versions and
2307
- # extensions][4] in the *Amazon RDS User Guide*.
2308
+ # For information, see [Amazon RDS for PostgreSQL][4] in the *Amazon RDS
2309
+ # User Guide*.
2308
2310
  #
2309
2311
  # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2310
2312
  #
@@ -2417,7 +2419,8 @@ module Aws::RDS
2417
2419
  # The Amazon Resource Name (ARN) of the source DB instance or DB cluster
2418
2420
  # if this DB cluster is created as a read replica.
2419
2421
  #
2420
- # Valid for: Aurora DB clusters only
2422
+ # Valid for: Aurora DB clusters and RDS for PostgreSQL Multi-AZ DB
2423
+ # clusters
2421
2424
  #
2422
2425
  # @option params [Array<Types::Tag>] :tags
2423
2426
  # Tags to assign to the DB cluster.
@@ -2438,7 +2441,7 @@ module Aws::RDS
2438
2441
  # different Amazon Web Services account, specify the key ARN or alias
2439
2442
  # ARN.
2440
2443
  #
2441
- # When a KMS key isn't specified in `KmsKeyId`\:
2444
+ # When a KMS key isn't specified in `KmsKeyId`:
2442
2445
  #
2443
2446
  # * If `ReplicationSourceIdentifier` identifies an encrypted source,
2444
2447
  # then Amazon RDS will use the KMS key used to encrypt the source.
@@ -2578,40 +2581,23 @@ module Aws::RDS
2578
2581
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
2579
2582
  #
2580
2583
  # @option params [String] :engine_mode
2581
- # The DB engine mode of the DB cluster, either `provisioned`,
2582
- # `serverless`, `parallelquery`, `global`, or `multimaster`.
2583
- #
2584
- # The `parallelquery` engine mode isn't required for Aurora MySQL
2585
- # version 1.23 and higher 1.x versions, and version 2.09 and higher 2.x
2586
- # versions.
2587
- #
2588
- # The `global` engine mode isn't required for Aurora MySQL version 1.22
2589
- # and higher 1.x versions, and `global` engine mode isn't required for
2590
- # any 2.x versions.
2591
- #
2592
- # The `multimaster` engine mode only applies for DB clusters created
2593
- # with Aurora MySQL version 5.6.10a.
2584
+ # The DB engine mode of the DB cluster, either `provisioned` or
2585
+ # `serverless`.
2594
2586
  #
2595
2587
  # The `serverless` engine mode only applies for Aurora Serverless v1 DB
2596
2588
  # clusters.
2597
2589
  #
2598
- # For Aurora PostgreSQL, the `global` engine mode isn't required, and
2599
- # both the `parallelquery` and the `multimaster` engine modes currently
2600
- # aren't supported.
2601
- #
2602
2590
  # Limitations and requirements apply to some DB engine modes. For more
2603
2591
  # information, see the following sections in the *Amazon Aurora User
2604
- # Guide*\:
2592
+ # Guide*:
2605
2593
  #
2606
2594
  # * [Limitations of Aurora Serverless v1][1]
2607
2595
  #
2608
2596
  # * [Requirements for Aurora Serverless v2][2]
2609
2597
  #
2610
- # * [Limitations of Parallel Query][3]
2611
- #
2612
- # * [Limitations of Aurora Global Databases][4]
2598
+ # * [Limitations of parallel query][3]
2613
2599
  #
2614
- # * [Limitations of Multi-Master Clusters][5]
2600
+ # * [Limitations of Aurora global databases][4]
2615
2601
  #
2616
2602
  # Valid for: Aurora DB clusters only
2617
2603
  #
@@ -2621,7 +2607,6 @@ module Aws::RDS
2621
2607
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.requirements.html
2622
2608
  # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-mysql-parallel-query.html#aurora-mysql-parallel-query-limitations
2623
2609
  # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database.html#aurora-global-database.limitations
2624
- # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-multi-master.html#aurora-multi-master-limitations
2625
2610
  #
2626
2611
  # @option params [Types::ScalingConfiguration] :scaling_configuration
2627
2612
  # For DB clusters in `serverless` DB engine mode, the scaling properties
@@ -2748,8 +2733,8 @@ module Aws::RDS
2748
2733
  # be initially allocated for each DB instance in the Multi-AZ DB
2749
2734
  # cluster.
2750
2735
  #
2751
- # For information about valid IOPS values, see [Amazon RDS Provisioned
2752
- # IOPS storage][1] in the *Amazon RDS User Guide*.
2736
+ # For information about valid IOPS values, see [Provisioned IOPS
2737
+ # storage][1] in the *Amazon RDS User Guide*.
2753
2738
  #
2754
2739
  # This setting is required to create a Multi-AZ DB cluster.
2755
2740
  #
@@ -3319,9 +3304,8 @@ module Aws::RDS
3319
3304
  # For more information on Amazon Aurora, see [ What is Amazon
3320
3305
  # Aurora?][2] in the *Amazon Aurora User Guide*.
3321
3306
  #
3322
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
3323
- # deployments with two readable standby DB instances][3] in the *Amazon
3324
- # RDS User Guide*.
3307
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
3308
+ # cluster deployments][3] in the *Amazon RDS User Guide*.
3325
3309
  #
3326
3310
  #
3327
3311
  #
@@ -3457,9 +3441,8 @@ module Aws::RDS
3457
3441
  # For more information on Amazon Aurora, see [ What is Amazon
3458
3442
  # Aurora?][1] in the *Amazon Aurora User Guide*.
3459
3443
  #
3460
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
3461
- # deployments with two readable standby DB instances][2] in the *Amazon
3462
- # RDS User Guide*.
3444
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
3445
+ # cluster deployments][2] in the *Amazon RDS User Guide*.
3463
3446
  #
3464
3447
  #
3465
3448
  #
@@ -5589,8 +5572,8 @@ module Aws::RDS
5589
5572
  # read replica. Follow the allocation rules specified in
5590
5573
  # `CreateDBInstance`.
5591
5574
  #
5592
- # <note markdown="1"> Be sure to allocate enough memory for your read replica so that the
5593
- # create operation can succeed. You can also allocate additional memory
5575
+ # <note markdown="1"> Be sure to allocate enough storage for your read replica so that the
5576
+ # create operation can succeed. You can also allocate additional storage
5594
5577
  # for future growth.
5595
5578
  #
5596
5579
  # </note>
@@ -6939,7 +6922,12 @@ module Aws::RDS
6939
6922
  #
6940
6923
  # @option params [Boolean] :delete_target
6941
6924
  # A value that indicates whether to delete the resources in the green
6942
- # environment.
6925
+ # environment. You can't specify this option if the blue/green
6926
+ # deployment [status][1] is `SWITCHOVER_COMPLETED`.
6927
+ #
6928
+ #
6929
+ #
6930
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_BlueGreenDeployment.html
6943
6931
  #
6944
6932
  # @return [Types::DeleteBlueGreenDeploymentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6945
6933
  #
@@ -7004,7 +6992,7 @@ module Aws::RDS
7004
6992
  #
7005
6993
  # </note>
7006
6994
  #
7007
- # For more information, see [ Deleting a CEV][1] in the *Amazon RDS User
6995
+ # For more information, see [Deleting a CEV][1] in the *Amazon RDS User
7008
6996
  # Guide*.
7009
6997
  #
7010
6998
  #
@@ -7135,9 +7123,8 @@ module Aws::RDS
7135
7123
  # For more information on Amazon Aurora, see [ What is Amazon
7136
7124
  # Aurora?][1] in the *Amazon Aurora User Guide*.
7137
7125
  #
7138
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
7139
- # deployments with two readable standby DB instances][2] in the *Amazon
7140
- # RDS User Guide*.
7126
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
7127
+ # cluster deployments][2] in the *Amazon RDS User Guide*.
7141
7128
  #
7142
7129
  #
7143
7130
  #
@@ -7396,9 +7383,8 @@ module Aws::RDS
7396
7383
  # For more information on Amazon Aurora, see [ What is Amazon
7397
7384
  # Aurora?][1] in the *Amazon Aurora User Guide*.
7398
7385
  #
7399
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
7400
- # deployments with two readable standby DB instances][2] in the *Amazon
7401
- # RDS User Guide*.
7386
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
7387
+ # cluster deployments][2] in the *Amazon RDS User Guide*.
7402
7388
  #
7403
7389
  #
7404
7390
  #
@@ -7453,9 +7439,8 @@ module Aws::RDS
7453
7439
  # For more information on Amazon Aurora, see [ What is Amazon
7454
7440
  # Aurora?][1] in the *Amazon Aurora User Guide*.
7455
7441
  #
7456
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
7457
- # deployments with two readable standby DB instances][2] in the *Amazon
7458
- # RDS User Guide*.
7442
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
7443
+ # cluster deployments][2] in the *Amazon RDS User Guide*.
7459
7444
  #
7460
7445
  #
7461
7446
  #
@@ -8862,9 +8847,8 @@ module Aws::RDS
8862
8847
  # For more information on Amazon Aurora, see [ What is Amazon
8863
8848
  # Aurora?][1] in the *Amazon Aurora User Guide*.
8864
8849
  #
8865
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
8866
- # deployments with two readable standby DB instances][2] in the *Amazon
8867
- # RDS User Guide*.
8850
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
8851
+ # cluster deployments][2] in the *Amazon RDS User Guide*.
8868
8852
  #
8869
8853
  #
8870
8854
  #
@@ -8959,9 +8943,8 @@ module Aws::RDS
8959
8943
  # For more information on Amazon Aurora, see [ What is Amazon
8960
8944
  # Aurora?][1] in the *Amazon Aurora User Guide*.
8961
8945
  #
8962
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
8963
- # deployments with two readable standby DB instances][2] in the *Amazon
8964
- # RDS User Guide*.
8946
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
8947
+ # cluster deployments][2] in the *Amazon RDS User Guide*.
8965
8948
  #
8966
8949
  #
8967
8950
  #
@@ -9132,9 +9115,8 @@ module Aws::RDS
9132
9115
  # For more information on Amazon Aurora DB clusters, see [ What is
9133
9116
  # Amazon Aurora?][1] in the *Amazon Aurora User Guide*.
9134
9117
  #
9135
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
9136
- # deployments with two readable standby DB instances][2] in the *Amazon
9137
- # RDS User Guide*.
9118
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
9119
+ # cluster deployments][2] in the *Amazon RDS User Guide*.
9138
9120
  #
9139
9121
  #
9140
9122
  #
@@ -9334,9 +9316,8 @@ module Aws::RDS
9334
9316
  # For more information on Amazon Aurora DB clusters, see [ What is
9335
9317
  # Amazon Aurora?][1] in the *Amazon Aurora User Guide*.
9336
9318
  #
9337
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
9338
- # deployments with two readable standby DB instances][2] in the *Amazon
9339
- # RDS User Guide*.
9319
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
9320
+ # cluster deployments][2] in the *Amazon RDS User Guide*.
9340
9321
  #
9341
9322
  # This operation can also return information for Amazon Neptune DB
9342
9323
  # instances and Amazon DocumentDB instances.
@@ -9571,8 +9552,6 @@ module Aws::RDS
9571
9552
  #
9572
9553
  # Valid Values:
9573
9554
  #
9574
- # * `aurora` (for MySQL 5.6-compatible Aurora)
9575
- #
9576
9555
  # * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
9577
9556
  # Aurora)
9578
9557
  #
@@ -11880,29 +11859,30 @@ module Aws::RDS
11880
11859
  req.send_request(options)
11881
11860
  end
11882
11861
 
11883
- # Returns information about a snapshot export to Amazon S3. This API
11884
- # operation supports pagination.
11862
+ # Returns information about a snapshot or cluster export to Amazon S3.
11863
+ # This API operation supports pagination.
11885
11864
  #
11886
11865
  # @option params [String] :export_task_identifier
11887
- # The identifier of the snapshot export task to be described.
11866
+ # The identifier of the snapshot or cluster export task to be described.
11888
11867
  #
11889
11868
  # @option params [String] :source_arn
11890
- # The Amazon Resource Name (ARN) of the snapshot exported to Amazon S3.
11869
+ # The Amazon Resource Name (ARN) of the snapshot or cluster exported to
11870
+ # Amazon S3.
11891
11871
  #
11892
11872
  # @option params [Array<Types::Filter>] :filters
11893
- # Filters specify one or more snapshot exports to describe. The filters
11894
- # are specified as name-value pairs that define what to include in the
11895
- # output. Filter names and values are case-sensitive.
11873
+ # Filters specify one or more snapshot or cluster exports to describe.
11874
+ # The filters are specified as name-value pairs that define what to
11875
+ # include in the output. Filter names and values are case-sensitive.
11896
11876
  #
11897
11877
  # Supported filters include the following:
11898
11878
  #
11899
- # * `export-task-identifier` - An identifier for the snapshot export
11900
- # task.
11879
+ # * `export-task-identifier` - An identifier for the snapshot or cluster
11880
+ # export task.
11901
11881
  #
11902
- # * `s3-bucket` - The Amazon S3 bucket the snapshot is exported to.
11882
+ # * `s3-bucket` - The Amazon S3 bucket the data is exported to.
11903
11883
  #
11904
- # * `source-arn` - The Amazon Resource Name (ARN) of the snapshot
11905
- # exported to Amazon S3
11884
+ # * `source-arn` - The Amazon Resource Name (ARN) of the snapshot or
11885
+ # cluster exported to Amazon S3.
11906
11886
  #
11907
11887
  # * `status` - The status of the export task. Must be lowercase. Valid
11908
11888
  # statuses are the following:
@@ -12372,8 +12352,6 @@ module Aws::RDS
12372
12352
  #
12373
12353
  # Valid Values:
12374
12354
  #
12375
- # * `aurora` (for MySQL 5.6-compatible Aurora)
12376
- #
12377
12355
  # * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
12378
12356
  # Aurora)
12379
12357
  #
@@ -13234,9 +13212,8 @@ module Aws::RDS
13234
13212
  # For more information on Amazon Aurora DB clusters, see [ What is
13235
13213
  # Amazon Aurora?][1] in the *Amazon Aurora User Guide*.
13236
13214
  #
13237
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
13238
- # deployments with two readable standby DB instances][2] in the *Amazon
13239
- # RDS User Guide*.
13215
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
13216
+ # cluster deployments][2] in the *Amazon RDS User Guide*.
13240
13217
  #
13241
13218
  #
13242
13219
  #
@@ -13572,15 +13549,17 @@ module Aws::RDS
13572
13549
  # For more information, see [ Modifying a database activity stream][1]
13573
13550
  # in the *Amazon RDS User Guide*.
13574
13551
  #
13575
- # This operation is supported for RDS for Oracle only.
13552
+ # This operation is supported for RDS for Oracle and Microsoft SQL
13553
+ # Server.
13576
13554
  #
13577
13555
  #
13578
13556
  #
13579
13557
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/DBActivityStreams.Modifying.html
13580
13558
  #
13581
13559
  # @option params [String] :resource_arn
13582
- # The Amazon Resource Name (ARN) of the RDS for Oracle DB instance, for
13583
- # example, `arn:aws:rds:us-east-1:12345667890:instance:my-orcl-db`.
13560
+ # The Amazon Resource Name (ARN) of the RDS for Oracle or Microsoft SQL
13561
+ # Server DB instance. For example,
13562
+ # `arn:aws:rds:us-east-1:12345667890:instance:my-orcl-db`.
13584
13563
  #
13585
13564
  # @option params [String] :audit_policy_state
13586
13565
  # The audit policy state. When a policy is unlocked, it is read/write.
@@ -13976,9 +13955,8 @@ module Aws::RDS
13976
13955
  # For more information on Amazon Aurora DB clusters, see [ What is
13977
13956
  # Amazon Aurora?][1] in the *Amazon Aurora User Guide*.
13978
13957
  #
13979
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
13980
- # deployments with two readable standby DB instances][2] in the *Amazon
13981
- # RDS User Guide*.
13958
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
13959
+ # cluster deployments][2] in the *Amazon RDS User Guide*.
13982
13960
  #
13983
13961
  #
13984
13962
  #
@@ -14201,14 +14179,9 @@ module Aws::RDS
14201
14179
  # applied during the next maintenance window unless `ApplyImmediately`
14202
14180
  # is enabled.
14203
14181
  #
14204
- # To list all of the available engine versions for MySQL 5.6-compatible
14205
- # Aurora, use the following command:
14206
- #
14207
- # `aws rds describe-db-engine-versions --engine aurora --query
14208
- # "DBEngineVersions[].EngineVersion"`
14209
- #
14210
- # To list all of the available engine versions for MySQL 5.7-compatible
14211
- # and MySQL 8.0-compatible Aurora, use the following command:
14182
+ # To list all of the available engine versions for Aurora MySQL version
14183
+ # 2 (5.7-compatible) and version 3 (MySQL 8.0-compatible), use the
14184
+ # following command:
14212
14185
  #
14213
14186
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
14214
14187
  # "DBEngineVersions[].EngineVersion"`
@@ -14899,9 +14872,8 @@ module Aws::RDS
14899
14872
  # For more information on Amazon Aurora DB clusters, see [ What is
14900
14873
  # Amazon Aurora?][2] in the *Amazon Aurora User Guide*.
14901
14874
  #
14902
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
14903
- # deployments with two readable standby DB instances][3] in the *Amazon
14904
- # RDS User Guide.*
14875
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
14876
+ # cluster deployments][3] in the *Amazon RDS User Guide.*
14905
14877
  #
14906
14878
  #
14907
14879
  #
@@ -17787,9 +17759,8 @@ module Aws::RDS
17787
17759
  #
17788
17760
  # Use this operation only for a non-Aurora Multi-AZ DB cluster.
17789
17761
  #
17790
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
17791
- # deployments with two readable standby DB instances][1] in the *Amazon
17792
- # RDS User Guide.*
17762
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
17763
+ # cluster deployments][1] in the *Amazon RDS User Guide.*
17793
17764
  #
17794
17765
  #
17795
17766
  #
@@ -18278,9 +18249,8 @@ module Aws::RDS
18278
18249
  # For more information on Amazon Aurora DB clusters, see [ What is
18279
18250
  # Amazon Aurora?][1] in the *Amazon Aurora User Guide*.
18280
18251
  #
18281
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
18282
- # deployments with two readable standby DB instances][2] in the *Amazon
18283
- # RDS User Guide.*
18252
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
18253
+ # cluster deployments][2] in the *Amazon RDS User Guide.*
18284
18254
  #
18285
18255
  #
18286
18256
  #
@@ -18484,9 +18454,8 @@ module Aws::RDS
18484
18454
  # For more information on Amazon Aurora DB clusters, see [ What is
18485
18455
  # Amazon Aurora?][1] in the *Amazon Aurora User Guide*.
18486
18456
  #
18487
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
18488
- # deployments with two readable standby DB instances][2] in the *Amazon
18489
- # RDS User Guide.*
18457
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
18458
+ # cluster deployments][2] in the *Amazon RDS User Guide.*
18490
18459
  #
18491
18460
  #
18492
18461
  #
@@ -18755,30 +18724,22 @@ module Aws::RDS
18755
18724
  # @option params [required, String] :engine
18756
18725
  # The name of the database engine to be used for this DB cluster.
18757
18726
  #
18758
- # Valid Values: `aurora` (for MySQL 5.6-compatible Aurora) and
18759
- # `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
18760
- # Aurora)
18727
+ # Valid Values: `aurora-mysql` (for MySQL 5.7-compatible and MySQL
18728
+ # 8.0-compatible Aurora)
18761
18729
  #
18762
18730
  # @option params [String] :engine_version
18763
18731
  # The version number of the database engine to use.
18764
18732
  #
18765
- # To list all of the available engine versions for `aurora` (for MySQL
18766
- # 5.6-compatible Aurora), use the following command:
18767
- #
18768
- # `aws rds describe-db-engine-versions --engine aurora --query
18769
- # "DBEngineVersions[].EngineVersion"`
18770
- #
18771
- # To list all of the available engine versions for `aurora-mysql` (for
18772
- # MySQL 5.7-compatible and MySQL 8.0-compatible Aurora), use the
18773
- # following command:
18733
+ # To list all of the available engine versions for `aurora-mysql` (MySQL
18734
+ # 5.7-compatible and MySQL 8.0-compatible Aurora), use the following
18735
+ # command:
18774
18736
  #
18775
18737
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
18776
18738
  # "DBEngineVersions[].EngineVersion"`
18777
18739
  #
18778
18740
  # **Aurora MySQL**
18779
18741
  #
18780
- # Example: `5.6.10a`, `5.6.mysql_aurora.1.19.2`,
18781
- # `5.7.mysql_aurora.2.07.1`, `8.0.mysql_aurora.3.02.0`
18742
+ # Examples: `5.7.mysql_aurora.2.07.1`, `8.0.mysql_aurora.3.02.0`
18782
18743
  #
18783
18744
  # @option params [Integer] :port
18784
18745
  # The port number on which the instances in the restored DB cluster
@@ -18951,10 +18912,6 @@ module Aws::RDS
18951
18912
  #
18952
18913
  # Possible values are `audit`, `error`, `general`, and `slowquery`.
18953
18914
  #
18954
- # **Aurora PostgreSQL**
18955
- #
18956
- # Possible value is `postgresql`.
18957
- #
18958
18915
  # For more information about exporting CloudWatch Logs for Amazon
18959
18916
  # Aurora, see [Publishing Database Logs to Amazon CloudWatch Logs][1] in
18960
18917
  # the *Amazon Aurora User Guide*.
@@ -19257,9 +19214,8 @@ module Aws::RDS
19257
19214
  # For more information on Amazon Aurora DB clusters, see [ What is
19258
19215
  # Amazon Aurora?][1] in the *Amazon Aurora User Guide*.
19259
19216
  #
19260
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
19261
- # deployments with two readable standby DB instances][2] in the *Amazon
19262
- # RDS User Guide.*
19217
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
19218
+ # cluster deployments][2] in the *Amazon RDS User Guide.*
19263
19219
  #
19264
19220
  #
19265
19221
  #
@@ -19314,13 +19270,9 @@ module Aws::RDS
19314
19270
  # Valid for: Aurora DB clusters and Multi-AZ DB clusters
19315
19271
  #
19316
19272
  # @option params [String] :engine_version
19317
- # The version of the database engine to use for the new DB cluster.
19318
- #
19319
- # To list all of the available engine versions for MySQL 5.6-compatible
19320
- # Aurora, use the following command:
19321
- #
19322
- # `aws rds describe-db-engine-versions --engine aurora --query
19323
- # "DBEngineVersions[].EngineVersion"`
19273
+ # The version of the database engine to use for the new DB cluster. If
19274
+ # you don't specify an engine version, the default version for the
19275
+ # database engine in the Amazon Web Services Region is used.
19324
19276
  #
19325
19277
  # To list all of the available engine versions for MySQL 5.7-compatible
19326
19278
  # and MySQL 8.0-compatible Aurora, use the following command:
@@ -19348,8 +19300,8 @@ module Aws::RDS
19348
19300
  #
19349
19301
  # **Aurora MySQL**
19350
19302
  #
19351
- # See [MySQL on Amazon RDS Versions][1] in the *Amazon Aurora User
19352
- # Guide*.
19303
+ # See [Database engine updates for Amazon Aurora MySQL][1] in the
19304
+ # *Amazon Aurora User Guide*.
19353
19305
  #
19354
19306
  # **Aurora PostgreSQL**
19355
19307
  #
@@ -19358,7 +19310,7 @@ module Aws::RDS
19358
19310
  #
19359
19311
  # **MySQL**
19360
19312
  #
19361
- # See [MySQL on Amazon RDS Versions][3] in the *Amazon RDS User Guide.*
19313
+ # See [Amazon RDS for MySQL][3] in the *Amazon RDS User Guide.*
19362
19314
  #
19363
19315
  # **PostgreSQL**
19364
19316
  #
@@ -19900,9 +19852,8 @@ module Aws::RDS
19900
19852
  # For more information on Amazon Aurora DB clusters, see [ What is
19901
19853
  # Amazon Aurora?][1] in the *Amazon Aurora User Guide*.
19902
19854
  #
19903
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
19904
- # deployments with two readable standby DB instances][2] in the *Amazon
19905
- # RDS User Guide.*
19855
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
19856
+ # cluster deployments][2] in the *Amazon RDS User Guide.*
19906
19857
  #
19907
19858
  #
19908
19859
  #
@@ -20925,9 +20876,8 @@ module Aws::RDS
20925
20876
  # The identifier for the RDS for MySQL Multi-AZ DB cluster snapshot to
20926
20877
  # restore from.
20927
20878
  #
20928
- # For more information on Multi-AZ DB clusters, see [ Multi-AZ
20929
- # deployments with two readable standby DB instances][1] in the *Amazon
20930
- # RDS User Guide*.
20879
+ # For more information on Multi-AZ DB clusters, see [ Multi-AZ DB
20880
+ # cluster deployments][1] in the *Amazon RDS User Guide*.
20931
20881
  #
20932
20882
  # Constraints:
20933
20883
  #
@@ -20955,9 +20905,9 @@ module Aws::RDS
20955
20905
  # The amount of storage (in gibibytes) to allocate initially for the DB
20956
20906
  # instance. Follow the allocation rules specified in CreateDBInstance.
20957
20907
  #
20958
- # <note markdown="1"> Be sure to allocate enough memory for your new DB instance so that the
20959
- # restore operation can succeed. You can also allocate additional memory
20960
- # for future growth.
20908
+ # <note markdown="1"> Be sure to allocate enough storage for your new DB instance so that
20909
+ # the restore operation can succeed. You can also allocate additional
20910
+ # storage for future growth.
20961
20911
  #
20962
20912
  # </note>
20963
20913
  #
@@ -21305,9 +21255,9 @@ module Aws::RDS
21305
21255
  # The amount of storage (in gibibytes) to allocate initially for the DB
21306
21256
  # instance. Follow the allocation rules specified in `CreateDBInstance`.
21307
21257
  #
21308
- # <note markdown="1"> Be sure to allocate enough memory for your new DB instance so that the
21309
- # restore operation can succeed. You can also allocate additional memory
21310
- # for future growth.
21258
+ # <note markdown="1"> Be sure to allocate enough storage for your new DB instance so that
21259
+ # the restore operation can succeed. You can also allocate additional
21260
+ # storage for future growth.
21311
21261
  #
21312
21262
  # </note>
21313
21263
  #
@@ -22440,9 +22390,9 @@ module Aws::RDS
22440
22390
  # The amount of storage (in gibibytes) to allocate initially for the DB
22441
22391
  # instance. Follow the allocation rules specified in `CreateDBInstance`.
22442
22392
  #
22443
- # <note markdown="1"> Be sure to allocate enough memory for your new DB instance so that the
22444
- # restore operation can succeed. You can also allocate additional memory
22445
- # for future growth.
22393
+ # <note markdown="1"> Be sure to allocate enough storage for your new DB instance so that
22394
+ # the restore operation can succeed. You can also allocate additional
22395
+ # storage for future growth.
22446
22396
  #
22447
22397
  # </note>
22448
22398
  #
@@ -22898,8 +22848,8 @@ module Aws::RDS
22898
22848
  #
22899
22849
  # @option params [Boolean] :engine_native_audit_fields_included
22900
22850
  # Specifies whether the database activity stream includes engine-native
22901
- # audit fields. This option only applies to an Oracle DB instance. By
22902
- # default, no engine-native audit fields are included.
22851
+ # audit fields. This option applies to an Oracle or Microsoft SQL Server
22852
+ # DB instance. By default, no engine-native audit fields are included.
22903
22853
  #
22904
22854
  # @return [Types::StartActivityStreamResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
22905
22855
  #
@@ -23396,33 +23346,72 @@ module Aws::RDS
23396
23346
  req.send_request(options)
23397
23347
  end
23398
23348
 
23399
- # Starts an export of a snapshot to Amazon S3. The provided IAM role
23400
- # must have access to the S3 bucket.
23349
+ # Starts an export of DB snapshot or DB cluster data to Amazon S3. The
23350
+ # provided IAM role must have access to the S3 bucket.
23351
+ #
23352
+ # You can't export snapshot data from RDS Custom DB instances.
23353
+ #
23354
+ # You can't export cluster data from Multi-AZ DB clusters.
23355
+ #
23356
+ # For more information on exporting DB snapshot data, see [Exporting DB
23357
+ # snapshot data to Amazon S3][1] in the *Amazon RDS User Guide* or
23358
+ # [Exporting DB cluster snapshot data to Amazon S3][2] in the *Amazon
23359
+ # Aurora User Guide*.
23360
+ #
23361
+ # For more information on exporting DB cluster data, see [Exporting DB
23362
+ # cluster data to Amazon S3][3] in the *Amazon Aurora User Guide*.
23401
23363
  #
23402
- # This command doesn't apply to RDS Custom.
23364
+ #
23365
+ #
23366
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ExportSnapshot.html
23367
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-export-snapshot.html
23368
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/export-cluster-data.html
23403
23369
  #
23404
23370
  # @option params [required, String] :export_task_identifier
23405
- # A unique identifier for the snapshot export task. This ID isn't an
23406
- # identifier for the Amazon S3 bucket where the snapshot is to be
23407
- # exported to.
23371
+ # A unique identifier for the export task. This ID isn't an identifier
23372
+ # for the Amazon S3 bucket where the data is to be exported.
23408
23373
  #
23409
23374
  # @option params [required, String] :source_arn
23410
- # The Amazon Resource Name (ARN) of the snapshot to export to Amazon S3.
23375
+ # The Amazon Resource Name (ARN) of the snapshot or cluster to export to
23376
+ # Amazon S3.
23411
23377
  #
23412
23378
  # @option params [required, String] :s3_bucket_name
23413
- # The name of the Amazon S3 bucket to export the snapshot to.
23379
+ # The name of the Amazon S3 bucket to export the snapshot or cluster
23380
+ # data to.
23414
23381
  #
23415
23382
  # @option params [required, String] :iam_role_arn
23416
23383
  # The name of the IAM role to use for writing to the Amazon S3 bucket
23417
- # when exporting a snapshot.
23384
+ # when exporting a snapshot or cluster.
23385
+ #
23386
+ # In the IAM policy attached to your IAM role, include the following
23387
+ # required actions to allow the transfer of files from Amazon RDS or
23388
+ # Amazon Aurora to an S3 bucket:
23389
+ #
23390
+ # * s3:PutObject*
23391
+ #
23392
+ # * s3:GetObject*
23393
+ #
23394
+ # * s3:ListBucket
23395
+ #
23396
+ # * s3:DeleteObject*
23397
+ #
23398
+ # * s3:GetBucketLocation
23399
+ #
23400
+ # In the policy, include the resources to identify the S3 bucket and
23401
+ # objects in the bucket. The following list of resources shows the
23402
+ # Amazon Resource Name (ARN) format for accessing S3:
23403
+ #
23404
+ # * `arn:aws:s3:::your-s3-bucket `
23405
+ #
23406
+ # * `arn:aws:s3:::your-s3-bucket/*`
23418
23407
  #
23419
23408
  # @option params [required, String] :kms_key_id
23420
- # The ID of the Amazon Web Services KMS key to use to encrypt the
23421
- # snapshot exported to Amazon S3. The Amazon Web Services KMS key
23422
- # identifier is the key ARN, key ID, alias ARN, or alias name for the
23423
- # KMS key. The caller of this operation must be authorized to run the
23424
- # following operations. These can be set in the Amazon Web Services KMS
23425
- # key policy:
23409
+ # The ID of the Amazon Web Services KMS key to use to encrypt the data
23410
+ # exported to Amazon S3. The Amazon Web Services KMS key identifier is
23411
+ # the key ARN, key ID, alias ARN, or alias name for the KMS key. The
23412
+ # caller of this operation must be authorized to run the following
23413
+ # operations. These can be set in the Amazon Web Services KMS key
23414
+ # policy:
23426
23415
  #
23427
23416
  # * kms:Encrypt
23428
23417
  #
@@ -23444,22 +23433,22 @@ module Aws::RDS
23444
23433
  #
23445
23434
  # @option params [String] :s3_prefix
23446
23435
  # The Amazon S3 bucket prefix to use as the file name and path of the
23447
- # exported snapshot.
23436
+ # exported data.
23448
23437
  #
23449
23438
  # @option params [Array<String>] :export_only
23450
- # The data to be exported from the snapshot. If this parameter is not
23451
- # provided, all the snapshot data is exported. Valid values are the
23452
- # following:
23439
+ # The data to be exported from the snapshot or cluster. If this
23440
+ # parameter is not provided, all of the data is exported. Valid values
23441
+ # are the following:
23453
23442
  #
23454
23443
  # * `database` - Export all the data from a specified database.
23455
23444
  #
23456
- # * `database.table` *table-name* - Export a table of the snapshot. This
23457
- # format is valid only for RDS for MySQL, RDS for MariaDB, and Aurora
23458
- # MySQL.
23445
+ # * `database.table` *table-name* - Export a table of the snapshot or
23446
+ # cluster. This format is valid only for RDS for MySQL, RDS for
23447
+ # MariaDB, and Aurora MySQL.
23459
23448
  #
23460
23449
  # * `database.schema` *schema-name* - Export a database schema of the
23461
- # snapshot. This format is valid only for RDS for PostgreSQL and
23462
- # Aurora PostgreSQL.
23450
+ # snapshot or cluster. This format is valid only for RDS for
23451
+ # PostgreSQL and Aurora PostgreSQL.
23463
23452
  #
23464
23453
  # * `database.schema.table` *table-name* - Export a table of the
23465
23454
  # database schema. This format is valid only for RDS for PostgreSQL
@@ -24265,7 +24254,7 @@ module Aws::RDS
24265
24254
  params: params,
24266
24255
  config: config)
24267
24256
  context[:gem_name] = 'aws-sdk-rds'
24268
- context[:gem_version] = '1.171.0'
24257
+ context[:gem_version] = '1.173.0'
24269
24258
  Seahorse::Client::Request.new(handlers, context)
24270
24259
  end
24271
24260