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.
@@ -1070,7 +1070,7 @@ module Aws::RDS
1070
1070
  #
1071
1071
  # Constraints:
1072
1072
  #
1073
- # * Must be between 0 and 3600.
1073
+ # * Must be between 0 and 300.
1074
1074
  #
1075
1075
  # ^
1076
1076
  # @return [Integer]
@@ -1090,15 +1090,20 @@ module Aws::RDS
1090
1090
  # specify one or more SQL statements for the proxy to run when opening
1091
1091
  # each new database connection. The setting is typically used with
1092
1092
  # `SET` statements to make sure that each connection has identical
1093
- # settings. Make sure that the query you add is valid. To include
1094
- # multiple variables in a single `SET` statement, use comma
1095
- # separators.
1093
+ # settings. Make sure the query added here is valid. This is an
1094
+ # optional field, so you can choose to leave it empty. For including
1095
+ # multiple variables in a single SET statement, use a comma separator.
1096
1096
  #
1097
1097
  # For example: `SET variable1=value1, variable2=value2`
1098
1098
  #
1099
- # For multiple statements, use semicolons as the separator.
1100
- #
1101
1099
  # Default: no initialization query
1100
+ #
1101
+ # Since you can access initialization query as part of target group
1102
+ # configuration, it is not protected by authentication or
1103
+ # cryptographic methods. Anyone with access to view or manage your
1104
+ # proxy target group configuration can view the initialization query.
1105
+ # You should not add sensitive data, such as passwords or long-lived
1106
+ # encryption keys, to this option.
1102
1107
  # @return [String]
1103
1108
  #
1104
1109
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ConnectionPoolConfiguration AWS API Documentation
@@ -1152,12 +1157,20 @@ module Aws::RDS
1152
1157
  #
1153
1158
  # @!attribute [rw] init_query
1154
1159
  # One or more SQL statements for the proxy to run when opening each
1155
- # new database connection. Typically used with `SET` statements to
1156
- # make sure that each connection has identical settings such as time
1157
- # zone and character set. This setting is empty by default. For
1158
- # multiple statements, use semicolons as the separator. You can also
1159
- # include multiple variables in a single `SET` statement, such as `SET
1160
- # x=1, y=2`.
1160
+ # new database connection. The setting is typically used with `SET`
1161
+ # statements to make sure that each connection has identical settings.
1162
+ # The query added here must be valid. For including multiple variables
1163
+ # in a single SET statement, use a comma separator. This is an
1164
+ # optional field.
1165
+ #
1166
+ # For example: `SET variable1=value1, variable2=value2`
1167
+ #
1168
+ # Since you can access initialization query as part of target group
1169
+ # configuration, it is not protected by authentication or
1170
+ # cryptographic methods. Anyone with access to view or manage your
1171
+ # proxy target group configuration can view the initialization query.
1172
+ # You should not add sensitive data, such as passwords or long-lived
1173
+ # encryption keys, to this option.
1161
1174
  # @return [String]
1162
1175
  #
1163
1176
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ConnectionPoolConfigurationInfo AWS API Documentation
@@ -1712,6 +1725,24 @@ module Aws::RDS
1712
1725
  # can be copied only with cross-account snapshot copy calls.
1713
1726
  # @return [Boolean]
1714
1727
  #
1728
+ # @!attribute [rw] snapshot_availability_zone
1729
+ # Specifies the name of the Availability Zone where RDS stores the DB
1730
+ # snapshot. This value is valid only for snapshots that RDS stores on
1731
+ # a Dedicated Local Zone.
1732
+ # @return [String]
1733
+ #
1734
+ # @!attribute [rw] snapshot_target
1735
+ # Configures the location where RDS will store copied snapshots.
1736
+ #
1737
+ # Valid Values:
1738
+ #
1739
+ # * `local` (Dedicated Local Zone)
1740
+ #
1741
+ # * `outposts` (Amazon Web Services Outposts)
1742
+ #
1743
+ # * `region` (Amazon Web Services Region)
1744
+ # @return [String]
1745
+ #
1715
1746
  # @!attribute [rw] source_region
1716
1747
  # The source region of the snapshot. This is only needed when the
1717
1748
  # shapshot is encrypted and in a different region.
@@ -1729,6 +1760,8 @@ module Aws::RDS
1729
1760
  :option_group_name,
1730
1761
  :target_custom_availability_zone,
1731
1762
  :copy_option_group,
1763
+ :snapshot_availability_zone,
1764
+ :snapshot_target,
1732
1765
  :source_region)
1733
1766
  SENSITIVE = []
1734
1767
  include Aws::Structure
@@ -3125,11 +3158,11 @@ module Aws::RDS
3125
3158
  # standard support for that engine version. For more information, see
3126
3159
  # the following sections:
3127
3160
  #
3128
- # * Amazon Aurora - [Using Amazon RDS Extended Support][1] in the
3129
- # *Amazon Aurora User Guide*
3161
+ # * Amazon Aurora - [Amazon RDS Extended Support with Amazon
3162
+ # Aurora][1] in the *Amazon Aurora User Guide*
3130
3163
  #
