aws-sdk-rds 1.274.0 → 1.282.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.
@@ -202,8 +202,7 @@ module Aws::RDS
202
202
  # accepted modes and the configuration defaults that are included.
203
203
  #
204
204
  # @option options [Boolean] :disable_host_prefix_injection (false)
205
- # Set to true to disable SDK automatically adding host prefix
206
- # to default service endpoint when available.
205
+ # When `true`, the SDK will not prepend the modeled host prefix to the endpoint.
207
206
  #
208
207
  # @option options [Boolean] :disable_request_compression (false)
209
208
  # When set to 'true' the request body will not be compressed
@@ -1842,6 +1841,22 @@ module Aws::RDS
1842
1841
  # associate with the target DB snapshot. The associated option group can
1843
1842
  # be copied only with cross-account snapshot copy calls.
1844
1843
  #
1844
+ # @option params [String] :snapshot_availability_zone
1845
+ # Specifies the name of the Availability Zone where RDS stores the DB
1846
+ # snapshot. This value is valid only for snapshots that RDS stores on a
1847
+ # Dedicated Local Zone.
1848
+ #
1849
+ # @option params [String] :snapshot_target
1850
+ # Configures the location where RDS will store copied snapshots.
1851
+ #
1852
+ # Valid Values:
1853
+ #
1854
+ # * `local` (Dedicated Local Zone)
1855
+ #
1856
+ # * `outposts` (Amazon Web Services Outposts)
1857
+ #
1858
+ # * `region` (Amazon Web Services Region)
1859
+ #
1845
1860
  # @option params [String] :source_region
1846
1861
  # The source region of the snapshot. This is only needed when the
1847
1862
  # shapshot is encrypted and in a different region.
@@ -1909,6 +1924,8 @@ module Aws::RDS
1909
1924
  # option_group_name: "String",
1910
1925
  # target_custom_availability_zone: "String",
1911
1926
  # copy_option_group: false,
1927
+ # snapshot_availability_zone: "String",
1928
+ # snapshot_target: "String",
1912
1929
  # source_region: "String",
1913
1930
  # })
1914
1931
  #
@@ -1954,6 +1971,7 @@ module Aws::RDS
1954
1971
  # resp.db_snapshot.db_system_id #=> String
1955
1972
  # resp.db_snapshot.dedicated_log_volume #=> Boolean
1956
1973
  # resp.db_snapshot.multi_tenant #=> Boolean
1974
+ # resp.db_snapshot.snapshot_availability_zone #=> String
1957
1975
  #
1958
1976
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyDBSnapshot AWS API Documentation
1959
1977
  #
@@ -3577,11 +3595,11 @@ module Aws::RDS
3577
3595
  # support for that engine version. For more information, see the
3578
3596
  # following sections:
3579
3597
  #
3580
- # * Amazon Aurora - [Using Amazon RDS Extended Support][1] in the
3581
- # *Amazon Aurora User Guide*
3598
+ # * Amazon Aurora - [Amazon RDS Extended Support with Amazon Aurora][1]
3599
+ # in the *Amazon Aurora User Guide*
3582
3600
  #
3583
- # * Amazon RDS - [Using Amazon RDS Extended Support][2] in the *Amazon
3584
- # RDS User Guide*
3601
+ # * Amazon RDS - [Amazon RDS Extended Support with Amazon RDS][2] in the
3602
+ # *Amazon RDS User Guide*
3585
3603
  #
3586
3604
  # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
3587
3605
  #
@@ -3907,6 +3925,7 @@ module Aws::RDS
3907
3925
  # resp.db_cluster.tag_list #=> Array
3908
3926
  # resp.db_cluster.tag_list[0].key #=> String
3909
3927
  # resp.db_cluster.tag_list[0].value #=> String
3928
+ # resp.db_cluster.global_cluster_identifier #=> String
3910
3929
  # resp.db_cluster.global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
3911
3930
  # resp.db_cluster.global_write_forwarding_requested #=> Boolean
3912
3931
  # resp.db_cluster.pending_modified_values.pending_cloudwatch_logs_exports.log_types_to_enable #=> Array
@@ -5571,6 +5590,8 @@ module Aws::RDS
5571
5590
  #
5572
5591
  # Valid Values:
5573
5592
  #
5593
+ # * `local` (Dedicated Local Zone)
5594
+ #
5574
5595
  # * `outposts` (Amazon Web Services Outposts)
5575
5596
  #
5576
5597
  # * `region` (Amazon Web Services Region)
@@ -5714,8 +5735,8 @@ module Aws::RDS
5714
5735
  # You can use this setting to enroll your DB instance into Amazon RDS
5715
5736
  # Extended Support. With RDS Extended Support, you can run the selected
5716
5737
  # major engine version on your DB instance past the end of standard
5717
- # support for that engine version. For more information, see [Using
5718
- # Amazon RDS Extended Support][1] in the *Amazon RDS User Guide*.
5738
+ # support for that engine version. For more information, see [Amazon RDS
5739
+ # Extended Support with Amazon RDS][1] in the *Amazon RDS User Guide*.
5719
5740
  #
5720
5741
  # Valid Values: `open-source-rds-extended-support |
5721
5742
  # open-source-rds-extended-support-disabled`
