aws-sdk-rds 1.93.0 → 1.98.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.
@@ -19,7 +19,7 @@ module Aws
19
19
 
20
20
  def call(context)
21
21
  params = context.params
22
- if params[:source_region] && !params[:pre_signed_url]
22
+ if params.is_a?(Hash) && params[:source_region] && !params[:pre_signed_url]
23
23
  params[:pre_signed_url] = presigned_url(context, params)
24
24
  params[:destination_region] = context.config.region
25
25
  end
@@ -586,6 +586,9 @@ module Aws::RDS
586
586
  #
587
587
  # * Must contain 1 to 64 letters or numbers.
588
588
  #
589
+ # * Must begin with a letter. Subsequent characters can be letters,
590
+ # underscores, or digits (0-9).
591
+ #
589
592
  # * Can't be a word reserved by the specified database engine
590
593
  #
591
594
  # **MariaDB**
@@ -598,6 +601,9 @@ module Aws::RDS
598
601
  #
599
602
  # * Must contain 1 to 64 letters or numbers.
600
603
  #
604
+ # * Must begin with a letter. Subsequent characters can be letters,
605
+ # underscores, or digits (0-9).
606
+ #
601
607
  # * Can't be a word reserved by the specified database engine
602
608
  #
603
609
  # **PostgreSQL**
@@ -610,8 +616,8 @@ module Aws::RDS
610
616
  #
611
617
  # * Must contain 1 to 63 letters, numbers, or underscores.
612
618
  #
613
- # * Must begin with a letter or an underscore. Subsequent characters can
614
- # be letters, underscores, or digits (0-9).
619
+ # * Must begin with a letter. Subsequent characters can be letters,
620
+ # underscores, or digits (0-9).
615
621
  #
616
622
  # * Can't be a word reserved by the specified database engine
617
623
  #
@@ -1222,24 +1228,15 @@ module Aws::RDS
1222
1228
  # for each AWS Region.
1223
1229
  # @option options [String] :domain
1224
1230
  # The Active Directory directory ID to create the DB instance in.
1225
- # Currently, only Microsoft SQL Server and Oracle DB instances can be
1226
- # created in an Active Directory Domain.
1231
+ # Currently, only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
1232
+ # instances can be created in an Active Directory Domain.
1227
1233
  #
1228
- # For Microsoft SQL Server DB instances, Amazon RDS can use Windows
1229
- # Authentication to authenticate users that connect to the DB instance.
1230
- # For more information, see [ Using Windows Authentication with an
1231
- # Amazon RDS DB Instance Running Microsoft SQL Server][1] in the *Amazon
1234
+ # For more information, see [ Kerberos Authentication][1] in the *Amazon
1232
1235
  # RDS User Guide*.
1233
1236
  #
1234
- # For Oracle DB instances, Amazon RDS can use Kerberos Authentication to
1235
- # authenticate users that connect to the DB instance. For more
1236
- # information, see [ Using Kerberos Authentication with Amazon RDS for
1237
- # Oracle][2] in the *Amazon RDS User Guide*.
1238
1237
  #
1239
1238
  #
1240
- #
1241
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
1242
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
1239
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
1243
1240
  # @option options [Boolean] :copy_tags_to_snapshot
1244
1241
  # A value that indicates whether to copy tags from the DB instance to
1245
1242
  # snapshots of the DB instance. By default, tags are not copied.
@@ -1557,17 +1554,17 @@ module Aws::RDS
1557
1554
  # and subscribe to it.
1558
1555
  # @option options [String] :source_type
1559
1556
  # The type of source that is generating the events. For example, if you
1560
- # want to be notified of events generated by a DB instance, you would
1561
- # set this parameter to db-instance. if this value isn't specified, all
1562
- # events are returned.
1557
+ # want to be notified of events generated by a DB instance, you set this
1558
+ # parameter to `db-instance`. If this value isn't specified, all events
1559
+ # are returned.
1563
1560
  #
1564
1561
  # Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group` \|
1565
1562
  # `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
1566
1563
  # @option options [Array<String>] :event_categories
1567
- # A list of event categories for a SourceType that you want to subscribe
1568
- # to. You can see a list of the categories for a given SourceType in the
1569
- # [Events][1] topic in the *Amazon RDS User Guide* or by using the
1570
- # **DescribeEventCategories** action.
1564
+ # A list of event categories for a particular source type (`SourceType`)
1565
+ # that you want to subscribe to. You can see a list of the categories
1566
+ # for a given source type in [Events][1] in the *Amazon RDS User Guide*
1567
+ # or by using the `DescribeEventCategories` operation.
1571
1568
  #
1572
1569
  #
1573
1570
  #
@@ -1581,19 +1578,26 @@ module Aws::RDS
1581
1578
  #
1582
1579
  # Constraints:
1583
1580
  #
1584
- # * If SourceIds are supplied, SourceType must also be provided.
1581
+ # * If a `SourceIds` value is supplied, `SourceType` must also be
1582
+ # provided.
1585
1583
  #