3131
- # * Amazon RDS - [Using Amazon RDS Extended Support][2] in the *Amazon
3132
- # RDS User Guide*
3164
+ # * Amazon RDS - [Amazon RDS Extended Support with Amazon RDS][2] in
3165
+ # the *Amazon RDS User Guide*
3133
3166
  #
3134
3167
  # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
3135
3168
  #
@@ -4635,6 +4668,8 @@ module Aws::RDS
4635
4668
  #
4636
4669
  # Valid Values:
4637
4670
  #
4671
+ # * `local` (Dedicated Local Zone)
4672
+ #
4638
4673
  # * `outposts` (Amazon Web Services Outposts)
4639
4674
  #
4640
4675
  # * `region` (Amazon Web Services Region)
@@ -4788,8 +4823,8 @@ module Aws::RDS
4788
4823
  # Extended Support. With RDS Extended Support, you can run the
4789
4824
  # selected major engine version on your DB instance past the end of
4790
4825
  # standard support for that engine version. For more information, see
4791
- # [Using Amazon RDS Extended Support][1] in the *Amazon RDS User
4792
- # Guide*.
4826
+ # [Amazon RDS Extended Support with Amazon RDS][1] in the *Amazon RDS
4827
+ # User Guide*.
4793
4828
  #
4794
4829
  # Valid Values: `open-source-rds-extended-support |
4795
4830
  # open-source-rds-extended-support-disabled`
@@ -4881,8 +4916,13 @@ module Aws::RDS
4881
4916
  # @!attribute [rw] source_db_instance_identifier
4882
4917
  # The identifier of the DB instance that will act as the source for
4883
4918
  # the read replica. Each DB instance can have up to 15 read replicas,
4884
- # with the exception of Oracle and SQL Server, which can have up to
4885
- # five.
4919
+ # except for the following engines:
4920
+ #
4921
+ # * Db2 - Can have up to three replicas.
4922
+ #
4923
+ # * Oracle - Can have up to five read replicas.
4924
+ #
4925
+ # * SQL Server - Can have up to five read replicas.
4886
4926
  #
4887
4927
  # Constraints:
4888
4928
  #
@@ -5000,6 +5040,16 @@ module Aws::RDS
5000
5040
  # The name of the DB parameter group to associate with this read
5001
5041
  # replica DB instance.
5002
5042
  #
5043
+ # For the Db2 DB engine, if your source DB instance uses the Bring
5044
+ # Your Own License model, then a custom parameter group must be
5045
+ # associated with the replica. For a same Amazon Web Services Region
5046
+ # replica, if you don't specify a custom parameter group, Amazon RDS
5047
+ # associates the custom parameter group associated with the source DB
5048
+ # instance. For a cross-Region replica, you must specify a custom
5049
+ # parameter group. This custom parameter group must include your IBM
5050
+ # Site ID and IBM Customer ID. For more information, see [ IBM IDs for
5051
+ # Bring Your Own License for Db2][1].
5052
+ #
5003
5053
  # For Single-AZ or Multi-AZ DB instance read replica instances, if you
5004
5054
  # don't specify a value for `DBParameterGroupName`, then Amazon RDS
5005
5055
  # uses the `DBParameterGroup` of the source DB instance for a same
@@ -5012,9 +5062,9 @@ module Aws::RDS
5012
5062
  #
5013
5063
  # Specifying a parameter group for this operation is only supported
5014
5064
  # for MySQL DB instances for cross-Region read replicas, for Multi-AZ
5015
- # DB cluster read replica instances, and for Oracle DB instances. It
5016
- # isn't supported for MySQL DB instances for same Region read
5017
- # replicas or for RDS Custom.
5065
+ # DB cluster read replica instances, for Db2 DB instances, and for
5066
+ # Oracle DB instances. It isn't supported for MySQL DB instances for
5067
+ # same Region read replicas or for RDS Custom.
5018
5068
  #
5019
5069
  # Constraints:
5020
5070
  #
@@ -5023,6 +5073,10 @@ module Aws::RDS
5023
5073
  # * First character must be a letter.
5024
5074
  #
5025
5075
  # * Can't end with a hyphen or contain two consecutive hyphens.
5076
+ #
5077
+ #
5078
+ #
5079
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/db2-licensing.html#db2-prereqs-ibm-info
5026
5080
  # @return [String]
5027
5081
  #
5028
5082
  # @!attribute [rw] publicly_accessible
@@ -5432,31 +5486,50 @@ module Aws::RDS
5432
5486
  # @return [Array<String>]
5433
5487
  #
5434
5488
  # @!attribute [rw] replica_mode
5435
- # The open mode of the replica database: mounted or read-only.
5489
+ # The open mode of the replica database.
5436
5490
  #
5437
- # <note markdown="1"> This parameter is only supported for Oracle DB instances.
5491
+ # <note markdown="1"> This parameter is only supported for Db2 DB instances and Oracle DB
5492
+ # instances.
5438
5493
  #
5439
5494
  # </note>
5440
5495
  #
