aws-sdk-rds 1.171.0 → 1.173.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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