1586
- # * If the source type is a DB instance, then a `DBInstanceIdentifier`
1584
+ # * If the source type is a DB instance, a `DBInstanceIdentifier` value
1587
1585
  # must be supplied.
1588
1586
  #
1589
- # * If the source type is a DB security group, a `DBSecurityGroupName`
1587
+ # * If the source type is a DB cluster, a `DBClusterIdentifier` value
1590
1588
  # must be supplied.
1591
1589
  #
1592
1590
  # * If the source type is a DB parameter group, a `DBParameterGroupName`
1591
+ # value must be supplied.
1592
+ #
1593
+ # * If the source type is a DB security group, a `DBSecurityGroupName`
1594
+ # value must be supplied.
1595
+ #
1596
+ # * If the source type is a DB snapshot, a `DBSnapshotIdentifier` value
1593
1597
  # must be supplied.
1594
1598
  #
1595
- # * If the source type is a DB snapshot, a `DBSnapshotIdentifier` must
1596
- # be supplied.
1599
+ # * If the source type is a DB cluster snapshot, a
1600
+ # `DBClusterSnapshotIdentifier` value must be supplied.
1597
1601
  # @option options [Boolean] :enabled
1598
1602
  # A value that indicates whether to activate the subscription. If the
1599
1603
  # event notification subscription isn't activated, the subscription is
@@ -2325,8 +2329,8 @@ module Aws::RDS
2325
2329
  # @option options [String] :source_type
2326
2330
  # The type of source that is generating the events.
2327
2331
  #
2328
- # Valid values: db-instance \| db-parameter-group \| db-security-group
2329
- # \| db-snapshot
2332
+ # Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group` \|
2333
+ # `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
2330
2334
  # @option options [Array<Types::Filter>] :filters
2331
2335
  # This parameter isn't currently supported.
2332
2336
  # @return [EventCategoryMap::Collection]
@@ -2414,19 +2418,26 @@ module Aws::RDS
2414
2418
  #
2415
2419
  # Constraints:
2416
2420
  #
2417
- # * If SourceIdentifier is supplied, SourceType must also be provided.
2421
+ # * If `SourceIdentifier` is supplied, `SourceType` must also be
2422
+ # provided.
2418
2423
  #
2419
- # * If the source type is `DBInstance`, then a `DBInstanceIdentifier`
2424
+ # * If the source type is a DB instance, a `DBInstanceIdentifier` value
2420
2425
  # must be supplied.
2421
2426
  #
2422
- # * If the source type is `DBSecurityGroup`, a `DBSecurityGroupName`
2427
+ # * If the source type is a DB cluster, a `DBClusterIdentifier` value
2423
2428
  # must be supplied.
2424
2429
  #
2425
- # * If the source type is `DBParameterGroup`, a `DBParameterGroupName`
2430
+ # * If the source type is a DB parameter group, a `DBParameterGroupName`
2431
+ # value must be supplied.
2432
+ #
2433
+ # * If the source type is a DB security group, a `DBSecurityGroupName`
2434
+ # value must be supplied.
2435
+ #
2436
+ # * If the source type is a DB snapshot, a `DBSnapshotIdentifier` value
2426
2437
  # must be supplied.
2427
2438
  #
2428
- # * If the source type is `DBSnapshot`, a `DBSnapshotIdentifier` must be
2429
- # supplied.
2439
+ # * If the source type is a DB cluster snapshot, a
2440
+ # `DBClusterSnapshotIdentifier` value must be supplied.
2430
2441
  #
2431
2442
  # * Can't end with a hyphen or contain two consecutive hyphens.
2432
2443
  # @option options [String] :source_type
@@ -85,9 +85,13 @@ module Aws::RDS
85
85
  # account. The used value is the count of the event subscriptions in
86
86
  # the account.
87
87
  #
88
- # * `ManualSnapshots` - The number of manual DB snapshots per account.
89
- # The used value is the count of the manual DB snapshots in the
90
- # account.
88
+ # * `ManualClusterSnapshots` - The number of manual DB cluster snapshots
89
+ # per account. The used value is the count of the manual DB cluster
90
+ # snapshots in the account.
91
+ #
92
+ # * `ManualSnapshots` - The number of manual DB instance snapshots per
93
+ # account. The used value is the count of the manual DB instance
94
+ # snapshots in the account.
91
95
  #
92
96
  # * `OptionGroups` - The number of DB option groups per account,
93
97
  # excluding default option groups. The used value is the count of
@@ -226,17 +230,23 @@ module Aws::RDS
226
230
  #
227
231
  # Constraints:
228
232
  #
229
- # * If the source type is a DB instance, then a `DBInstanceIdentifier`
230
- # must be supplied.
233
+ # * If the source type is a DB instance, a `DBInstanceIdentifier`
234
+ # value must be supplied.
231
235
  #