5441
- # Mounted DB replicas are included in Oracle Database Enterprise
5442
- # Edition. The main use case for mounted replicas is cross-Region
5443
- # disaster recovery. The primary database doesn't use Active Data
5444
- # Guard to transmit information to the mounted replica. Because it
5445
- # doesn't accept user connections, a mounted replica can't serve a
5446
- # read-only workload.
5496
+ # Db2
5447
5497
  #
5448
- # You can create a combination of mounted and read-only DB replicas
5449
- # for the same primary DB instance. For more information, see [Working
5450
- # with Oracle Read Replicas for Amazon RDS][1] in the *Amazon RDS User
5451
- # Guide*.
5498
+ # : Standby DB replicas are included in Db2 Advanced Edition (AE) and
5499
+ # Db2 Standard Edition (SE). The main use case for standby replicas
5500
+ # is cross-Region disaster recovery. Because it doesn't accept user
5501
+ # connections, a standby replica can't serve a read-only workload.
5452
5502
  #
5453
- # For RDS Custom, you must specify this parameter and set it to
5454
- # `mounted`. The value won't be set by default. After replica
5455
- # creation, you can manage the open mode manually.
5503
+ # You can create a combination of standby and read-only DB replicas
5504
+ # for the same primary DB instance. For more information, see
5505
+ # [Working with read replicas for Amazon RDS for Db2][1] in the
5506
+ # *Amazon RDS User Guide*.
5456
5507
  #
5508
+ # To create standby DB replicas for RDS for Db2, set this parameter
5509
+ # to `mounted`.
5457
5510
  #
5511
+ # Oracle
5512
+ #
5513
+ # : Mounted DB replicas are included in Oracle Database Enterprise
5514
+ # Edition. The main use case for mounted replicas is cross-Region
5515
+ # disaster recovery. The primary database doesn't use Active Data
5516
+ # Guard to transmit information to the mounted replica. Because it
5517
+ # doesn't accept user connections, a mounted replica can't serve a
5518
+ # read-only workload.
5519
+ #
5520
+ # You can create a combination of mounted and read-only DB replicas
5521
+ # for the same primary DB instance. For more information, see
5522
+ # [Working with read replicas for Amazon RDS for Oracle][2] in the
5523
+ # *Amazon RDS User Guide*.
5458
5524
  #
5459
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
5525
+ # For RDS Custom, you must specify this parameter and set it to
5526
+ # `mounted`. The value won't be set by default. After replica
5527
+ # creation, you can manage the open mode manually.
5528
+ #
5529
+ #
5530
+ #
5531
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/db2-replication.html
5532
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
5460
5533
  # @return [String]
5461
5534
  #
5462
5535
  # @!attribute [rw] max_allocated_storage
@@ -5546,6 +5619,17 @@ module Aws::RDS
5546
5619
  # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/routing.html#ip-addressing
5547
5620
  # @return [Boolean]
5548
5621
  #
5622
+ # @!attribute [rw] backup_target
5623
+ # The location where RDS stores automated backups and manual
5624
+ # snapshots.
5625
+ #
5626
+ # Valid Values:
5627
+ #
5628
+ # * `local` for Dedicated Local Zones
5629
+ #
5630
+ # * `region` for Amazon Web Services Region
5631
+ # @return [String]
5632
+ #
5549
5633
  # @!attribute [rw] allocated_storage
5550
5634
  # The amount of storage (in gibibytes) to allocate initially for the
5551
5635
  # read replica. Follow the allocation rules specified in
@@ -5657,6 +5741,7 @@ module Aws::RDS
5657
5741
  :network_type,
5658
5742
  :storage_throughput,
5659
5743
  :enable_customer_owned_ip,
5744
+ :backup_target,
5660
5745
  :allocated_storage,
5661
5746
  :source_db_cluster_identifier,
5662
5747
  :dedicated_log_volume,
@@ -6031,17 +6116,17 @@ module Aws::RDS
6031
6116
  # @return [String]
6032
6117
  #
6033
6118
  # @!attribute [rw] compute_redundancy
6034
- # Specifies whether to create standby DB shard groups for the DB shard
6035
- # group. Valid values are the following:
6119
+ # Specifies whether to create standby standby DB data access shard for
6120
+ # the DB shard group. Valid values are the following:
6036
6121
  #
6037
- # * 0 - Creates a DB shard group without a standby DB shard group.
6038
- # This is the default value.
6122
+ # * 0 - Creates a DB shard group without a standby DB data access
6123
+ # shard. This is the default value.
6039
6124
  #
6040
- # * 1 - Creates a DB shard group with a standby DB shard group in a
6041
- # different Availability Zone (AZ).
6125
+ # * 1 - Creates a DB shard group with a standby DB data access shard
6126
+ # in a different Availability Zone (AZ).
6042
6127
  #
6043
- # * 2 - Creates a DB shard group with two standby DB shard groups in
6044
- # two different AZs.
6128
+ # * 2 - Creates a DB shard group with two standby DB data access shard
6129
+ # in two different AZs.
6045
6130
  # @return [Integer]
6046
6131
  #
6047
6132
  # @!attribute [rw] max_acu