@@ -6095,20 +6116,22 @@ module Aws::RDS
6095
6116
 
6096
6117
  # Creates a new DB instance that acts as a read replica for an existing
6097
6118
  # source DB instance or Multi-AZ DB cluster. You can create a read
6098
- # replica for a DB instance running Db2, MariaDB, MySQL, Oracle,
6099
- # PostgreSQL, or SQL Server. You can create a read replica for a
6100
- # Multi-AZ DB cluster running MySQL or PostgreSQL. For more information,
6101
- # see [Working with read replicas][1] and [Migrating from a Multi-AZ DB
6102
- # cluster to a DB instance using a read replica][2] in the *Amazon RDS
6103
- # User Guide*.
6119
+ # replica for a DB instance running MariaDB, MySQL, Oracle, PostgreSQL,
6120
+ # or SQL Server. You can create a read replica for a Multi-AZ DB cluster
6121
+ # running MySQL or PostgreSQL. For more information, see [Working with
6122
+ # read replicas][1] and [Migrating from a Multi-AZ DB cluster to a DB
6123
+ # instance using a read replica][2] in the *Amazon RDS User Guide*.
6124
+ #
6125
+ # Amazon RDS for Db2 supports this operation for standby replicas. To
6126
+ # create a standby replica for a DB instance running Db2, you must set
6127
+ # `ReplicaMode` to `mounted`.
6104
6128
  #
6105
6129
  # Amazon Aurora doesn't support this operation. To create a DB instance
6106
6130
  # for an Aurora DB cluster, use the `CreateDBInstance` operation.
6107
6131
  #
6108
- # All read replica DB instances are created with backups disabled. All
6109
- # other attributes (including DB security groups and DB parameter
6110
- # groups) are inherited from the source DB instance or cluster, except
6111
- # as specified.
6132
+ # RDS creates read replicas with backups disabled. All other attributes
6133
+ # (including DB security groups and DB parameter groups) are inherited
6134
+ # from the source DB instance or cluster, except as specified.
6112
6135
  #
6113
6136
  # Your source DB instance or cluster must have backup retention enabled.
6114
6137
  #
@@ -6124,8 +6147,14 @@ module Aws::RDS
6124
6147
  #
6125
6148
  # @option params [String] :source_db_instance_identifier
6126
6149
  # The identifier of the DB instance that will act as the source for the
6127
- # read replica. Each DB instance can have up to 15 read replicas, with
6128
- # the exception of Oracle and SQL Server, which can have up to five.
6150
+ # read replica. Each DB instance can have up to 15 read replicas, except
6151
+ # for the following engines:
6152
+ #
6153
+ # * Db2 - Can have up to three replicas.
6154
+ #
6155
+ # * Oracle - Can have up to five read replicas.
6156
+ #
6157
+ # * SQL Server - Can have up to five read replicas.
6129
6158
  #
6130
6159
  # Constraints:
6131
6160
  #
@@ -6234,6 +6263,16 @@ module Aws::RDS
6234
6263
  # The name of the DB parameter group to associate with this read replica
6235
6264
  # DB instance.
6236
6265
  #
6266
+ # For the Db2 DB engine, if your source DB instance uses the Bring Your
6267
+ # Own License model, then a custom parameter group must be associated
6268
+ # with the replica. For a same Amazon Web Services Region replica, if
6269
+ # you don't specify a custom parameter group, Amazon RDS associates the
6270
+ # custom parameter group associated with the source DB instance. For a
6271
+ # cross-Region replica, you must specify a custom parameter group. This
6272
+ # custom parameter group must include your IBM Site ID and IBM Customer
6273
+ # ID. For more information, see [ IBM IDs for Bring Your Own License for
6274
+ # Db2][1].
6275
+ #
6237
6276
  # For Single-AZ or Multi-AZ DB instance read replica instances, if you
6238
6277
  # don't specify a value for `DBParameterGroupName`, then Amazon RDS
6239
6278
  # uses the `DBParameterGroup` of the source DB instance for a same
@@ -6246,9 +6285,9 @@ module Aws::RDS
6246
6285
  #
6247
6286
  # Specifying a parameter group for this operation is only supported for
6248
6287
  # MySQL DB instances for cross-Region read replicas, for Multi-AZ DB
6249
- # cluster read replica instances, and for Oracle DB instances. It isn't
6250
- # supported for MySQL DB instances for same Region read replicas or for
6251
- # RDS Custom.
6288
+ # cluster read replica instances, for Db2 DB instances, and for Oracle
6289
+ # DB instances. It isn't supported for MySQL DB instances for same
6290
+ # Region read replicas or for RDS Custom.
6252
6291
  #
6253
6292
  # Constraints:
6254
6293
  #
@@ -6258,6 +6297,10 @@ module Aws::RDS
6258
6297
  #
6259
6298
  # * Can't end with a hyphen or contain two consecutive hyphens.
6260
6299
  #
6300
+ #
6301
+ #
6302
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/db2-licensing.html#db2-prereqs-ibm-info
6303
+ #
6261
6304
  # @option params [Boolean] :publicly_accessible
6262
6305
  # Specifies whether the DB instance is publicly accessible.
6263
6306
  #
@@ -6631,31 +6674,50 @@ module Aws::RDS
6631
6674
  # Example: `123.124.125.126,234.235.236.237`