232
- # * If the source type is a DB security group, a `DBSecurityGroupName`
236
+ # * If the source type is a DB cluster, a `DBClusterIdentifier` value
233
237
  # must be supplied.
234
238
  #
235
239
  # * If the source type is a DB parameter group, a
236
- # `DBParameterGroupName` must be supplied.
240
+ # `DBParameterGroupName` value must be supplied.
241
+ #
242
+ # * If the source type is a DB security group, a `DBSecurityGroupName`
243
+ # value must be supplied.
244
+ #
245
+ # * If the source type is a DB snapshot, a `DBSnapshotIdentifier`
246
+ # value must be supplied.
237
247
  #
238
- # * If the source type is a DB snapshot, a `DBSnapshotIdentifier` must
239
- # be supplied.
248
+ # * If the source type is a DB cluster snapshot, a
249
+ # `DBClusterSnapshotIdentifier` value must be supplied.
240
250
  # @return [String]
241
251
  #
242
252
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/AddSourceIdentifierToSubscriptionMessage AWS API Documentation
@@ -2446,6 +2456,9 @@ module Aws::RDS
2446
2456
  #
2447
2457
  # * Must contain 1 to 64 letters or numbers.
2448
2458
  #
2459
+ # * Must begin with a letter. Subsequent characters can be letters,
2460
+ # underscores, or digits (0-9).
2461
+ #
2449
2462
  # * Can't be a word reserved by the specified database engine
2450
2463
  #
2451
2464
  # **MariaDB**
@@ -2458,6 +2471,9 @@ module Aws::RDS
2458
2471
  #
2459
2472
  # * Must contain 1 to 64 letters or numbers.
2460
2473
  #
2474
+ # * Must begin with a letter. Subsequent characters can be letters,
2475
+ # underscores, or digits (0-9).
2476
+ #
2461
2477
  # * Can't be a word reserved by the specified database engine
2462
2478
  #
2463
2479
  # **PostgreSQL**
@@ -2470,8 +2486,8 @@ module Aws::RDS
2470
2486
  #
2471
2487
  # * Must contain 1 to 63 letters, numbers, or underscores.
2472
2488
  #
2473
- # * Must begin with a letter or an underscore. Subsequent characters
2474
- # can be letters, underscores, or digits (0-9).
2489
+ # * Must begin with a letter. Subsequent characters can be letters,
2490
+ # underscores, or digits (0-9).
2475
2491
  #
2476
2492
  # * Can't be a word reserved by the specified database engine
2477
2493
  #
@@ -3147,24 +3163,15 @@ module Aws::RDS
3147
3163
  #
3148
3164
  # @!attribute [rw] domain
3149
3165
  # The Active Directory directory ID to create the DB instance in.
3150
- # Currently, only Microsoft SQL Server and Oracle DB instances can be
3151
- # created in an Active Directory Domain.
3152
- #
3153
- # For Microsoft SQL Server DB instances, Amazon RDS can use Windows
3154
- # Authentication to authenticate users that connect to the DB
3155
- # instance. For more information, see [ Using Windows Authentication
3156
- # with an Amazon RDS DB Instance Running Microsoft SQL Server][1] in
3157
- # the *Amazon RDS User Guide*.
3166
+ # Currently, only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL
3167
+ # DB instances can be created in an Active Directory Domain.
3158
3168
  #
3159
- # For Oracle DB instances, Amazon RDS can use Kerberos Authentication
3160
- # to authenticate users that connect to the DB instance. For more
3161
- # information, see [ Using Kerberos Authentication with Amazon RDS for
3162
- # Oracle][2] in the *Amazon RDS User Guide*.
3169
+ # For more information, see [ Kerberos Authentication][1] in the
3170
+ # *Amazon RDS User Guide*.
3163
3171
  #
3164
3172
  #
3165
3173
  #
3166
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
3167
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
3174
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
3168
3175
  # @return [String]
3169
3176
  #
3170
3177
  # @!attribute [rw] copy_tags_to_snapshot
@@ -3435,6 +3442,7 @@ module Aws::RDS
3435
3442
  # deletion_protection: false,
3436
3443
  # domain: "String",
3437
3444
  # domain_iam_role_name: "String",
3445
+ # replica_mode: "open-read-only", # accepts open-read-only, mounted
3438
3446
  # source_region: "String",
3439
3447
  # }
3440
3448
  #
@@ -3840,22 +3848,15 @@ module Aws::RDS
3840
3848
  #
3841
3849
  # @!attribute [rw] domain
3842
3850
  # The Active Directory directory ID to create the DB instance in.
3851
+ # Currently, only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL
3852
+ # DB instances can be created in an Active Directory Domain.
3843
3853
  #