@@ -6432,8 +6517,8 @@ module Aws::RDS
6432
6517
  # RDS Extended Support. With RDS Extended Support, you can run the
6433
6518
  # selected major engine version on your global cluster past the end of
6434
6519
  # standard support for that engine version. For more information, see
6435
- # [Using Amazon RDS Extended Support][1] in the *Amazon Aurora User
6436
- # Guide*.
6520
+ # [Amazon RDS Extended Support with Amazon Aurora][1] in the *Amazon
6521
+ # Aurora User Guide*.
6437
6522
  #
6438
6523
  # Valid Values: `open-source-rds-extended-support |
6439
6524
  # open-source-rds-extended-support-disabled`
@@ -7220,6 +7305,12 @@ module Aws::RDS
7220
7305
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html
7221
7306
  # @return [Array<Types::Tag>]
7222
7307
  #
7308
+ # @!attribute [rw] global_cluster_identifier
7309
+ # Contains a user-supplied global database cluster identifier. This
7310
+ # identifier is the unique key that identifies a global database
7311
+ # cluster.
7312
+ # @return [String]
7313
+ #
7223
7314
  # @!attribute [rw] global_write_forwarding_status
7224
7315
  # The status of write forwarding for a secondary cluster in an Aurora
7225
7316
  # global database.
@@ -7448,7 +7539,7 @@ module Aws::RDS
7448
7539
  # @return [Types::CertificateDetails]
7449
7540
  #
7450
7541
  # @!attribute [rw] engine_lifecycle_support
7451
- # The life cycle type for the DB cluster.
7542
+ # The lifecycle type for the DB cluster.
7452
7543
  #
7453
7544
  # For more information, see CreateDBCluster.
7454
7545
  # @return [String]
@@ -7512,6 +7603,7 @@ module Aws::RDS
7512
7603
  :cross_account_clone,
7513
7604
  :domain_memberships,
7514
7605
  :tag_list,
7606
+ :global_cluster_identifier,
7515
7607
  :global_write_forwarding_status,
7516
7608
  :global_write_forwarding_requested,
7517
7609
  :pending_modified_values,
@@ -9005,17 +9097,20 @@ module Aws::RDS
9005
9097
  # @return [Array<String>]
9006
9098
  #
9007
9099
  # @!attribute [rw] replica_mode
9008
- # The open mode of an Oracle read replica. The default is
9009
- # `open-read-only`. For more information, see [Working with Oracle
9010
- # Read Replicas for Amazon RDS][1] in the *Amazon RDS User Guide*.
9100
+ # The open mode of a Db2 or an Oracle read replica. The default is
9101
+ # `open-read-only`. For more information, see [Working with read
9102
+ # replicas for Amazon RDS for Db2][1] and [Working with read replicas
9103
+ # for Amazon RDS for Oracle][2] in the *Amazon RDS User Guide*.
9011
9104
  #
9012
- # <note markdown="1"> This attribute is only supported in RDS for Oracle.
9105
+ # <note markdown="1"> This attribute is only supported in RDS for Db2, RDS for Oracle, and
9106
+ # RDS Custom for Oracle.
9013
9107
  #
9014
9108
  # </note>
9015
9109
  #
9016
9110
  #
9017
9111
  #
9018
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
9112
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/db2-replication.html
9113
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
9019
9114
  # @return [String]
9020
9115
  #
9021
9116
  # @!attribute [rw] license_model
@@ -9377,8 +9472,8 @@ module Aws::RDS
9377
9472
  #
9378
9473
  # @!attribute [rw] backup_target
9379
9474
  # The location where automated backups and manual snapshots are
9380
- # stored: Amazon Web Services Outposts or the Amazon Web Services
9381
- # Region.
9475
+ # stored: Dedicated Local Zones, Amazon Web Services Outposts or the
9476
+ # Amazon Web Services Region.
9382
9477
  # @return [String]
9383
9478
  #
9384
9479
  # @!attribute [rw] network_type
@@ -9464,7 +9559,7 @@ module Aws::RDS
9464
9559
  # @return [Boolean]
9465
9560
  #
9466
9561
  # @!attribute [rw] engine_lifecycle_support
9467
- # The life cycle type for the DB instance.
9562
+ # The lifecycle type for the DB instance.
9468
9563
  #
9469
9564
  # For more information, see CreateDBInstance.
9470
9565
  # @return [String]
@@ -9708,8 +9803,9 @@ module Aws::RDS
9708
9803
  # @return [Array<Types::DBInstanceAutomatedBackupsReplication>]
9709
9804
  #
9710
9805
  # @!attribute [rw] backup_target
9711
- # The location where automated backups are stored: Amazon Web Services
9712
- # Outposts or the Amazon Web Services Region.
9806
+ # The location where automated backups are stored: Dedicated Local
9807
+ # Zones, Amazon Web Services Outposts or the Amazon Web Services
9808
+ # Region.
9713
9809
  # @return [String]
9714
9810
  #
9715
9811
  # @!attribute [rw] storage_throughput
@@ -9959,6 +10055,32 @@ module Aws::RDS
9959
10055
  #