6632
6675
  #
6633
6676
  # @option params [String] :replica_mode
6634
- # The open mode of the replica database: mounted or read-only.
6677
+ # The open mode of the replica database.
6635
6678
  #
6636
- # <note markdown="1"> This parameter is only supported for Oracle DB instances.
6679
+ # <note markdown="1"> This parameter is only supported for Db2 DB instances and Oracle DB
6680
+ # instances.
6637
6681
  #
6638
6682
  # </note>
6639
6683
  #
6640
- # Mounted DB replicas are included in Oracle Database Enterprise
6641
- # Edition. The main use case for mounted replicas is cross-Region
6642
- # disaster recovery. The primary database doesn't use Active Data Guard
6643
- # to transmit information to the mounted replica. Because it doesn't
6644
- # accept user connections, a mounted replica can't serve a read-only
6645
- # workload.
6684
+ # Db2
6646
6685
  #
6647
- # You can create a combination of mounted and read-only DB replicas for
6648
- # the same primary DB instance. For more information, see [Working with
6649
- # Oracle Read Replicas for Amazon RDS][1] in the *Amazon RDS User
6650
- # Guide*.
6686
+ # : Standby DB replicas are included in Db2 Advanced Edition (AE) and
6687
+ # Db2 Standard Edition (SE). The main use case for standby replicas is
6688
+ # cross-Region disaster recovery. Because it doesn't accept user
6689
+ # connections, a standby replica can't serve a read-only workload.
6690
+ #
6691
+ # You can create a combination of standby and read-only DB replicas
6692
+ # for the same primary DB instance. For more information, see [Working
6693
+ # with read replicas for Amazon RDS for Db2][1] in the *Amazon RDS
6694
+ # User Guide*.
6695
+ #
6696
+ # To create standby DB replicas for RDS for Db2, set this parameter to
6697
+ # `mounted`.
6698
+ #
6699
+ # Oracle
6700
+ #
6701
+ # : Mounted DB replicas are included in Oracle Database Enterprise
6702
+ # Edition. The main use case for mounted replicas is cross-Region
6703
+ # disaster recovery. The primary database doesn't use Active Data
6704
+ # Guard to transmit information to the mounted replica. Because it
6705
+ # doesn't accept user connections, a mounted replica can't serve a
6706
+ # read-only workload.
6651
6707
  #
6652
- # For RDS Custom, you must specify this parameter and set it to
6653
- # `mounted`. The value won't be set by default. After replica creation,
6654
- # you can manage the open mode manually.
6708
+ # You can create a combination of mounted and read-only DB replicas
6709
+ # for the same primary DB instance. For more information, see [Working
6710
+ # with read replicas for Amazon RDS for Oracle][2] in the *Amazon RDS
6711
+ # User Guide*.
6712
+ #
6713
+ # For RDS Custom, you must specify this parameter and set it to
6714
+ # `mounted`. The value won't be set by default. After replica
6715
+ # creation, you can manage the open mode manually.
6655
6716
  #
6656
6717
  #
6657
6718
  #
6658
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
6719
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/db2-replication.html
6720
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
6659
6721
  #
6660
6722
  # @option params [Integer] :max_allocated_storage
6661
6723
  # The upper limit in gibibytes (GiB) to which Amazon RDS can
@@ -6738,6 +6800,15 @@ module Aws::RDS
6738
6800
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
6739
6801
  # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/routing.html#ip-addressing
6740
6802
  #
6803
+ # @option params [String] :backup_target
6804
+ # The location where RDS stores automated backups and manual snapshots.
6805
+ #
6806
+ # Valid Values:
6807
+ #
6808
+ # * `local` for Dedicated Local Zones
6809
+ #
6810
+ # * `region` for Amazon Web Services Region
6811
+ #
6741
6812
  # @option params [Integer] :allocated_storage
6742
6813
  # The amount of storage (in gibibytes) to allocate initially for the
6743
6814
  # read replica. Follow the allocation rules specified in
@@ -6877,6 +6948,7 @@ module Aws::RDS
6877
6948
  # network_type: "String",
6878
6949
  # storage_throughput: 1,
6879
6950
  # enable_customer_owned_ip: false,
6951
+ # backup_target: "String",
6880
6952
  # allocated_storage: 1,
6881
6953
  # source_db_cluster_identifier: "String",
6882
6954
  # dedicated_log_volume: false,
@@ -7521,17 +7593,17 @@ module Aws::RDS
7521
7593
  # The name of the primary DB cluster for the DB shard group.
7522
7594
  #
7523
7595
  # @option params [Integer] :compute_redundancy
7524
- # Specifies whether to create standby DB shard groups for the DB shard
7525
- # group. Valid values are the following:
7596
+ # Specifies whether to create standby standby DB data access shard for
7597
+ # the DB shard group. Valid values are the following:
7526
7598
  #
7527
- # * 0 - Creates a DB shard group without a standby DB shard group. This
7528
- # is the default value.
7599
+ # * 0 - Creates a DB shard group without a standby DB data access shard.
7600
+ # This is the default value.
7529
7601
  #