3844
- # For Oracle DB instances, Amazon RDS can use Kerberos authentication
3845
- # to authenticate users that connect to the DB instance. For more
3846
- # information, see [ Using Kerberos Authentication with Amazon RDS for
3847
- # Oracle][1] in the *Amazon RDS User Guide*.
3848
- #
3849
- # For Microsoft SQL Server DB instances, Amazon RDS can use Windows
3850
- # Authentication to authenticate users that connect to the DB
3851
- # instance. For more information, see [ Using Windows Authentication
3852
- # with an Amazon RDS DB Instance Running Microsoft SQL Server][2] in
3853
- # the *Amazon RDS User Guide*.
3854
+ # For more information, see [ Kerberos Authentication][1] in the
3855
+ # *Amazon RDS User Guide*.
3854
3856
  #
3855
3857
  #
3856
3858
  #
3857
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
3858
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
3859
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
3859
3860
  # @return [String]
3860
3861
  #
3861
3862
  # @!attribute [rw] domain_iam_role_name
@@ -3863,6 +3864,30 @@ module Aws::RDS
3863
3864
  # the Directory Service.
3864
3865
  # @return [String]
3865
3866
  #
3867
+ # @!attribute [rw] replica_mode
3868
+ # The open mode of the replica database: mounted or read-only.
3869
+ #
3870
+ # <note markdown="1"> This parameter is only supported for Oracle DB instances.
3871
+ #
3872
+ # </note>
3873
+ #
3874
+ # Mounted DB replicas are included in Oracle Enterprise Edition. The
3875
+ # main use case for mounted replicas is cross-Region disaster
3876
+ # recovery. The primary database doesn't use Active Data Guard to
3877
+ # transmit information to the mounted replica. Because it doesn't
3878
+ # accept user connections, a mounted replica can't serve a read-only
3879
+ # workload.
3880
+ #
3881
+ # You can create a combination of mounted and read-only DB replicas
3882
+ # for the same primary DB instance. For more information, see [Working
3883
+ # with Oracle Read Replicas for Amazon RDS][1] in the *Amazon RDS User
3884
+ # Guide*.
3885
+ #
3886
+ #
3887
+ #
3888
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
3889
+ # @return [String]
3890
+ #
3866
3891
  # @!attribute [rw] destination_region
3867
3892
  # @return [String]
3868
3893
  #
@@ -3904,6 +3929,7 @@ module Aws::RDS
3904
3929
  :deletion_protection,
3905
3930
  :domain,
3906
3931
  :domain_iam_role_name,
3932
+ :replica_mode,
3907
3933
  :destination_region,
3908
3934
  :source_region)
3909
3935
  SENSITIVE = []
@@ -4376,18 +4402,18 @@ module Aws::RDS
4376
4402
  # @!attribute [rw] source_type
4377
4403
  # The type of source that is generating the events. For example, if
4378
4404
  # you want to be notified of events generated by a DB instance, you
4379
- # would set this parameter to db-instance. if this value isn't
4380
- # specified, all events are returned.
4405
+ # set this parameter to `db-instance`. If this value isn't specified,
4406
+ # all events are returned.
4381
4407
  #
4382
4408
  # Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group`
4383
4409
  # \| `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
4384
4410
  # @return [String]
4385
4411
  #
4386
4412
  # @!attribute [rw] event_categories
4387
- # A list of event categories for a SourceType that you want to
4388
- # subscribe to. You can see a list of the categories for a given
4389
- # SourceType in the [Events][1] topic in the *Amazon RDS User Guide*
4390
- # or by using the **DescribeEventCategories** action.
4413
+ # A list of event categories for a particular source type
4414
+ # (`SourceType`) that you want to subscribe to. You can see a list of
4415
+ # the categories for a given source type in [Events][1] in the *Amazon
4416
+ # RDS User Guide* or by using the `DescribeEventCategories` operation.
4391
4417
  #
4392
4418
  #
4393
4419
  #
@@ -4403,19 +4429,26 @@ module Aws::RDS
4403
4429
  #
4404
4430
  # Constraints:
4405
4431
  #
4406
- # * If SourceIds are supplied, SourceType must also be provided.
4432
+ # * If a `SourceIds` value is supplied, `SourceType` must also be
4433
+ # provided.
4407
4434
  #
4408
- # * If the source type is a DB instance, then a `DBInstanceIdentifier`
4409
- # must be supplied.
4435
+ # * If the source type is a DB instance, a `DBInstanceIdentifier`
4436
+ # value must be supplied.
4410
4437
  #
4411
- # * If the source type is a DB security group, a `DBSecurityGroupName`
4438
+ # * If the source type is a DB cluster, a `DBClusterIdentifier` value
4412
4439
  # must be supplied.
4413
4440
  #
4414
4441
  # * If the source type is a DB parameter group, a
4415
- # `DBParameterGroupName` must be supplied.
4442
+ # `DBParameterGroupName` value must be supplied.
4416
4443
  #