9960
10056
  class DBLogFileNotFoundFault < Aws::EmptyStructure; end
9961
10057
 
10058
+ # This data type is used as a response element in the operation
10059
+ # `DescribeDBMajorEngineVersions`.
10060
+ #
10061
+ # @!attribute [rw] engine
10062
+ # The name of the database engine.
10063
+ # @return [String]
10064
+ #
10065
+ # @!attribute [rw] major_engine_version
10066
+ # The major version number of the database engine.
10067
+ # @return [String]
10068
+ #
10069
+ # @!attribute [rw] supported_engine_lifecycles
10070
+ # A list of the lifecycles supported by this engine for the
10071
+ # `DescribeDBMajorEngineVersions` operation.
10072
+ # @return [Array<Types::SupportedEngineLifecycle>]
10073
+ #
10074
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBMajorEngineVersion AWS API Documentation
10075
+ #
10076
+ class DBMajorEngineVersion < Struct.new(
10077
+ :engine,
10078
+ :major_engine_version,
10079
+ :supported_engine_lifecycles)
10080
+ SENSITIVE = []
10081
+ include Aws::Structure
10082
+ end
10083
+
9962
10084
  # Contains the details of an Amazon RDS DB parameter group.
9963
10085
  #
9964
10086
  # This data type is used as a response element in the
@@ -11111,8 +11233,8 @@ module Aws::RDS
11111
11233
  # @return [Time]
11112
11234
  #
11113
11235
  # @!attribute [rw] snapshot_target
11114
- # Specifies where manual snapshots are stored: Amazon Web Services
11115
- # Outposts or the Amazon Web Services Region.
11236
+ # Specifies where manual snapshots are stored: Dedicated Local Zones,
11237
+ # Amazon Web Services Outposts or the Amazon Web Services Region.
11116
11238
  # @return [String]
11117
11239
  #
11118
11240
  # @!attribute [rw] storage_throughput
@@ -11136,6 +11258,12 @@ module Aws::RDS
11136
11258
  # (FALSE).
11137
11259
  # @return [Boolean]
11138
11260
  #
11261
+ # @!attribute [rw] snapshot_availability_zone
11262
+ # Specifies the name of the Availability Zone where RDS stores the DB
11263
+ # snapshot. This value is valid only for snapshots that RDS stores on
11264
+ # a Dedicated Local Zone.
11265
+ # @return [String]
11266
+ #
11139
11267
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBSnapshot AWS API Documentation
11140
11268
  #
11141
11269
  class DBSnapshot < Struct.new(
@@ -11174,7 +11302,8 @@ module Aws::RDS
11174
11302
  :storage_throughput,
11175
11303
  :db_system_id,
11176
11304
  :dedicated_log_volume,
11177
- :multi_tenant)
11305
+ :multi_tenant,
11306
+ :snapshot_availability_zone)
11178
11307
  SENSITIVE = []
11179
11308
  include Aws::Structure
11180
11309
  end
@@ -11406,7 +11535,10 @@ module Aws::RDS
11406
11535
  # @return [String]
11407
11536
  #
11408
11537
  # @!attribute [rw] subnets
11409
- # Contains a list of `Subnet` elements.
11538
+ # Contains a list of `Subnet` elements. The list of subnets shown here
11539
+ # might not reflect the current state of your VPC. For the most
11540
+ # up-to-date information, we recommend checking your VPC configuration
11541
+ # directly.
11410
11542
  # @return [Array<Types::Subnet>]
11411
11543
  #
11412
11544
  # @!attribute [rw] db_subnet_group_arn
@@ -13343,6 +13475,99 @@ module Aws::RDS
13343
13475
  include Aws::Structure
13344
13476
  end
13345
13477
 