7530
- # * 1 - Creates a DB shard group with a standby DB shard group in a
7531
- # different Availability Zone (AZ).
7602
+ # * 1 - Creates a DB shard group with a standby DB data access shard in
7603
+ # a different Availability Zone (AZ).
7532
7604
  #
7533
- # * 2 - Creates a DB shard group with two standby DB shard groups in two
7534
- # different AZs.
7605
+ # * 2 - Creates a DB shard group with two standby DB data access shard
7606
+ # in two different AZs.
7535
7607
  #
7536
7608
  # @option params [required, Float] :max_acu
7537
7609
  # The maximum capacity of the DB shard group in Aurora capacity units
@@ -7783,6 +7855,7 @@ module Aws::RDS
7783
7855
  # resp.db_snapshot.db_system_id #=> String
7784
7856
  # resp.db_snapshot.dedicated_log_volume #=> Boolean
7785
7857
  # resp.db_snapshot.multi_tenant #=> Boolean
7858
+ # resp.db_snapshot.snapshot_availability_zone #=> String
7786
7859
  #
7787
7860
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBSnapshot AWS API Documentation
7788
7861
  #
@@ -8195,8 +8268,9 @@ module Aws::RDS
8195
8268
  # You can use this setting to enroll your global cluster into Amazon RDS
8196
8269
  # Extended Support. With RDS Extended Support, you can run the selected
8197
8270
  # major engine version on your global cluster past the end of standard
8198
- # support for that engine version. For more information, see [Using
8199
- # Amazon RDS Extended Support][1] in the *Amazon Aurora User Guide*.
8271
+ # support for that engine version. For more information, see [Amazon RDS
8272
+ # Extended Support with Amazon Aurora][1] in the *Amazon Aurora User
8273
+ # Guide*.
8200
8274
  #
8201
8275
  # Valid Values: `open-source-rds-extended-support |
8202
8276
  # open-source-rds-extended-support-disabled`
@@ -9350,6 +9424,7 @@ module Aws::RDS
9350
9424
  # resp.db_cluster.tag_list #=> Array
9351
9425
  # resp.db_cluster.tag_list[0].key #=> String
9352
9426
  # resp.db_cluster.tag_list[0].value #=> String
9427
+ # resp.db_cluster.global_cluster_identifier #=> String
9353
9428
  # resp.db_cluster.global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
9354
9429
  # resp.db_cluster.global_write_forwarding_requested #=> Boolean
9355
9430
  # resp.db_cluster.pending_modified_values.pending_cloudwatch_logs_exports.log_types_to_enable #=> Array
@@ -10472,6 +10547,7 @@ module Aws::RDS
10472
10547
  # resp.db_snapshot.db_system_id #=> String
10473
10548
  # resp.db_snapshot.dedicated_log_volume #=> Boolean
10474
10549
  # resp.db_snapshot.multi_tenant #=> Boolean
10550
+ # resp.db_snapshot.snapshot_availability_zone #=> String
10475
10551
  #
10476
10552
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBSnapshot AWS API Documentation
10477
10553
  #
@@ -12802,6 +12878,7 @@ module Aws::RDS
12802
12878
  # resp.db_clusters[0].tag_list #=> Array
12803
12879
  # resp.db_clusters[0].tag_list[0].key #=> String
12804
12880
  # resp.db_clusters[0].tag_list[0].value #=> String
12881
+ # resp.db_clusters[0].global_cluster_identifier #=> String
12805
12882
  # resp.db_clusters[0].global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
12806
12883
  # resp.db_clusters[0].global_write_forwarding_requested #=> Boolean
12807
12884
  # resp.db_clusters[0].pending_modified_values.pending_cloudwatch_logs_exports.log_types_to_enable #=> Array
@@ -13737,6 +13814,103 @@ module Aws::RDS
13737
13814
  req.send_request(options)
13738
13815
  end
13739
13816
 