4417
- # * If the source type is a DB snapshot, a `DBSnapshotIdentifier` must
4418
- # be supplied.
4444
+ # * If the source type is a DB security group, a `DBSecurityGroupName`
4445
+ # value must be supplied.
4446
+ #
4447
+ # * If the source type is a DB snapshot, a `DBSnapshotIdentifier`
4448
+ # value must be supplied.
4449
+ #
4450
+ # * If the source type is a DB cluster snapshot, a
4451
+ # `DBClusterSnapshotIdentifier` value must be supplied.
4419
4452
  # @return [Array<String>]
4420
4453
  #
4421
4454
  # @!attribute [rw] enabled
@@ -5238,7 +5271,10 @@ module Aws::RDS
5238
5271
  #
5239
5272
  # @!attribute [rw] status
5240
5273
  # The current status of the endpoint. One of: `creating`, `available`,
5241
- # `deleting`, `modifying`.
5274
+ # `deleting`, `inactive`, `modifying`. The `inactive` state applies to
5275
+ # an endpoint that can't be used for a certain kind of cluster, such
5276
+ # as a `writer` endpoint for a read-only secondary cluster in a global
5277
+ # database.
5242
5278
  # @return [String]
5243
5279
  #
5244
5280
  # @!attribute [rw] endpoint_type
@@ -5886,6 +5922,16 @@ module Aws::RDS
5886
5922
  # `deprecated`.
5887
5923
  # @return [String]
5888
5924
  #
5925
+ # @!attribute [rw] supports_parallel_query
5926
+ # A value that indicates whether you can use Aurora parallel query
5927
+ # with a specific DB engine version.
5928
+ # @return [Boolean]
5929
+ #
5930
+ # @!attribute [rw] supports_global_databases
5931
+ # A value that indicates whether you can use Aurora global databases
5932
+ # with a specific DB engine version.
5933
+ # @return [Boolean]
5934
+ #
5889
5935
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBEngineVersion AWS API Documentation
5890
5936
  #
5891
5937
  class DBEngineVersion < Struct.new(
@@ -5903,7 +5949,9 @@ module Aws::RDS
5903
5949
  :supports_read_replica,
5904
5950
  :supported_engine_modes,
5905
5951
  :supported_feature_names,
5906
- :status)
5952
+ :status,
5953
+ :supports_parallel_query,
5954
+ :supports_global_databases)
5907
5955
  SENSITIVE = []
5908
5956
  include Aws::Structure
5909
5957
  end
@@ -6086,6 +6134,20 @@ module Aws::RDS
6086
6134
  # </note>
6087
6135
  # @return [Array<String>]
6088
6136
  #
6137
+ # @!attribute [rw] replica_mode
6138
+ # The open mode of an Oracle read replica. The default is
6139
+ # `open-read-only`. For more information, see [Working with Oracle
6140
+ # Read Replicas for Amazon RDS][1] in the *Amazon RDS User Guide*.
6141
+ #
6142
+ # <note markdown="1"> This attribute is only supported in RDS for Oracle.
6143
+ #
6144
+ # </note>
6145
+ #
6146
+ #
6147
+ #
6148
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
6149
+ # @return [String]
6150
+ #
6089
6151
  # @!attribute [rw] license_model
6090
6152
  # License model information for this DB instance.
6091
6153
  # @return [String]
@@ -6322,6 +6384,7 @@ module Aws::RDS
6322
6384
  :read_replica_source_db_instance_identifier,
6323
6385
  :read_replica_db_instance_identifiers,
6324
6386
  :read_replica_db_cluster_identifiers,
6387
+ :replica_mode,
6325
6388
  :license_model,
6326
6389
  :iops,
6327
6390
  :option_group_memberships,
@@ -8486,7 +8549,7 @@ module Aws::RDS
8486
8549
  # `db-cluster-endpoint-custom-type` filter can be one or more of:
8487
8550
  # `reader`, `any`. `Values` for the `db-cluster-endpoint-status`
8488
8551
  # filter can be one or more of: `available`, `creating`, `deleting`,
8489
- # `modifying`.
8552
+ # `inactive`, `modifying`.
8490
8553
  # @return [Array<Types::Filter>]
8491
8554
  #
8492
8555
  # @!attribute [rw] max_records
@@ -10101,8 +10164,8 @@ module Aws::RDS
10101
10164
  # @!attribute [rw] source_type
10102
10165
  # The type of source that is generating the events.
10103
10166
  #
10104
- # Valid values: db-instance \| db-parameter-group \| db-security-group
10105
- # \| db-snapshot
10167
+ # Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group`
10168
+ # \| `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
10106
10169
  # @return [String]
10107
10170
  #
10108
10171
  # @!attribute [rw] filters
@@ -10197,19 +10260,26 @@ module Aws::RDS
10197
10260
  #
10198
10261
  # Constraints:
10199
10262
  #
10200
- # * If SourceIdentifier is supplied, SourceType must also be provided.
10263
+ # * If `SourceIdentifier` is supplied, `SourceType` must also be
10264
+ # provided.
10201
10265
  #