13478
+ # @!attribute [rw] engine
13479
+ # The database engine to return major version details for.
13480
+ #
13481
+ # Valid Values:
13482
+ #
13483
+ # * `aurora-mysql`
13484
+ #
13485
+ # * `aurora-postgresql`
13486
+ #
13487
+ # * `custom-sqlserver-ee`
13488
+ #
13489
+ # * `custom-sqlserver-se`
13490
+ #
13491
+ # * `custom-sqlserver-web`
13492
+ #
13493
+ # * `db2-ae`
13494
+ #
13495
+ # * `db2-se`
13496
+ #
13497
+ # * `mariadb`
13498
+ #
13499
+ # * `mysql`
13500
+ #
13501
+ # * `oracle-ee`
13502
+ #
13503
+ # * `oracle-ee-cdb`
13504
+ #
13505
+ # * `oracle-se2`
13506
+ #
13507
+ # * `oracle-se2-cdb`
13508
+ #
13509
+ # * `postgres`
13510
+ #
13511
+ # * `sqlserver-ee`
13512
+ #
13513
+ # * `sqlserver-se`
13514
+ #
13515
+ # * `sqlserver-ex`
13516
+ #
13517
+ # * `sqlserver-web`
13518
+ # @return [String]
13519
+ #
13520
+ # @!attribute [rw] major_engine_version
13521
+ # A specific database major engine version to return details for.
13522
+ #
13523
+ # Example: `8.4`
13524
+ # @return [String]
13525
+ #
13526
+ # @!attribute [rw] marker
13527
+ # An optional pagination token provided by a previous request. If this
13528
+ # parameter is specified, the response includes only records beyond
13529
+ # the marker, up to the value specified by `MaxRecords`.
13530
+ # @return [String]
13531
+ #
13532
+ # @!attribute [rw] max_records
13533
+ # The maximum number of records to include in the response. If more
13534
+ # than the `MaxRecords` value is available, a pagination token called
13535
+ # a marker is included in the response so you can retrieve the
13536
+ # remaining results.
13537
+ #
13538
+ # Default: 100
13539
+ # @return [Integer]
13540
+ #
13541
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBMajorEngineVersionsRequest AWS API Documentation
13542
+ #
13543
+ class DescribeDBMajorEngineVersionsRequest < Struct.new(
13544
+ :engine,
13545
+ :major_engine_version,
13546
+ :marker,
13547
+ :max_records)
13548
+ SENSITIVE = []
13549
+ include Aws::Structure
13550
+ end
13551
+
13552
+ # @!attribute [rw] db_major_engine_versions
13553
+ # A list of `DBMajorEngineVersion` elements.
13554
+ # @return [Array<Types::DBMajorEngineVersion>]
13555
+ #
13556
+ # @!attribute [rw] marker
13557
+ # An optional pagination token provided by a previous request. If this
13558
+ # parameter is specified, the response includes only records beyond
13559
+ # the marker, up to the value specified by `MaxRecords`.
13560
+ # @return [String]
13561
+ #
13562
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBMajorEngineVersionsResponse AWS API Documentation
13563
+ #
13564
+ class DescribeDBMajorEngineVersionsResponse < Struct.new(
13565
+ :db_major_engine_versions,
13566
+ :marker)
13567
+ SENSITIVE = []
13568
+ include Aws::Structure
13569
+ end
13570
+
13346
13571
  # @!attribute [rw] db_parameter_group_name
13347
13572
  # The name of a specific DB parameter group to return details for.
13348
13573
  #
@@ -16382,7 +16607,7 @@ module Aws::RDS
16382
16607
  # @return [String]
16383
16608
  #
16384
16609
  # @!attribute [rw] engine_lifecycle_support
16385
- # The life cycle type for the global cluster.
16610
+ # The lifecycle type for the global cluster.
16386
16611
  #
16387
16612
  # For more information, see CreateGlobalCluster.
16388
16613
  # @return [String]
@@ -19347,26 +19572,50 @@ module Aws::RDS
19347
19572
  # @return [Boolean]
19348
19573
  #
19349
19574
  # @!attribute [rw] replica_mode
19350
- # A value that sets the open mode of a replica database to either
19351
- # mounted or read-only.
19575
+ # The open mode of a replica database.
19352
19576
  #
19353
- # <note markdown="1"> Currently, this parameter is only supported for Oracle DB instances.
19577
+ # <note markdown="1"> This parameter is only supported for Db2 DB instances and Oracle DB
19578
+ # instances.
19354
19579
  #
19355
19580
  # </note>
19356
19581
  #
19357
- # Mounted DB replicas are included in Oracle Enterprise Edition. The
19358
- # main use case for mounted replicas is cross-Region disaster
19359
- # recovery. The primary database doesn't use Active Data Guard to
19360
- # transmit information to the mounted replica. Because it doesn't
19361
- # accept user connections, a mounted replica can't serve a read-only
19362
- # workload. For more information, see [Working with Oracle Read
19363
- # Replicas for Amazon RDS][1] in the *Amazon RDS User Guide*.
19582
+ # Db2
19364
19583
  #
19365
- # This setting doesn't apply to RDS Custom DB instances.
19584
+ # : Standby DB replicas are included in Db2 Advanced Edition (AE) and
19585
+ # Db2 Standard Edition (SE). The main use case for standby replicas
19586
+ # is cross-Region disaster recovery. Because it doesn't accept user
19587
+ # connections, a standby replica can't serve a read-only workload.
19588
+ #
19589
+ # You can create a combination of standby and read-only DB replicas
19590
+ # for the same primary DB instance. For more information, see
19591
+ # [Working with read replicas for Amazon RDS for Db2][1] in the
19592
+ # *Amazon RDS User Guide*.
19593
+ #
19594
+ # To create standby DB replicas for RDS for Db2, set this parameter
19595
+ # to `mounted`.
19596
+ #
19597
+ # Oracle
19598
+ #
19599
+ # : Mounted DB replicas are included in Oracle Database Enterprise
19600
+ # Edition. The main use case for mounted replicas is cross-Region
19601
+ # disaster recovery. The primary database doesn't use Active Data
19602
+ # Guard to transmit information to the mounted replica. Because it
19603
+ # doesn't accept user connections, a mounted replica can't serve a
19604
+ # read-only workload.
19605
+ #
19606
+ # You can create a combination of mounted and read-only DB replicas
19607
+ # for the same primary DB instance. For more information, see
19608
+ # [Working with read replicas for Amazon RDS for Oracle][2] in the
19609
+ # *Amazon RDS User Guide*.
19610
+ #
19611
+ # For RDS Custom, you must specify this parameter and set it to
19612
+ # `mounted`. The value won't be set by default. After replica
19613
+ # creation, you can manage the open mode manually.
19366
19614
  #