13817
+ # Describes the properties of specific major versions of DB engines.
13818
+ #
13819
+ # @option params [String] :engine
13820
+ # The database engine to return major version details for.
13821
+ #
13822
+ # Valid Values:
13823
+ #
13824
+ # * `aurora-mysql`
13825
+ #
13826
+ # * `aurora-postgresql`
13827
+ #
13828
+ # * `custom-sqlserver-ee`
13829
+ #
13830
+ # * `custom-sqlserver-se`
13831
+ #
13832
+ # * `custom-sqlserver-web`
13833
+ #
13834
+ # * `db2-ae`
13835
+ #
13836
+ # * `db2-se`
13837
+ #
13838
+ # * `mariadb`
13839
+ #
13840
+ # * `mysql`
13841
+ #
13842
+ # * `oracle-ee`
13843
+ #
13844
+ # * `oracle-ee-cdb`
13845
+ #
13846
+ # * `oracle-se2`
13847
+ #
13848
+ # * `oracle-se2-cdb`
13849
+ #
13850
+ # * `postgres`
13851
+ #
13852
+ # * `sqlserver-ee`
13853
+ #
13854
+ # * `sqlserver-se`
13855
+ #
13856
+ # * `sqlserver-ex`
13857
+ #
13858
+ # * `sqlserver-web`
13859
+ #
13860
+ # @option params [String] :major_engine_version
13861
+ # A specific database major engine version to return details for.
13862
+ #
13863
+ # Example: `8.4`
13864
+ #
13865
+ # @option params [String] :marker
13866
+ # An optional pagination token provided by a previous request. If this
13867
+ # parameter is specified, the response includes only records beyond the
13868
+ # marker, up to the value specified by `MaxRecords`.
13869
+ #
13870
+ # @option params [Integer] :max_records
13871
+ # The maximum number of records to include in the response. If more than
13872
+ # the `MaxRecords` value is available, a pagination token called a
13873
+ # marker is included in the response so you can retrieve the remaining
13874
+ # results.
13875
+ #
13876
+ # Default: 100
13877
+ #
13878
+ # @return [Types::DescribeDBMajorEngineVersionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
13879
+ #
13880
+ # * {Types::DescribeDBMajorEngineVersionsResponse#db_major_engine_versions #db_major_engine_versions} => Array&lt;Types::DBMajorEngineVersion&gt;
13881
+ # * {Types::DescribeDBMajorEngineVersionsResponse#marker #marker} => String
13882
+ #
13883
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
13884
+ #
13885
+ # @example Request syntax with placeholder values
13886
+ #
13887
+ # resp = client.describe_db_major_engine_versions({
13888
+ # engine: "Engine",
13889
+ # major_engine_version: "MajorEngineVersion",
13890
+ # marker: "Marker",
13891
+ # max_records: 1,
13892
+ # })
13893
+ #
13894
+ # @example Response structure
13895
+ #
13896
+ # resp.db_major_engine_versions #=> Array
13897
+ # resp.db_major_engine_versions[0].engine #=> String
13898
+ # resp.db_major_engine_versions[0].major_engine_version #=> String
13899
+ # resp.db_major_engine_versions[0].supported_engine_lifecycles #=> Array
13900
+ # resp.db_major_engine_versions[0].supported_engine_lifecycles[0].lifecycle_support_name #=> String, one of "open-source-rds-standard-support", "open-source-rds-extended-support"
13901
+ # resp.db_major_engine_versions[0].supported_engine_lifecycles[0].lifecycle_support_start_date #=> Time
13902
+ # resp.db_major_engine_versions[0].supported_engine_lifecycles[0].lifecycle_support_end_date #=> Time
13903
+ # resp.marker #=> String
13904
+ #
13905
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBMajorEngineVersions AWS API Documentation
13906
+ #
13907
+ # @overload describe_db_major_engine_versions(params = {})
13908
+ # @param [Hash] params ({})
13909
+ def describe_db_major_engine_versions(params = {}, options = {})
13910
+ req = build_request(:describe_db_major_engine_versions, params)
13911
+ req.send_request(options)
13912
+ end
13913
+
13740
13914
  # Returns a list of `DBParameterGroup` descriptions. If a
13741
13915
  # `DBParameterGroupName` is specified, the list will contain only the
13742
13916
  # description of the specified DB parameter group.
@@ -15114,6 +15288,7 @@ module Aws::RDS
15114
15288
  # resp.db_snapshots[0].db_system_id #=> String
15115
15289
  # resp.db_snapshots[0].dedicated_log_volume #=> Boolean
15116
15290
  # resp.db_snapshots[0].multi_tenant #=> Boolean
15291
+ # resp.db_snapshots[0].snapshot_availability_zone #=> String
15117
15292
  #
15118
15293
  #
15119
15294
  # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -17815,6 +17990,17 @@ module Aws::RDS
17815
17990
  #
17816
17991
  # This command doesn't apply to RDS Custom.
17817
17992
  #
17993
+ # <note markdown="1"> This operation uses resources on database instances. Because of this,
17994
+ # we recommend publishing database logs to CloudWatch and then using the
17995
+ # GetLogEvents operation. For more information, see [GetLogEvents][1] in
17996
+ # the *Amazon CloudWatch Logs API Reference*.
17997
+ #
17998
+ # </note>
17999
+ #
18000
+ #
18001
+ #
18002
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogEvents.html
18003
+ #
17818
18004
  # @option params [required, String] :db_instance_identifier
17819
18005
  # The customer-assigned name of the DB instance that contains the log
17820
18006
  # files you want to list.
@@ -18129,6 +18315,7 @@ module Aws::RDS
18129
18315
  # resp.db_cluster.tag_list #=> Array
18130
18316
  # resp.db_cluster.tag_list[0].key #=> String
18131
18317
  # resp.db_cluster.tag_list[0].value #=> String
18318
+ # resp.db_cluster.global_cluster_identifier #=> String
18132
18319
  # resp.db_cluster.global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
18133
18320
  # resp.db_cluster.global_write_forwarding_requested #=> Boolean
18134
18321
  # resp.db_cluster.pending_modified_values.pending_cloudwatch_logs_exports.log_types_to_enable #=> Array
@@ -19855,6 +20042,7 @@ module Aws::RDS
19855
20042
  # resp.db_cluster.tag_list #=> Array
19856
20043
  # resp.db_cluster.tag_list[0].key #=> String
19857
20044
  # resp.db_cluster.tag_list[0].value #=> String
20045
+ # resp.db_cluster.global_cluster_identifier #=> String
19858
20046
  # resp.db_cluster.global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
19859
20047
  # resp.db_cluster.global_write_forwarding_requested #=> Boolean