10202
- # * If the source type is `DBInstance`, then a `DBInstanceIdentifier`
10203
- # must be supplied.
10266
+ # * If the source type is a DB instance, a `DBInstanceIdentifier`
10267
+ # value must be supplied.
10204
10268
  #
10205
- # * If the source type is `DBSecurityGroup`, a `DBSecurityGroupName`
10269
+ # * If the source type is a DB cluster, a `DBClusterIdentifier` value
10206
10270
  # must be supplied.
10207
10271
  #
10208
- # * If the source type is `DBParameterGroup`, a `DBParameterGroupName`
10209
- # must be supplied.
10272
+ # * If the source type is a DB parameter group, a
10273
+ # `DBParameterGroupName` value must be supplied.
10210
10274
  #
10211
- # * If the source type is `DBSnapshot`, a `DBSnapshotIdentifier` must
10212
- # be supplied.
10275
+ # * If the source type is a DB security group, a `DBSecurityGroupName`
10276
+ # value must be supplied.
10277
+ #
10278
+ # * If the source type is a DB snapshot, a `DBSnapshotIdentifier`
10279
+ # value must be supplied.
10280
+ #
10281
+ # * If the source type is a DB cluster snapshot, a
10282
+ # `DBClusterSnapshotIdentifier` value must be supplied.
10213
10283
  #
10214
10284
  # * Can't end with a hyphen or contain two consecutive hyphens.
10215
10285
  # @return [String]
@@ -11377,7 +11447,7 @@ module Aws::RDS
11377
11447
  end
11378
11448
 
11379
11449
  # Contains the results of a successful invocation of the
11380
- # `DescribeEventCategories` action.
11450
+ # `DescribeEventCategories` operation.
11381
11451
  #
11382
11452
  # @!attribute [rw] source_type
11383
11453
  # The source type that the returned categories belong to
@@ -11396,7 +11466,7 @@ module Aws::RDS
11396
11466
  include Aws::Structure
11397
11467
  end
11398
11468
 
11399
- # Data returned from the **DescribeEventCategories** action.
11469
+ # Data returned from the `DescribeEventCategories` operation.
11400
11470
  #
11401
11471
  # @!attribute [rw] event_categories_map_list
11402
11472
  # A list of EventCategoriesMap data types.
@@ -12787,6 +12857,13 @@ module Aws::RDS
12787
12857
  # The Active Directory directory ID to move the DB cluster to. Specify
12788
12858
  # `none` to remove the cluster from its current domain. The domain
12789
12859
  # must be created prior to this operation.
12860
+ #
12861
+ # For more information, see [Kerberos Authentication][1] in the
12862
+ # *Amazon Aurora User Guide*.
12863
+ #
12864
+ #
12865
+ #
12866
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/kerberos-authentication.html
12790
12867
  # @return [String]
12791
12868
  #
12792
12869
  # @!attribute [rw] domain_iam_role_name
@@ -13057,6 +13134,7 @@ module Aws::RDS
13057
13134
  # deletion_protection: false,
13058
13135
  # max_allocated_storage: 1,
13059
13136
  # certificate_rotation_restart: false,
13137
+ # replica_mode: "open-read-only", # accepts open-read-only, mounted
13060
13138
  # }
13061
13139
  #
13062
13140
  # @!attribute [rw] db_instance_identifier
@@ -13473,24 +13551,15 @@ module Aws::RDS
13473
13551
  # The Active Directory directory ID to move the DB instance to.
13474
13552
  # Specify `none` to remove the instance from its current domain. The
13475
13553
  # domain must be created prior to this operation. Currently, only
13476
- # Microsoft SQL Server and Oracle DB instances can be created in an
13477
- # Active Directory Domain.
13554
+ # MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances can
13555
+ # be created in an Active Directory Domain.
13478
13556
  #
13479
- # For Microsoft SQL Server DB instances, Amazon RDS can use Windows
13480
- # Authentication to authenticate users that connect to the DB
13481
- # instance. For more information, see [ Using Windows Authentication
13482
- # with an Amazon RDS DB Instance Running Microsoft SQL Server][1] in
13483
- # the *Amazon RDS User Guide*.
13484
- #
13485
- # For Oracle DB instances, Amazon RDS can use Kerberos authentication
13486
- # to authenticate users that connect to the DB instance. For more
13487
- # information, see [ Using Kerberos Authentication with Amazon RDS for
13488
- # Oracle][2] in the *Amazon RDS User Guide*.
13557
+ # For more information, see [ Kerberos Authentication][1] in the
13558
+ # *Amazon RDS User Guide*.
13489
13559
  #
13490
13560
  #
13491
13561
  #
13492
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
13493
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
13562
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
13494
13563
  # @return [String]
13495
13564
  #
13496
13565
  # @!attribute [rw] copy_tags_to_snapshot
@@ -13731,6 +13800,27 @@ module Aws::RDS
13731
13800
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL-certificate-rotation.html
13732
13801
  # @return [Boolean]
13733
13802
  #