19367
19615
  #
19368
19616
  #
19369
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
19617
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/db2-replication.html
19618
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
19370
19619
  # @return [String]
19371
19620
  #
19372
19621
  # @!attribute [rw] enable_customer_owned_ip
@@ -23380,11 +23629,11 @@ module Aws::RDS
23380
23629
  # standard support for that engine version. For more information, see
23381
23630
  # the following sections:
23382
23631
  #
23383
- # * Amazon Aurora - [Using Amazon RDS Extended Support][1] in the
23384
- # *Amazon Aurora User Guide*
23632
+ # * Amazon Aurora - [Amazon RDS Extended Support with Amazon
23633
+ # Aurora][1] in the *Amazon Aurora User Guide*
23385
23634
  #
23386
- # * Amazon RDS - [Using Amazon RDS Extended Support][2] in the *Amazon
23387
- # RDS User Guide*
23635
+ # * Amazon RDS - [Amazon RDS Extended Support with Amazon RDS][2] in
23636
+ # the *Amazon RDS User Guide*
23388
23637
  #
23389
23638
  # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
23390
23639
  #
@@ -24022,11 +24271,11 @@ module Aws::RDS
24022
24271
  # standard support for that engine version. For more information, see
24023
24272
  # the following sections:
24024
24273
  #
24025
- # * Amazon Aurora - [Using Amazon RDS Extended Support][1] in the
24026
- # *Amazon Aurora User Guide*
24274
+ # * Amazon Aurora - [Amazon RDS Extended Support with Amazon
24275
+ # Aurora][1] in the *Amazon Aurora User Guide*
24027
24276
  #
24028
- # * Amazon RDS - [Using Amazon RDS Extended Support][2] in the *Amazon
24029
- # RDS User Guide*
24277
+ # * Amazon RDS - [Amazon RDS Extended Support with Amazon RDS][2] in
24278
+ # the *Amazon RDS User Guide*
24030
24279
  #
24031
24280
  # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
24032
24281
  #
@@ -24639,11 +24888,11 @@ module Aws::RDS
24639
24888
  # standard support for that engine version. For more information, see
24640
24889
  # the following sections:
24641
24890
  #
24642
- # * Amazon Aurora - [Using Amazon RDS Extended Support][1] in the
24643
- # *Amazon Aurora User Guide*
24891
+ # * Amazon Aurora - [Amazon RDS Extended Support with Amazon
24892
+ # Aurora][1] in the *Amazon Aurora User Guide*
24644
24893
  #
24645
- # * Amazon RDS - [Using Amazon RDS Extended Support][2] in the *Amazon
24646
- # RDS User Guide*
24894
+ # * Amazon RDS - [Amazon RDS Extended Support with Amazon RDS][2] in
24895
+ # the *Amazon RDS User Guide*
24647
24896
  #
24648
24897
  # Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
24649
24898
  #
@@ -25244,8 +25493,9 @@ module Aws::RDS
25244
25493
  # Specifies where automated backups and manual snapshots are stored
25245
25494
  # for the restored DB instance.
25246
25495
  #
25247
- # Possible values are `outposts` (Amazon Web Services Outposts) and
25248
- # `region` (Amazon Web Services Region). The default is `region`.
25496
+ # Possible values are `local` (Dedicated Local Zone), `outposts`
25497
+ # (Amazon Web Services Outposts), and `region` (Amazon Web Services
25498
+ # Region). The default is `region`.
25249
25499
  #
25250
25500
  # For more information, see [Working with Amazon RDS on Amazon Web
25251
25501
  # Services Outposts][1] in the *Amazon RDS User Guide*.
@@ -25362,8 +25612,8 @@ module Aws::RDS
25362
25612
  # Extended Support. With RDS Extended Support, you can run the
25363
25613
  # selected major engine version on your DB instance past the end of
25364
25614
  # standard support for that engine version. For more information, see
25365
- # [Using Amazon RDS Extended Support][1] in the *Amazon RDS User
25366
- # Guide*.
25615
+ # [Amazon RDS Extended Support with Amazon RDS][1] in the *Amazon RDS
25616
+ # User Guide*.
25367
25617
  #
25368
25618
  # This setting applies only to RDS for MySQL and RDS for PostgreSQL.
25369
25619
  # For Amazon Aurora DB instances, the life cycle type is managed by
@@ -26095,7 +26345,7 @@ module Aws::RDS
26095
26345
  # Extended Support. With RDS Extended Support, you can run the
26096
26346
  # selected major engine version on your DB instance past the end of
26097
26347
  # standard support for that engine version. For more information, see
26098
- # [Using Amazon RDS Extended Support][1] in the *Amazon RDS User
26348
+ # [Amazon RDS Extended Support Amazon RDS][1] in the *Amazon RDS User
26099
26349
  # Guide*.
26100
26350
  #