19860
20048
  # resp.db_cluster.pending_modified_values.pending_cloudwatch_logs_exports.log_types_to_enable #=> Array
@@ -21170,26 +21358,50 @@ module Aws::RDS
21170
21358
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL-certificate-rotation.html
21171
21359
  #
21172
21360
  # @option params [String] :replica_mode
21173
- # A value that sets the open mode of a replica database to either
21174
- # mounted or read-only.
21361
+ # The open mode of a replica database.
21175
21362
  #
21176
- # <note markdown="1"> Currently, this parameter is only supported for Oracle DB instances.
21363
+ # <note markdown="1"> This parameter is only supported for Db2 DB instances and Oracle DB
21364
+ # instances.
21177
21365
  #
21178
21366
  # </note>
21179
21367
  #
21180
- # Mounted DB replicas are included in Oracle Enterprise Edition. The
21181
- # main use case for mounted replicas is cross-Region disaster recovery.
21182
- # The primary database doesn't use Active Data Guard to transmit
21183
- # information to the mounted replica. Because it doesn't accept user
21184
- # connections, a mounted replica can't serve a read-only workload. For
21185
- # more information, see [Working with Oracle Read Replicas for Amazon
21186
- # RDS][1] in the *Amazon RDS User Guide*.
21368
+ # Db2
21187
21369
  #
21188
- # This setting doesn't apply to RDS Custom DB instances.
21370
+ # : Standby DB replicas are included in Db2 Advanced Edition (AE) and
21371
+ # Db2 Standard Edition (SE). The main use case for standby replicas is
21372
+ # cross-Region disaster recovery. Because it doesn't accept user
21373
+ # connections, a standby replica can't serve a read-only workload.
21374
+ #
21375
+ # You can create a combination of standby and read-only DB replicas
21376
+ # for the same primary DB instance. For more information, see [Working
21377
+ # with read replicas for Amazon RDS for Db2][1] in the *Amazon RDS
21378
+ # User Guide*.
21379
+ #
21380
+ # To create standby DB replicas for RDS for Db2, set this parameter to
21381
+ # `mounted`.
21382
+ #
21383
+ # Oracle
21384
+ #
21385
+ # : Mounted DB replicas are included in Oracle Database Enterprise
21386
+ # Edition. The main use case for mounted replicas is cross-Region
21387
+ # disaster recovery. The primary database doesn't use Active Data
21388
+ # Guard to transmit information to the mounted replica. Because it
21389
+ # doesn't accept user connections, a mounted replica can't serve a
21390
+ # read-only workload.
21391
+ #
21392
+ # You can create a combination of mounted and read-only DB replicas
21393
+ # for the same primary DB instance. For more information, see [Working
21394
+ # with read replicas for Amazon RDS for Oracle][2] in the *Amazon RDS
21395
+ # User Guide*.
21396
+ #
21397
+ # For RDS Custom, you must specify this parameter and set it to
21398
+ # `mounted`. The value won't be set by default. After replica
21399
+ # creation, you can manage the open mode manually.
21189
21400
  #
21190
21401
  #
21191
21402
  #
21192
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
21403
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/db2-replication.html
21404
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
21193
21405
  #
21194
21406
  # @option params [Boolean] :enable_customer_owned_ip
21195
21407
  # Specifies whether to enable a customer-owned IP address (CoIP) for an
@@ -22387,6 +22599,7 @@ module Aws::RDS
22387
22599
  # resp.db_snapshot.db_system_id #=> String
22388
22600
  # resp.db_snapshot.dedicated_log_volume #=> Boolean
22389
22601
  # resp.db_snapshot.multi_tenant #=> Boolean
22602
+ # resp.db_snapshot.snapshot_availability_zone #=> String
22390
22603
  #
22391
22604
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBSnapshot AWS API Documentation
22392
22605
  #
@@ -23735,6 +23948,7 @@ module Aws::RDS
23735
23948
  # resp.db_cluster.tag_list #=> Array
23736
23949
  # resp.db_cluster.tag_list[0].key #=> String
23737
23950
  # resp.db_cluster.tag_list[0].value #=> String
23951
+ # resp.db_cluster.global_cluster_identifier #=> String
23738
23952
  # resp.db_cluster.global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
23739
23953
  # resp.db_cluster.global_write_forwarding_requested #=> Boolean
23740
23954
  # resp.db_cluster.pending_modified_values.pending_cloudwatch_logs_exports.log_types_to_enable #=> Array
@@ -24038,6 +24252,7 @@ module Aws::RDS
24038
24252
  # resp.db_cluster.tag_list #=> Array
24039
24253
  # resp.db_cluster.tag_list[0].key #=> String
24040
24254
  # resp.db_cluster.tag_list[0].value #=> String
24255
+ # resp.db_cluster.global_cluster_identifier #=> String
24041
24256
  # resp.db_cluster.global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
24042
24257
  # resp.db_cluster.global_write_forwarding_requested #=> Boolean
24043
24258
  # resp.db_cluster.pending_modified_values.pending_cloudwatch_logs_exports.log_types_to_enable #=> Array
@@ -25404,11 +25619,11 @@ module Aws::RDS
25404
25619
  # support for that engine version. For more information, see the
25405
25620
  # following sections:
25406
25621
  #