13803
+ # @!attribute [rw] replica_mode
13804
+ # A value that sets the open mode of a replica database to either
13805
+ # mounted or read-only.
13806
+ #
13807
+ # <note markdown="1"> Currently, this parameter is only supported for Oracle DB instances.
13808
+ #
13809
+ # </note>
13810
+ #
13811
+ # Mounted DB replicas are included in Oracle Enterprise Edition. The
13812
+ # main use case for mounted replicas is cross-Region disaster
13813
+ # recovery. The primary database doesn't use Active Data Guard to
13814
+ # transmit information to the mounted replica. Because it doesn't
13815
+ # accept user connections, a mounted replica can't serve a read-only
13816
+ # workload. For more information, see [Working with Oracle Read
13817
+ # Replicas for Amazon RDS][1] in the *Amazon RDS User Guide*.
13818
+ #
13819
+ #
13820
+ #
13821
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
13822
+ # @return [String]
13823
+ #
13734
13824
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBInstanceMessage AWS API Documentation
13735
13825
  #
13736
13826
  class ModifyDBInstanceMessage < Struct.new(
@@ -13775,7 +13865,8 @@ module Aws::RDS
13775
13865
  :use_default_processor_features,
13776
13866
  :deletion_protection,
13777
13867
  :max_allocated_storage,
13778
- :certificate_rotation_restart)
13868
+ :certificate_rotation_restart,
13869
+ :replica_mode)
13779
13870
  SENSITIVE = []
13780
13871
  include Aws::Structure
13781
13872
  end
@@ -14248,15 +14339,15 @@ module Aws::RDS
14248
14339
  # would set this parameter to db-instance. If this value isn't
14249
14340
  # specified, all events are returned.
14250
14341
  #
14251
- # Valid values: db-instance \| db-parameter-group \| db-security-group
14252
- # \| db-snapshot
14342
+ # Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group`
14343
+ # \| `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
14253
14344
  # @return [String]
14254
14345
  #
14255
14346
  # @!attribute [rw] event_categories
14256
- # A list of event categories for a SourceType that you want to
14257
- # subscribe to. You can see a list of the categories for a given
14258
- # SourceType in the [Events][1] topic in the *Amazon RDS User Guide*
14259
- # or by using the **DescribeEventCategories** action.
14347
+ # A list of event categories for a source type (`SourceType`) that you
14348
+ # want to subscribe to. You can see a list of the categories for a
14349
+ # given source type in [Events][1] in the *Amazon RDS User Guide* or
14350
+ # by using the `DescribeEventCategories` operation.
14260
14351
  #
14261
14352
  #
14262
14353
  #
@@ -15071,6 +15162,11 @@ module Aws::RDS
15071
15162
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
15072
15163
  # @return [Boolean]
15073
15164
  #
15165
+ # @!attribute [rw] supports_global_databases
15166
+ # A value that indicates whether you can use Aurora global databases
15167
+ # with a specific combination of other DB engine attributes.
15168
+ # @return [Boolean]
15169
+ #
15074
15170
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/OrderableDBInstanceOption AWS API Documentation
15075
15171
  #
15076
15172
  class OrderableDBInstanceOption < Struct.new(
@@ -15099,7 +15195,8 @@ module Aws::RDS
15099
15195
  :supported_engine_modes,
15100
15196
  :supports_storage_autoscaling,
15101
15197
  :supports_kerberos_authentication,
15102
- :outpost_capable)
15198
+ :outpost_capable,
15199
+ :supports_global_databases)
15103
15200
  SENSITIVE = []
15104
15201
  include Aws::Structure
15105
15202
  end
@@ -16530,10 +16627,11 @@ module Aws::RDS
16530
16627
  # @return [String]
16531
16628
  #
16532
16629
  # @!attribute [rw] engine
16533
- # The name of the database engine to be used for the restored DB
16534
- # cluster.
16630
+ # The name of the database engine to be used for this DB cluster.
16535
16631
  #
16536
- # Valid Values: `aurora`, `aurora-postgresql`
16632
+ # Valid Values: `aurora` (for MySQL 5.6-compatible Aurora),
16633
+ # `aurora-mysql` (for MySQL 5.7-compatible Aurora), and
16634
+ # `aurora-postgresql`
16537
16635
  # @return [String]
16538
16636
  #
16539
16637
  # @!attribute [rw] engine_version
@@ -16701,7 +16799,7 @@ module Aws::RDS
16701
16799
  #
16702
16800
  # MySQL versions 5.5, 5.6, and 5.7 are supported.
16703
16801
  #
16704
- # Example: `5.6.40`
16802
+ # Example: `5.6.40`, `5.7.28`
16705
16803
  # @return [String]
16706
16804
  #
16707
16805
  # @!attribute [rw] s3_bucket_name
@@ -17092,7 +17190,16 @@ module Aws::RDS
17092
17190
  #
17093
17191
  # @!attribute [rw] domain
17094
17192
  # Specify the Active Directory directory ID to restore the DB cluster