26101
26351
  # This setting applies only to RDS for MySQL and RDS for PostgreSQL.
@@ -26745,6 +26995,8 @@ module Aws::RDS
26745
26995
  #
26746
26996
  # Valid Values:
26747
26997
  #
26998
+ # * `local` (Dedicated Local Zone)
26999
+ #
26748
27000
  # * `outposts` (Amazon Web Services Outposts)
26749
27001
  #
26750
27002
  # * `region` (Amazon Web Services Region)
@@ -26840,8 +27092,8 @@ module Aws::RDS
26840
27092
  # Extended Support. With RDS Extended Support, you can run the
26841
27093
  # selected major engine version on your DB instance past the end of
26842
27094
  # standard support for that engine version. For more information, see
26843
- # [Using Amazon RDS Extended Support][1] in the *Amazon RDS User
26844
- # Guide*.
27095
+ # [Amazon RDS Extended Support with Amazon RDS][1] in the *Amazon RDS
27096
+ # User Guide*.
26845
27097
  #
26846
27098
  # This setting applies only to RDS for MySQL and RDS for PostgreSQL.
26847
27099
  # For Amazon Aurora DB instances, the life cycle type is managed by
@@ -27764,23 +28016,9 @@ module Aws::RDS
27764
28016
  # operations. These can be set in the Amazon Web Services KMS key
27765
28017
  # policy:
27766
28018
  #
27767
- # * kms:Encrypt
27768
- #
27769
- # * kms:Decrypt
27770
- #
27771
- # * kms:GenerateDataKey
27772
- #
27773
- # * kms:GenerateDataKeyWithoutPlaintext
27774
- #
27775
- # * kms:ReEncryptFrom
27776
- #
27777
- # * kms:ReEncryptTo
27778
- #
27779
28019
  # * kms:CreateGrant
27780
28020
  #
27781
28021
  # * kms:DescribeKey
27782
- #
27783
- # * kms:RetireGrant
27784
28022
  # @return [String]
27785
28023
  #
27786
28024
  # @!attribute [rw] s3_prefix
@@ -28074,6 +28312,66 @@ module Aws::RDS
28074
28312
  #
28075
28313
  class SubscriptionNotFoundFault < Aws::EmptyStructure; end
28076
28314
 
28315
+ # This data type is used as a response element in the operation
28316
+ # `DescribeDBMajorEngineVersions`.
28317
+ #
28318
+ # You can use the information that this data type returns to plan for
28319
+ # upgrades.
28320
+ #
28321
+ # This data type only returns information for the open source engines
28322
+ # Amazon RDS for MariaDB, Amazon RDS for MySQL, Amazon RDS for
28323
+ # PostgreSQL, Aurora MySQL, and Aurora PostgreSQL.
28324
+ #
28325
+ # @!attribute [rw] lifecycle_support_name
28326
+ # The type of lifecycle support that the engine version is in.
28327
+ #
28328
+ # This parameter returns the following values:
28329
+ #
28330
+ # * `open-source-rds-standard-support` - Indicates RDS standard
28331
+ # support or Aurora standard support.
28332
+ #
28333
+ # * `open-source-rds-extended-support` - Indicates Amazon RDS Extended
28334
+ # Support.
28335
+ #
28336
+ # For Amazon RDS for MySQL, Amazon RDS for PostgreSQL, Aurora MySQL,
28337
+ # and Aurora PostgreSQL, this parameter returns both
28338
+ # `open-source-rds-standard-support` and
28339
+ # `open-source-rds-extended-support`.
28340
+ #
28341
+ # For Amazon RDS for MariaDB, this parameter only returns the value
28342
+ # `open-source-rds-standard-support`.
28343
+ #
28344
+ # For information about Amazon RDS Extended Support, see [Amazon RDS
28345
+ # Extended Support with Amazon RDS][1] in the *Amazon RDS User Guide*
28346
+ # and [Amazon RDS Extended Support with Amazon Aurora][2] in the
28347
+ # *Amazon Aurora User Guide*.
28348
+ #
28349
+ #
28350
+ #
28351
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/extended-support.html
28352
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/extended-support.html
28353
+ # @return [String]
28354
+ #
28355
+ # @!attribute [rw] lifecycle_support_start_date
28356
+ # The start date for the type of support returned by
28357
+ # `LifecycleSupportName`.
28358
+ # @return [Time]
28359
+ #
28360
+ # @!attribute [rw] lifecycle_support_end_date
28361
+ # The end date for the type of support returned by
28362
+ # `LifecycleSupportName`.
28363
+ # @return [Time]
28364
+ #
28365
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/SupportedEngineLifecycle AWS API Documentation
28366
+ #
28367
+ class SupportedEngineLifecycle < Struct.new(
28368
+ :lifecycle_support_name,
28369
+ :lifecycle_support_start_date,
28370
+ :lifecycle_support_end_date)
28371
+ SENSITIVE = []
28372
+ include Aws::Structure
28373
+ end
28374
+
28077
28375
  # @!attribute [rw] blue_green_deployment_identifier
28078
28376
  # The resource ID of the blue/green deployment.
28079
28377
  #