25407
- # * Amazon Aurora - [Using Amazon RDS Extended Support][1] in the
25408
- # *Amazon Aurora User Guide*
25622
+ # * Amazon Aurora - [Amazon RDS Extended Support with Amazon Aurora][1]
25623
+ # in the *Amazon Aurora User Guide*
25409
25624
  #
25410
- # * Amazon RDS - [Using Amazon RDS Extended Support][2] in the *Amazon
25411
- # RDS User Guide*
25625
+ # * Amazon RDS - [Amazon RDS Extended Support with Amazon RDS][2] in the
25626
+ # *Amazon RDS User Guide*
25412
25627
  #
25413
25628
  # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
25414
25629
  #
@@ -25640,6 +25855,7 @@ module Aws::RDS
25640
25855
  # resp.db_cluster.tag_list #=> Array
25641
25856
  # resp.db_cluster.tag_list[0].key #=> String
25642
25857
  # resp.db_cluster.tag_list[0].value #=> String
25858
+ # resp.db_cluster.global_cluster_identifier #=> String
25643
25859
  # resp.db_cluster.global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
25644
25860
  # resp.db_cluster.global_write_forwarding_requested #=> Boolean
25645
25861
  # resp.db_cluster.pending_modified_values.pending_cloudwatch_logs_exports.log_types_to_enable #=> Array
@@ -26222,11 +26438,11 @@ module Aws::RDS
26222
26438
  # support for that engine version. For more information, see the
26223
26439
  # following sections:
26224
26440
  #
26225
- # * Amazon Aurora - [Using Amazon RDS Extended Support][1] in the
26226
- # *Amazon Aurora User Guide*
26441
+ # * Amazon Aurora - [Amazon RDS Extended Support with Amazon Aurora][1]
26442
+ # in the *Amazon Aurora User Guide*
26227
26443
  #
26228
- # * Amazon RDS - [Using Amazon RDS Extended Support][2] in the *Amazon
26229
- # RDS User Guide*
26444
+ # * Amazon RDS - [Amazon RDS Extended Support with Amazon RDS][2] in the
26445
+ # *Amazon RDS User Guide*
26230
26446
  #
26231
26447
  # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
26232
26448
  #
@@ -26464,6 +26680,7 @@ module Aws::RDS
26464
26680
  # resp.db_cluster.tag_list #=> Array
26465
26681
  # resp.db_cluster.tag_list[0].key #=> String
26466
26682
  # resp.db_cluster.tag_list[0].value #=> String
26683
+ # resp.db_cluster.global_cluster_identifier #=> String
26467
26684
  # resp.db_cluster.global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
26468
26685
  # resp.db_cluster.global_write_forwarding_requested #=> Boolean
26469
26686
  # resp.db_cluster.pending_modified_values.pending_cloudwatch_logs_exports.log_types_to_enable #=> Array
@@ -27030,11 +27247,11 @@ module Aws::RDS
27030
27247
  # support for that engine version. For more information, see the
27031
27248
  # following sections:
27032
27249
  #
27033
- # * Amazon Aurora - [Using Amazon RDS Extended Support][1] in the
27034
- # *Amazon Aurora User Guide*
27250
+ # * Amazon Aurora - [Amazon RDS Extended Support with Amazon Aurora][1]
27251
+ # in the *Amazon Aurora User Guide*
27035
27252
  #
27036
- # * Amazon RDS - [Using Amazon RDS Extended Support][2] in the *Amazon
27037
- # RDS User Guide*
27253
+ # * Amazon RDS - [Amazon RDS Extended Support with Amazon RDS][2] in the
27254
+ # *Amazon RDS User Guide*
27038
27255
  #
27039
27256
  # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
27040
27257
  #
@@ -27271,6 +27488,7 @@ module Aws::RDS
27271
27488
  # resp.db_cluster.tag_list #=> Array
27272
27489
  # resp.db_cluster.tag_list[0].key #=> String
27273
27490
  # resp.db_cluster.tag_list[0].value #=> String
27491
+ # resp.db_cluster.global_cluster_identifier #=> String
27274
27492
  # resp.db_cluster.global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
27275
27493
  # resp.db_cluster.global_write_forwarding_requested #=> Boolean
27276
27494
  # resp.db_cluster.pending_modified_values.pending_cloudwatch_logs_exports.log_types_to_enable #=> Array
@@ -27832,8 +28050,9 @@ module Aws::RDS
27832
28050
  # Specifies where automated backups and manual snapshots are stored for
27833
28051
  # the restored DB instance.
27834
28052
  #
27835
- # Possible values are `outposts` (Amazon Web Services Outposts) and
27836
- # `region` (Amazon Web Services Region). The default is `region`.
28053
+ # Possible values are `local` (Dedicated Local Zone), `outposts` (Amazon
28054
+ # Web Services Outposts), and `region` (Amazon Web Services Region). The
28055
+ # default is `region`.
27837
28056
  #
27838
28057
  # For more information, see [Working with Amazon RDS on Amazon Web
27839
28058
  # Services Outposts][1] in the *Amazon RDS User Guide*.
@@ -27941,8 +28160,8 @@ module Aws::RDS
27941
28160
  # You can use this setting to enroll your DB instance into Amazon RDS