17095
- # in. The domain must be created prior to this operation.
17193
+ # in. The domain must be created prior to this operation. Currently,
17194
+ # only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
17195
+ # instances can be created in an Active Directory Domain.
17196
+ #
17197
+ # For more information, see [ Kerberos Authentication][1] in the
17198
+ # *Amazon RDS User Guide*.
17199
+ #
17200
+ #
17201
+ #
17202
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
17096
17203
  # @return [String]
17097
17204
  #
17098
17205
  # @!attribute [rw] domain_iam_role_name
@@ -17703,24 +17810,15 @@ module Aws::RDS
17703
17810
  # @!attribute [rw] domain
17704
17811
  # Specify the Active Directory directory ID to restore the DB instance
17705
17812
  # in. The domain must be created prior to this operation. Currently,
17706
- # only Microsoft SQL Server and Oracle DB instances can be created in
17707
- # an Active Directory Domain.
17708
- #
17709
- # For Microsoft SQL Server DB instances, Amazon RDS can use Windows
17710
- # Authentication to authenticate users that connect to the DB
17711
- # instance. For more information, see [ Using Windows Authentication
17712
- # with an Amazon RDS DB Instance Running Microsoft SQL Server][1] in
17713
- # the *Amazon RDS User Guide*.
17813
+ # only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
17814
+ # instances can be created in an Active Directory Domain.
17714
17815
  #
17715
- # For Oracle DB instances, Amazon RDS can use Kerberos authentication
17716
- # to authenticate users that connect to the DB instance. For more
17717
- # information, see [ Using Kerberos Authentication with Amazon RDS for
17718
- # Oracle][2] in the *Amazon RDS User Guide*.
17816
+ # For more information, see [ Kerberos Authentication][1] in the
17817
+ # *Amazon RDS User Guide*.
17719
17818
  #
17720
17819
  #
17721
17820
  #
17722
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
17723
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
17821
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
17724
17822
  # @return [String]
17725
17823
  #
17726
17824
  # @!attribute [rw] copy_tags_to_snapshot
@@ -18664,24 +18762,15 @@ module Aws::RDS
18664
18762
  # @!attribute [rw] domain
18665
18763
  # Specify the Active Directory directory ID to restore the DB instance
18666
18764
  # in. The domain must be created prior to this operation. Currently,
18667
- # only Microsoft SQL Server and Oracle DB instances can be created in
18668
- # an Active Directory Domain.
18669
- #
18670
- # For Microsoft SQL Server DB instances, Amazon RDS can use Windows
18671
- # Authentication to authenticate users that connect to the DB
18672
- # instance. For more information, see [ Using Windows Authentication
18673
- # with an Amazon RDS DB Instance Running Microsoft SQL Server][1] in
18674
- # the *Amazon RDS User Guide*.
18765
+ # only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
18766
+ # instances can be created in an Active Directory Domain.
18675
18767
  #
18676
- # For Oracle DB instances, Amazon RDS can use Kerberos authentication
18677
- # to authenticate users that connect to the DB instance. For more
18678
- # information, see [ Using Kerberos Authentication with Amazon RDS for
18679
- # Oracle][2] in the *Amazon RDS User Guide*.
18768
+ # For more information, see [ Kerberos Authentication][1] in the
18769
+ # *Amazon RDS User Guide*.
18680
18770
  #
18681
18771
  #
18682
18772
  #
18683
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
18684
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
18773
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
18685
18774
  # @return [String]
18686
18775
  #
18687
18776
  # @!attribute [rw] domain_iam_role_name
@@ -19325,8 +19414,26 @@ module Aws::RDS
19325
19414
  # The ID of the AWS KMS key to use to encrypt the snapshot exported to
19326
19415
  # Amazon S3. The KMS key ID is the Amazon Resource Name (ARN), the KMS
19327
19416
  # key identifier, or the KMS key alias for the KMS encryption key. The
19328
- # IAM role used for the snapshot export must have encryption and
19329
- # decryption permissions to use this KMS key.
19417
+ # caller of this operation must be authorized to execute the following
19418
+ # operations. These can be set in the KMS key policy:
19419
+ #
19420
+ # * GrantOperation.Encrypt
19421
+ #
19422
+ # * GrantOperation.Decrypt
19423
+ #
19424
+ # * GrantOperation.GenerateDataKey
19425
+ #
19426
+ # * GrantOperation.GenerateDataKeyWithoutPlaintext
19427
+ #
19428
+ # * GrantOperation.ReEncryptFrom
19429
+ #
19430
+ # * GrantOperation.ReEncryptTo
19431
+ #
19432
+ # * GrantOperation.CreateGrant
19433
+ #
19434
+ # * GrantOperation.DescribeKey
19435
+ #
19436
+ # * GrantOperation.RetireGrant
19330
19437
  # @return [String]
19331
19438
  #
19332
19439
  # @!attribute [rw] s3_prefix