27942
28161
  # Extended Support. With RDS Extended Support, you can run the selected
27943
28162
  # major engine version on your DB instance past the end of standard
27944
- # support for that engine version. For more information, see [Using
27945
- # Amazon RDS Extended Support][1] in the *Amazon RDS User Guide*.
28163
+ # support for that engine version. For more information, see [Amazon RDS
28164
+ # Extended Support with Amazon RDS][1] in the *Amazon RDS User Guide*.
27946
28165
  #
27947
28166
  # This setting applies only to RDS for MySQL and RDS for PostgreSQL. For
27948
28167
  # Amazon Aurora DB instances, the life cycle type is managed by the DB
@@ -28828,8 +29047,8 @@ module Aws::RDS
28828
29047
  # You can use this setting to enroll your DB instance into Amazon RDS
28829
29048
  # Extended Support. With RDS Extended Support, you can run the selected
28830
29049
  # major engine version on your DB instance past the end of standard
28831
- # support for that engine version. For more information, see [Using
28832
- # Amazon RDS Extended Support][1] in the *Amazon RDS User Guide*.
29050
+ # support for that engine version. For more information, see [Amazon RDS
29051
+ # Extended Support Amazon RDS][1] in the *Amazon RDS User Guide*.
28833
29052
  #
28834
29053
  # This setting applies only to RDS for MySQL and RDS for PostgreSQL. For
28835
29054
  # Amazon Aurora DB instances, the life cycle type is managed by the DB
@@ -29617,6 +29836,8 @@ module Aws::RDS
29617
29836
  #
29618
29837
  # Valid Values:
29619
29838
  #
29839
+ # * `local` (Dedicated Local Zone)
29840
+ #
29620
29841
  # * `outposts` (Amazon Web Services Outposts)
29621
29842
  #
29622
29843
  # * `region` (Amazon Web Services Region)
@@ -29704,8 +29925,8 @@ module Aws::RDS
29704
29925
  # You can use this setting to enroll your DB instance into Amazon RDS
29705
29926
  # Extended Support. With RDS Extended Support, you can run the selected
29706
29927
  # major engine version on your DB instance past the end of standard
29707
- # support for that engine version. For more information, see [Using
29708
- # Amazon RDS Extended Support][1] in the *Amazon RDS User Guide*.
29928
+ # support for that engine version. For more information, see [Amazon RDS
29929
+ # Extended Support with Amazon RDS][1] in the *Amazon RDS User Guide*.
29709
29930
  #
29710
29931
  # This setting applies only to RDS for MySQL and RDS for PostgreSQL. For
29711
29932
  # Amazon Aurora DB instances, the life cycle type is managed by the DB
@@ -30444,6 +30665,7 @@ module Aws::RDS
30444
30665
  # resp.db_cluster.tag_list #=> Array
30445
30666
  # resp.db_cluster.tag_list[0].key #=> String
30446
30667
  # resp.db_cluster.tag_list[0].value #=> String
30668
+ # resp.db_cluster.global_cluster_identifier #=> String
30447
30669
  # resp.db_cluster.global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
30448
30670
  # resp.db_cluster.global_write_forwarding_requested #=> Boolean
30449
30671
  # resp.db_cluster.pending_modified_values.pending_cloudwatch_logs_exports.log_types_to_enable #=> Array
@@ -30947,24 +31169,10 @@ module Aws::RDS
30947
31169
  # operations. These can be set in the Amazon Web Services KMS key
30948
31170
  # policy:
30949
31171
  #
30950
- # * kms:Encrypt
30951
- #
30952
- # * kms:Decrypt
30953
- #
30954
- # * kms:GenerateDataKey
30955
- #
30956
- # * kms:GenerateDataKeyWithoutPlaintext
30957
- #
30958
- # * kms:ReEncryptFrom
30959
- #
30960
- # * kms:ReEncryptTo
30961
- #
30962
31172
  # * kms:CreateGrant
30963
31173
  #
30964
31174
  # * kms:DescribeKey
30965
31175
  #
30966
- # * kms:RetireGrant
30967
- #
30968
31176
  # @option params [String] :s3_prefix
30969
31177
  # The Amazon S3 bucket prefix to use as the file name and path of the
30970
31178
  # exported data.
@@ -31292,6 +31500,7 @@ module Aws::RDS
31292
31500
  # resp.db_cluster.tag_list #=> Array
31293
31501
  # resp.db_cluster.tag_list[0].key #=> String
31294
31502
  # resp.db_cluster.tag_list[0].value #=> String
31503
+ # resp.db_cluster.global_cluster_identifier #=> String
31295
31504
  # resp.db_cluster.global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
31296
31505
  # resp.db_cluster.global_write_forwarding_requested #=> Boolean
31297
31506
  # resp.db_cluster.pending_modified_values.pending_cloudwatch_logs_exports.log_types_to_enable #=> Array
@@ -32202,7 +32411,7 @@ module Aws::RDS
32202
32411
  tracer: tracer
32203
32412
  )
32204
32413
  context[:gem_name] = 'aws-sdk-rds'
32205
- context[:gem_version] = '1.274.0'
32414
+ context[:gem_version] = '1.282.0'
32206
32415
  Seahorse::Client::Request.new(handlers, context)
32207
32416
  end
32208
32417