aws-sdk-rds 1.93.0 → 1.98.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: d129b7c49cd98d39819d57d51af738ad5065bf598d24c3de779332db7e8a75b7
4
- data.tar.gz: ff7d2f3e6bec679350b20ef24fa58a8b4973baa1bc88524006fc96a70160dae2
3
+ metadata.gz: f4a9a733f413d89910d9e7af826f32a75672adf52a9f3c772e877b231d013b0f
4
+ data.tar.gz: 51f81cc9c7c68274de8dc51c56b7b61282a3b498a436eb3945364f10eef54a41
5
5
  SHA512:
6
- metadata.gz: f2ec1e6866037e2b37993035953fbcfff8f202a13e0f9b870fc399c58e110f950d6398b77a54615039b81317c2dd18aeb68fc0571a9af295a58fff91ec4a95a3
7
- data.tar.gz: 9d2dd5c068c0c1aac31f7feee42ecaa77c071e4533d3491eefbfa0eb94d2a1246c397abd56038890098496976f238d63f9499d419bc5cc061b9c7f7a993b628b
6
+ metadata.gz: 87c7aeb230524d874cafea66cb2bfe235618e4d8e809c5b0e5b2f534d02d42b6f5ab56d1480122cbcb99f5f81bd215112b742e465441384a30871b28b58cbf53
7
+ data.tar.gz: b26cf73cf00904d2bc5a661f50cd2d4247a3593e50f104853b06a94af4d1537205cbb7f697c951fcd7bfabd40f0eeaae2c67cd5db054b5c9393fbf2308ac2613
@@ -7,6 +7,7 @@
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
10
+
10
11
  require 'aws-sigv4'
11
12
  require 'aws-sdk-core'
12
13
 
@@ -70,9 +71,9 @@ require_relative 'aws-sdk-rds/customizations'
70
71
  #
71
72
  # See {Errors} for more information.
72
73
  #
73
- # @service
74
+ # @!group service
74
75
  module Aws::RDS
75
76
 
76
- GEM_VERSION = '1.93.0'
77
+ GEM_VERSION = '1.98.0'
77
78
 
78
79
  end
@@ -87,13 +87,28 @@ module Aws::RDS
87
87
  # * `Aws::Credentials` - Used for configuring static, non-refreshing
88
88
  # credentials.
89
89
  #
90
+ # * `Aws::SharedCredentials` - Used for loading static credentials from a
91
+ # shared file, such as `~/.aws/config`.
92
+ #
93
+ # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
94
+ #
95
+ # * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
96
+ # assume a role after providing credentials via the web.
97
+ #
98
+ # * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
99
+ # access token generated from `aws login`.
100
+ #
101
+ # * `Aws::ProcessCredentials` - Used for loading credentials from a
102
+ # process that outputs to stdout.
103
+ #
90
104
  # * `Aws::InstanceProfileCredentials` - Used for loading credentials
91
105
  # from an EC2 IMDS on an EC2 instance.
92
106
  #
93
- # * `Aws::SharedCredentials` - Used for loading credentials from a
94
- # shared file, such as `~/.aws/config`.
107
+ # * `Aws::ECSCredentials` - Used for loading credentials from
108
+ # instances running in ECS.
95
109
  #
96
- # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
110
+ # * `Aws::CognitoIdentityCredentials` - Used for loading credentials
111
+ # from the Cognito Identity service.
97
112
  #
98
113
  # When `:credentials` are not configured directly, the following
99
114
  # locations will be searched for credentials:
@@ -103,10 +118,10 @@ module Aws::RDS
103
118
  # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
104
119
  # * `~/.aws/credentials`
105
120
  # * `~/.aws/config`
106
- # * EC2 IMDS instance profile - When used by default, the timeouts are
107
- # very aggressive. Construct and pass an instance of
108
- # `Aws::InstanceProfileCredentails` to enable retries and extended
109
- # timeouts.
121
+ # * EC2/ECS IMDS instance profile - When used by default, the timeouts
122
+ # are very aggressive. Construct and pass an instance of
123
+ # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
124
+ # enable retries and extended timeouts.
110
125
  #
111
126
  # @option options [required, String] :region
112
127
  # The AWS region to connect to. The configured `:region` is
@@ -410,17 +425,23 @@ module Aws::RDS
410
425
  #
411
426
  # Constraints:
412
427
  #
413
- # * If the source type is a DB instance, then a `DBInstanceIdentifier`
428
+ # * If the source type is a DB instance, a `DBInstanceIdentifier` value
414
429
  # must be supplied.
415
430
  #
416
- # * If the source type is a DB security group, a `DBSecurityGroupName`
431
+ # * If the source type is a DB cluster, a `DBClusterIdentifier` value
417
432
  # must be supplied.
418
433
  #
419
434
  # * If the source type is a DB parameter group, a `DBParameterGroupName`
435
+ # value must be supplied.
436
+ #
437
+ # * If the source type is a DB security group, a `DBSecurityGroupName`
438
+ # value must be supplied.
439
+ #
440
+ # * If the source type is a DB snapshot, a `DBSnapshotIdentifier` value
420
441
  # must be supplied.
421
442
  #
422
- # * If the source type is a DB snapshot, a `DBSnapshotIdentifier` must
423
- # be supplied.
443
+ # * If the source type is a DB cluster snapshot, a
444
+ # `DBClusterSnapshotIdentifier` value must be supplied.
424
445
  #
425
446
  # @return [Types::AddSourceIdentifierToSubscriptionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
426
447
  #
@@ -2719,6 +2740,9 @@ module Aws::RDS
2719
2740
  #
2720
2741
  # * Must contain 1 to 64 letters or numbers.
2721
2742
  #
2743
+ # * Must begin with a letter. Subsequent characters can be letters,
2744
+ # underscores, or digits (0-9).
2745
+ #
2722
2746
  # * Can't be a word reserved by the specified database engine
2723
2747
  #
2724
2748
  # **MariaDB**
@@ -2731,6 +2755,9 @@ module Aws::RDS
2731
2755
  #
2732
2756
  # * Must contain 1 to 64 letters or numbers.
2733
2757
  #
2758
+ # * Must begin with a letter. Subsequent characters can be letters,
2759
+ # underscores, or digits (0-9).
2760
+ #
2734
2761
  # * Can't be a word reserved by the specified database engine
2735
2762
  #
2736
2763
  # **PostgreSQL**
@@ -2743,8 +2770,8 @@ module Aws::RDS
2743
2770
  #
2744
2771
  # * Must contain 1 to 63 letters, numbers, or underscores.
2745
2772
  #
2746
- # * Must begin with a letter or an underscore. Subsequent characters can
2747
- # be letters, underscores, or digits (0-9).
2773
+ # * Must begin with a letter. Subsequent characters can be letters,
2774
+ # underscores, or digits (0-9).
2748
2775
  #
2749
2776
  # * Can't be a word reserved by the specified database engine
2750
2777
  #
@@ -3386,24 +3413,15 @@ module Aws::RDS
3386
3413
  #
3387
3414
  # @option params [String] :domain
3388
3415
  # The Active Directory directory ID to create the DB instance in.
3389
- # Currently, only Microsoft SQL Server and Oracle DB instances can be
3390
- # created in an Active Directory Domain.
3416
+ # Currently, only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
3417
+ # instances can be created in an Active Directory Domain.
3391
3418
  #
3392
- # For Microsoft SQL Server DB instances, Amazon RDS can use Windows
3393
- # Authentication to authenticate users that connect to the DB instance.
3394
- # For more information, see [ Using Windows Authentication with an
3395
- # Amazon RDS DB Instance Running Microsoft SQL Server][1] in the *Amazon
3419
+ # For more information, see [ Kerberos Authentication][1] in the *Amazon
3396
3420
  # RDS User Guide*.
3397
3421
  #
3398
- # For Oracle DB instances, Amazon RDS can use Kerberos Authentication to
3399
- # authenticate users that connect to the DB instance. For more
3400
- # information, see [ Using Kerberos Authentication with Amazon RDS for
3401
- # Oracle][2] in the *Amazon RDS User Guide*.
3402
3422
  #
3403
3423
  #
3404
- #
3405
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
3406
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
3424
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
3407
3425
  #
3408
3426
  # @option params [Boolean] :copy_tags_to_snapshot
3409
3427
  # A value that indicates whether to copy tags from the DB instance to
@@ -3712,6 +3730,7 @@ module Aws::RDS
3712
3730
  # resp.db_instance.read_replica_db_instance_identifiers[0] #=> String
3713
3731
  # resp.db_instance.read_replica_db_cluster_identifiers #=> Array
3714
3732
  # resp.db_instance.read_replica_db_cluster_identifiers[0] #=> String
3733
+ # resp.db_instance.replica_mode #=> String, one of "open-read-only", "mounted"
3715
3734
  # resp.db_instance.license_model #=> String
3716
3735
  # resp.db_instance.iops #=> Integer
3717
3736
  # resp.db_instance.option_group_memberships #=> Array
@@ -4162,27 +4181,42 @@ module Aws::RDS
4162
4181
  #
4163
4182
  # @option params [String] :domain
4164
4183
  # The Active Directory directory ID to create the DB instance in.
4184
+ # Currently, only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
4185
+ # instances can be created in an Active Directory Domain.
4165
4186
  #
4166
- # For Oracle DB instances, Amazon RDS can use Kerberos authentication to
4167
- # authenticate users that connect to the DB instance. For more
4168
- # information, see [ Using Kerberos Authentication with Amazon RDS for
4169
- # Oracle][1] in the *Amazon RDS User Guide*.
4170
- #
4171
- # For Microsoft SQL Server DB instances, Amazon RDS can use Windows
4172
- # Authentication to authenticate users that connect to the DB instance.
4173
- # For more information, see [ Using Windows Authentication with an
4174
- # Amazon RDS DB Instance Running Microsoft SQL Server][2] in the *Amazon
4187
+ # For more information, see [ Kerberos Authentication][1] in the *Amazon
4175
4188
  # RDS User Guide*.
4176
4189
  #
4177
4190
  #
4178
4191
  #
4179
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
4180
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
4192
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
4181
4193
  #
4182
4194
  # @option params [String] :domain_iam_role_name
4183
4195
  # Specify the name of the IAM role to be used when making API calls to
4184
4196
  # the Directory Service.
4185
4197
  #
4198
+ # @option params [String] :replica_mode
4199
+ # The open mode of the replica database: mounted or read-only.
4200
+ #
4201
+ # <note markdown="1"> This parameter is only supported for Oracle DB instances.
4202
+ #
4203
+ # </note>
4204
+ #
4205
+ # Mounted DB replicas are included in Oracle Enterprise Edition. The
4206
+ # main use case for mounted replicas is cross-Region disaster recovery.
4207
+ # The primary database doesn't use Active Data Guard to transmit
4208
+ # information to the mounted replica. Because it doesn't accept user
4209
+ # connections, a mounted replica can't serve a read-only workload.
4210
+ #
4211
+ # You can create a combination of mounted and read-only DB replicas for
4212
+ # the same primary DB instance. For more information, see [Working with
4213
+ # Oracle Read Replicas for Amazon RDS][1] in the *Amazon RDS User
4214
+ # Guide*.
4215
+ #
4216
+ #
4217
+ #
4218
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
4219
+ #
4186
4220
  # @option params [String] :source_region
4187
4221
  # The source region of the snapshot. This is only needed when the
4188
4222
  # shapshot is encrypted and in a different region.
@@ -4261,6 +4295,7 @@ module Aws::RDS
4261
4295
  # deletion_protection: false,
4262
4296
  # domain: "String",
4263
4297
  # domain_iam_role_name: "String",
4298
+ # replica_mode: "open-read-only", # accepts open-read-only, mounted
4264
4299
  # source_region: "String",
4265
4300
  # })
4266
4301
  #
@@ -4329,6 +4364,7 @@ module Aws::RDS
4329
4364
  # resp.db_instance.read_replica_db_instance_identifiers[0] #=> String
4330
4365
  # resp.db_instance.read_replica_db_cluster_identifiers #=> Array
4331
4366
  # resp.db_instance.read_replica_db_cluster_identifiers[0] #=> String
4367
+ # resp.db_instance.replica_mode #=> String, one of "open-read-only", "mounted"
4332
4368
  # resp.db_instance.license_model #=> String
4333
4369
  # resp.db_instance.iops #=> Integer
4334
4370
  # resp.db_instance.option_group_memberships #=> Array
@@ -4908,21 +4944,22 @@ module Aws::RDS
4908
4944
  # create a topic in Amazon SNS and subscribe to the topic. The ARN is
4909
4945
  # displayed in the SNS console.
4910
4946
  #
4911
- # You can specify the type of source (SourceType) you want to be
4912
- # notified of, provide a list of RDS sources (SourceIds) that triggers
4913
- # the events, and provide a list of event categories (EventCategories)
4914
- # for events you want to be notified of. For example, you can specify
4915
- # SourceType = db-instance, SourceIds = mydbinstance1, mydbinstance2 and
4916
- # EventCategories = Availability, Backup.
4917
- #
4918
- # If you specify both the SourceType and SourceIds, such as SourceType =
4919
- # db-instance and SourceIdentifier = myDBInstance1, you are notified of
4920
- # all the db-instance events for the specified source. If you specify a
4921
- # SourceType but do not specify a SourceIdentifier, you receive notice
4922
- # of the events for that source type for all your RDS sources. If you
4923
- # don't specify either the SourceType or the SourceIdentifier, you are
4924
- # notified of events generated from all RDS sources belonging to your
4925
- # customer account.
4947
+ # You can specify the type of source (`SourceType`) that you want to be
4948
+ # notified of and provide a list of RDS sources (`SourceIds`) that
4949
+ # triggers the events. You can also provide a list of event categories
4950
+ # (`EventCategories`) for events that you want to be notified of. For
4951
+ # example, you can specify `SourceType` = `db-instance`, `SourceIds` =
4952
+ # `mydbinstance1`, `mydbinstance2` and `EventCategories` =
4953
+ # `Availability`, `Backup`.
4954
+ #
4955
+ # If you specify both the `SourceType` and `SourceIds`, such as
4956
+ # `SourceType` = `db-instance` and `SourceIdentifier` = `myDBInstance1`,
4957
+ # you are notified of all the `db-instance` events for the specified
4958
+ # source. If you specify a `SourceType` but do not specify a
4959
+ # `SourceIdentifier`, you receive notice of the events for that source
4960
+ # type for all your RDS sources. If you don't specify either the
4961
+ # SourceType or the `SourceIdentifier`, you are notified of events
4962
+ # generated from all RDS sources belonging to your customer account.
4926
4963
  #
4927
4964
  # <note markdown="1"> RDS event notification is only available for unencrypted SNS topics.
4928
4965
  # If you specify an encrypted SNS topic, event notifications aren't
@@ -4942,18 +4979,18 @@ module Aws::RDS
4942
4979
  #
4943
4980
  # @option params [String] :source_type
4944
4981
  # The type of source that is generating the events. For example, if you
4945
- # want to be notified of events generated by a DB instance, you would
4946
- # set this parameter to db-instance. if this value isn't specified, all
4947
- # events are returned.
4982
+ # want to be notified of events generated by a DB instance, you set this
4983
+ # parameter to `db-instance`. If this value isn't specified, all events
4984
+ # are returned.
4948
4985
  #
4949
4986
  # Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group` \|
4950
4987
  # `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
4951
4988
  #
4952
4989
  # @option params [Array<String>] :event_categories
4953
- # A list of event categories for a SourceType that you want to subscribe
4954
- # to. You can see a list of the categories for a given SourceType in the
4955
- # [Events][1] topic in the *Amazon RDS User Guide* or by using the
4956
- # **DescribeEventCategories** action.
4990
+ # A list of event categories for a particular source type (`SourceType`)
4991
+ # that you want to subscribe to. You can see a list of the categories
4992
+ # for a given source type in [Events][1] in the *Amazon RDS User Guide*
4993
+ # or by using the `DescribeEventCategories` operation.
4957
4994
  #
4958
4995
  #
4959
4996
  #
@@ -4968,19 +5005,26 @@ module Aws::RDS
4968
5005
  #
4969
5006
  # Constraints:
4970
5007
  #
4971
- # * If SourceIds are supplied, SourceType must also be provided.
5008
+ # * If a `SourceIds` value is supplied, `SourceType` must also be
5009
+ # provided.
4972
5010
  #
4973
- # * If the source type is a DB instance, then a `DBInstanceIdentifier`
5011
+ # * If the source type is a DB instance, a `DBInstanceIdentifier` value
4974
5012
  # must be supplied.
4975
5013
  #
4976
- # * If the source type is a DB security group, a `DBSecurityGroupName`
5014
+ # * If the source type is a DB cluster, a `DBClusterIdentifier` value
4977
5015
  # must be supplied.
4978
5016
  #
4979
5017
  # * If the source type is a DB parameter group, a `DBParameterGroupName`
5018
+ # value must be supplied.
5019
+ #
5020
+ # * If the source type is a DB security group, a `DBSecurityGroupName`
5021
+ # value must be supplied.
5022
+ #
5023
+ # * If the source type is a DB snapshot, a `DBSnapshotIdentifier` value
4980
5024
  # must be supplied.
4981
5025
  #
4982
- # * If the source type is a DB snapshot, a `DBSnapshotIdentifier` must
4983
- # be supplied.
5026
+ # * If the source type is a DB cluster snapshot, a
5027
+ # `DBClusterSnapshotIdentifier` value must be supplied.
4984
5028
  #
4985
5029
  # @option params [Boolean] :enabled
4986
5030
  # A value that indicates whether to activate the subscription. If the
@@ -5845,6 +5889,7 @@ module Aws::RDS
5845
5889
  # resp.db_instance.read_replica_db_instance_identifiers[0] #=> String
5846
5890
  # resp.db_instance.read_replica_db_cluster_identifiers #=> Array
5847
5891
  # resp.db_instance.read_replica_db_cluster_identifiers[0] #=> String
5892
+ # resp.db_instance.replica_mode #=> String, one of "open-read-only", "mounted"
5848
5893
  # resp.db_instance.license_model #=> String
5849
5894
  # resp.db_instance.iops #=> Integer
5850
5895
  # resp.db_instance.option_group_memberships #=> Array
@@ -6798,7 +6843,7 @@ module Aws::RDS
6798
6843
  # `writer`, `custom`. `Values` for the `db-cluster-endpoint-custom-type`
6799
6844
  # filter can be one or more of: `reader`, `any`. `Values` for the
6800
6845
  # `db-cluster-endpoint-status` filter can be one or more of:
6801
- # `available`, `creating`, `deleting`, `modifying`.
6846
+ # `available`, `creating`, `deleting`, `inactive`, `modifying`.
6802
6847
  #
6803
6848
  # @option params [Integer] :max_records
6804
6849
  # The maximum number of records to include in the response. If more
@@ -7652,6 +7697,8 @@ module Aws::RDS
7652
7697
  # resp.db_engine_versions[0].supported_feature_names #=> Array
7653
7698
  # resp.db_engine_versions[0].supported_feature_names[0] #=> String
7654
7699
  # resp.db_engine_versions[0].status #=> String
7700
+ # resp.db_engine_versions[0].supports_parallel_query #=> Boolean
7701
+ # resp.db_engine_versions[0].supports_global_databases #=> Boolean
7655
7702
  #
7656
7703
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBEngineVersions AWS API Documentation
7657
7704
  #
@@ -7940,6 +7987,7 @@ module Aws::RDS
7940
7987
  # resp.db_instances[0].read_replica_db_instance_identifiers[0] #=> String
7941
7988
  # resp.db_instances[0].read_replica_db_cluster_identifiers #=> Array
7942
7989
  # resp.db_instances[0].read_replica_db_cluster_identifiers[0] #=> String
7990
+ # resp.db_instances[0].replica_mode #=> String, one of "open-read-only", "mounted"
7943
7991
  # resp.db_instances[0].license_model #=> String
7944
7992
  # resp.db_instances[0].iops #=> Integer
7945
7993
  # resp.db_instances[0].option_group_memberships #=> Array
@@ -9145,8 +9193,8 @@ module Aws::RDS
9145
9193
 
9146
9194
  # Displays a list of categories for all event source types, or, if
9147
9195
  # specified, for a specified source type. You can see a list of the
9148
- # event categories and source types in the [ Events][1] topic in the
9149
- # *Amazon RDS User Guide.*
9196
+ # event categories and source types in [ Events][1] in the *Amazon RDS
9197
+ # User Guide.*
9150
9198
  #
9151
9199
  #
9152
9200
  #
@@ -9155,8 +9203,8 @@ module Aws::RDS
9155
9203
  # @option params [String] :source_type
9156
9204
  # The type of source that is generating the events.
9157
9205
  #
9158
- # Valid values: db-instance \| db-parameter-group \| db-security-group
9159
- # \| db-snapshot
9206
+ # Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group` \|
9207
+ # `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
9160
9208
  #
9161
9209
  # @option params [Array<Types::Filter>] :filters
9162
9210
  # This parameter isn't currently supported.
@@ -9207,10 +9255,11 @@ module Aws::RDS
9207
9255
  end
9208
9256
 
9209
9257
  # Lists all the subscription descriptions for a customer account. The
9210
- # description for a subscription includes SubscriptionName, SNSTopicARN,
9211
- # CustomerID, SourceType, SourceID, CreationTime, and Status.
9258
+ # description for a subscription includes `SubscriptionName`,
9259
+ # `SNSTopicARN`, `CustomerID`, `SourceType`, `SourceID`, `CreationTime`,
9260
+ # and `Status`.
9212
9261
  #
9213
- # If you specify a SubscriptionName, lists the description for that
9262
+ # If you specify a `SubscriptionName`, lists the description for that
9214
9263
  # subscription.
9215
9264
  #
9216
9265
  # @option params [String] :subscription_name
@@ -9296,11 +9345,12 @@ module Aws::RDS
9296
9345
  req.send_request(options)
9297
9346
  end
9298
9347
 
9299
- # Returns events related to DB instances, DB security groups, DB
9300
- # snapshots, and DB parameter groups for the past 14 days. Events
9301
- # specific to a particular DB instance, DB security group, database
9302
- # snapshot, or DB parameter group can be obtained by providing the name
9303
- # as a parameter. By default, the past hour of events are returned.
9348
+ # Returns events related to DB instances, DB clusters, DB parameter
9349
+ # groups, DB security groups, DB snapshots, and DB cluster snapshots for
9350
+ # the past 14 days. Events specific to a particular DB instances, DB
9351
+ # clusters, DB parameter groups, DB security groups, DB snapshots, and
9352
+ # DB cluster snapshots group can be obtained by providing the name as a
9353
+ # parameter. By default, the past hour of events are returned.
9304
9354
  #
9305
9355
  # @option params [String] :source_identifier
9306
9356
  # The identifier of the event source for which events are returned. If
@@ -9308,19 +9358,26 @@ module Aws::RDS
9308
9358
  #
9309
9359
  # Constraints:
9310
9360
  #
9311
- # * If SourceIdentifier is supplied, SourceType must also be provided.
9361
+ # * If `SourceIdentifier` is supplied, `SourceType` must also be
9362
+ # provided.
9312
9363
  #
9313
- # * If the source type is `DBInstance`, then a `DBInstanceIdentifier`
9364
+ # * If the source type is a DB instance, a `DBInstanceIdentifier` value
9314
9365
  # must be supplied.
9315
9366
  #
9316
- # * If the source type is `DBSecurityGroup`, a `DBSecurityGroupName`
9367
+ # * If the source type is a DB cluster, a `DBClusterIdentifier` value
9317
9368
  # must be supplied.
9318
9369
  #
9319
- # * If the source type is `DBParameterGroup`, a `DBParameterGroupName`
9370
+ # * If the source type is a DB parameter group, a `DBParameterGroupName`
9371
+ # value must be supplied.
9372
+ #
9373
+ # * If the source type is a DB security group, a `DBSecurityGroupName`
9374
+ # value must be supplied.
9375
+ #
9376
+ # * If the source type is a DB snapshot, a `DBSnapshotIdentifier` value
9320
9377
  # must be supplied.
9321
9378
  #
9322
- # * If the source type is `DBSnapshot`, a `DBSnapshotIdentifier` must be
9323
- # supplied.
9379
+ # * If the source type is a DB cluster snapshot, a
9380
+ # `DBClusterSnapshotIdentifier` value must be supplied.
9324
9381
  #
9325
9382
  # * Can't end with a hyphen or contain two consecutive hyphens.
9326
9383
  #
@@ -10064,6 +10121,7 @@ module Aws::RDS
10064
10121
  # resp.orderable_db_instance_options[0].supports_storage_autoscaling #=> Boolean
10065
10122
  # resp.orderable_db_instance_options[0].supports_kerberos_authentication #=> Boolean
10066
10123
  # resp.orderable_db_instance_options[0].outpost_capable #=> Boolean
10124
+ # resp.orderable_db_instance_options[0].supports_global_databases #=> Boolean
10067
10125
  # resp.marker #=> String
10068
10126
  #
10069
10127
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeOrderableDBInstanceOptions AWS API Documentation
@@ -11444,6 +11502,13 @@ module Aws::RDS
11444
11502
  # `none` to remove the cluster from its current domain. The domain must
11445
11503
  # be created prior to this operation.
11446
11504
  #
11505
+ # For more information, see [Kerberos Authentication][1] in the *Amazon
11506
+ # Aurora User Guide*.
11507
+ #
11508
+ #
11509
+ #
11510
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/kerberos-authentication.html
11511
+ #
11447
11512
  # @option params [String] :domain_iam_role_name
11448
11513
  # Specify the name of the IAM role to be used when making API calls to
11449
11514
  # the Directory Service.
@@ -12322,25 +12387,16 @@ module Aws::RDS
12322
12387
  # @option params [String] :domain
12323
12388
  # The Active Directory directory ID to move the DB instance to. Specify
12324
12389
  # `none` to remove the instance from its current domain. The domain must
12325
- # be created prior to this operation. Currently, only Microsoft SQL
12326
- # Server and Oracle DB instances can be created in an Active Directory
12327
- # Domain.
12328
- #
12329
- # For Microsoft SQL Server DB instances, Amazon RDS can use Windows
12330
- # Authentication to authenticate users that connect to the DB instance.
12331
- # For more information, see [ Using Windows Authentication with an
12332
- # Amazon RDS DB Instance Running Microsoft SQL Server][1] in the *Amazon
12333
- # RDS User Guide*.
12390
+ # be created prior to this operation. Currently, only MySQL, Microsoft
12391
+ # SQL Server, Oracle, and PostgreSQL DB instances can be created in an
12392
+ # Active Directory Domain.
12334
12393
  #
12335
- # For Oracle DB instances, Amazon RDS can use Kerberos authentication to
12336
- # authenticate users that connect to the DB instance. For more
12337
- # information, see [ Using Kerberos Authentication with Amazon RDS for
12338
- # Oracle][2] in the *Amazon RDS User Guide*.
12394
+ # For more information, see [ Kerberos Authentication][1] in the *Amazon
12395
+ # RDS User Guide*.
12339
12396
  #
12340
12397
  #
12341
12398
  #
12342
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
12343
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
12399
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
12344
12400
  #
12345
12401
  # @option params [Boolean] :copy_tags_to_snapshot
12346
12402
  # A value that indicates whether to copy all tags from the DB instance
@@ -12560,6 +12616,26 @@ module Aws::RDS
12560
12616
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL-certificate-rotation.html
12561
12617
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL-certificate-rotation.html
12562
12618
  #
12619
+ # @option params [String] :replica_mode
12620
+ # A value that sets the open mode of a replica database to either
12621
+ # mounted or read-only.
12622
+ #
12623
+ # <note markdown="1"> Currently, this parameter is only supported for Oracle DB instances.
12624
+ #
12625
+ # </note>
12626
+ #
12627
+ # Mounted DB replicas are included in Oracle Enterprise Edition. The
12628
+ # main use case for mounted replicas is cross-Region disaster recovery.
12629
+ # The primary database doesn't use Active Data Guard to transmit
12630
+ # information to the mounted replica. Because it doesn't accept user
12631
+ # connections, a mounted replica can't serve a read-only workload. For
12632
+ # more information, see [Working with Oracle Read Replicas for Amazon
12633
+ # RDS][1] in the *Amazon RDS User Guide*.
12634
+ #
12635
+ #
12636
+ #
12637
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
12638
+ #
12563
12639
  # @return [Types::ModifyDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
12564
12640
  #
12565
12641
  # * {Types::ModifyDBInstanceResult#db_instance #db_instance} => Types::DBInstance
@@ -12639,6 +12715,7 @@ module Aws::RDS
12639
12715
  # deletion_protection: false,
12640
12716
  # max_allocated_storage: 1,
12641
12717
  # certificate_rotation_restart: false,
12718
+ # replica_mode: "open-read-only", # accepts open-read-only, mounted
12642
12719
  # })
12643
12720
  #
12644
12721
  # @example Response structure
@@ -12706,6 +12783,7 @@ module Aws::RDS
12706
12783
  # resp.db_instance.read_replica_db_instance_identifiers[0] #=> String
12707
12784
  # resp.db_instance.read_replica_db_cluster_identifiers #=> Array
12708
12785
  # resp.db_instance.read_replica_db_cluster_identifiers[0] #=> String
12786
+ # resp.db_instance.replica_mode #=> String, one of "open-read-only", "mounted"
12709
12787
  # resp.db_instance.license_model #=> String
12710
12788
  # resp.db_instance.iops #=> Integer
12711
12789
  # resp.db_instance.option_group_memberships #=> Array
@@ -13328,9 +13406,9 @@ module Aws::RDS
13328
13406
  # `AddSourceIdentifierToSubscription` and
13329
13407
  # `RemoveSourceIdentifierFromSubscription` calls.
13330
13408
  #
13331
- # You can see a list of the event categories for a given SourceType in
13332
- # the [Events][1] topic in the *Amazon RDS User Guide* or by using the
13333
- # **DescribeEventCategories** action.
13409
+ # You can see a list of the event categories for a given source type
13410
+ # (`SourceType`) in [Events][1] in the *Amazon RDS User Guide* or by
13411
+ # using the `DescribeEventCategories` operation.
13334
13412
  #
13335
13413
  #
13336
13414
  #
@@ -13350,14 +13428,14 @@ module Aws::RDS
13350
13428
  # set this parameter to db-instance. If this value isn't specified, all
13351
13429
  # events are returned.
13352
13430
  #
13353
- # Valid values: db-instance \| db-parameter-group \| db-security-group
13354
- # \| db-snapshot
13431
+ # Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group` \|
13432
+ # `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
13355
13433
  #
13356
13434
  # @option params [Array<String>] :event_categories
13357
- # A list of event categories for a SourceType that you want to subscribe
13358
- # to. You can see a list of the categories for a given SourceType in the
13359
- # [Events][1] topic in the *Amazon RDS User Guide* or by using the
13360
- # **DescribeEventCategories** action.
13435
+ # A list of event categories for a source type (`SourceType`) that you
13436
+ # want to subscribe to. You can see a list of the categories for a given
13437
+ # source type in [Events][1] in the *Amazon RDS User Guide* or by using
13438
+ # the `DescribeEventCategories` operation.
13361
13439
  #
13362
13440
  #
13363
13441
  #
@@ -13789,6 +13867,7 @@ module Aws::RDS
13789
13867
  # resp.db_instance.read_replica_db_instance_identifiers[0] #=> String
13790
13868
  # resp.db_instance.read_replica_db_cluster_identifiers #=> Array
13791
13869
  # resp.db_instance.read_replica_db_cluster_identifiers[0] #=> String
13870
+ # resp.db_instance.replica_mode #=> String, one of "open-read-only", "mounted"
13792
13871
  # resp.db_instance.license_model #=> String
13793
13872
  # resp.db_instance.iops #=> Integer
13794
13873
  # resp.db_instance.option_group_memberships #=> Array
@@ -14181,6 +14260,7 @@ module Aws::RDS
14181
14260
  # resp.db_instance.read_replica_db_instance_identifiers[0] #=> String
14182
14261
  # resp.db_instance.read_replica_db_cluster_identifiers #=> Array
14183
14262
  # resp.db_instance.read_replica_db_cluster_identifiers[0] #=> String
14263
+ # resp.db_instance.replica_mode #=> String, one of "open-read-only", "mounted"
14184
14264
  # resp.db_instance.license_model #=> String
14185
14265
  # resp.db_instance.iops #=> Integer
14186
14266
  # resp.db_instance.option_group_memberships #=> Array
@@ -14736,11 +14816,11 @@ module Aws::RDS
14736
14816
  req.send_request(options)
14737
14817
  end
14738
14818
 
14739
- # Creates an Amazon Aurora DB cluster from data stored in an Amazon S3
14740
- # bucket. Amazon RDS must be authorized to access the Amazon S3 bucket
14741
- # and the data must be created using the Percona XtraBackup utility as
14742
- # described in [ Migrating Data to an Amazon Aurora MySQL DB Cluster][1]
14743
- # in the *Amazon Aurora User Guide*.
14819
+ # Creates an Amazon Aurora DB cluster from MySQL data stored in an
14820
+ # Amazon S3 bucket. Amazon RDS must be authorized to access the Amazon
14821
+ # S3 bucket and the data must be created using the Percona XtraBackup
14822
+ # utility as described in [ Migrating Data from MySQL by Using an Amazon
14823
+ # S3 Bucket][1] in the *Amazon Aurora User Guide*.
14744
14824
  #
14745
14825
  # <note markdown="1"> This action only restores the DB cluster, not the DB instances for
14746
14826
  # that DB cluster. You must invoke the `CreateDBInstance` action to
@@ -14754,13 +14834,14 @@ module Aws::RDS
14754
14834
  # For more information on Amazon Aurora, see [ What Is Amazon
14755
14835
  # Aurora?][2] in the *Amazon Aurora User Guide.*
14756
14836
  #
14757
- # <note markdown="1"> This action only applies to Aurora DB clusters.
14837
+ # <note markdown="1"> This action only applies to Aurora DB clusters. The source DB engine
14838
+ # must be MySQL.
14758
14839
  #
14759
14840
  # </note>
14760
14841
  #
14761
14842
  #
14762
14843
  #
14763
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Migrating.html
14844
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Migrating.ExtMySQL.html#AuroraMySQL.Migrating.ExtMySQL.S3
14764
14845
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
14765
14846
  #
14766
14847
  # @option params [Array<String>] :availability_zones
@@ -14825,10 +14906,11 @@ module Aws::RDS
14825
14906
  # Example: `mySubnetgroup`
14826
14907
  #
14827
14908
  # @option params [required, String] :engine
14828
- # The name of the database engine to be used for the restored DB
14829
- # cluster.
14909
+ # The name of the database engine to be used for this DB cluster.
14830
14910
  #
14831
- # Valid Values: `aurora`, `aurora-postgresql`
14911
+ # Valid Values: `aurora` (for MySQL 5.6-compatible Aurora),
14912
+ # `aurora-mysql` (for MySQL 5.7-compatible Aurora), and
14913
+ # `aurora-postgresql`
14832
14914
  #
14833
14915
  # @option params [String] :engine_version
14834
14916
  # The version number of the database engine to use.
@@ -14983,7 +15065,7 @@ module Aws::RDS
14983
15065
  #
14984
15066
  # MySQL versions 5.5, 5.6, and 5.7 are supported.
14985
15067
  #
14986
- # Example: `5.6.40`
15068
+ # Example: `5.6.40`, `5.7.28`
14987
15069
  #
14988
15070
  # @option params [required, String] :s3_bucket_name
14989
15071
  # The name of the Amazon S3 bucket that contains the data used to create
@@ -15411,7 +15493,16 @@ module Aws::RDS
15411
15493
  #
15412
15494
  # @option params [String] :domain
15413
15495
  # Specify the Active Directory directory ID to restore the DB cluster
15414
- # in. The domain must be created prior to this operation.
15496
+ # in. The domain must be created prior to this operation. Currently,
15497
+ # only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances
15498
+ # can be created in an Active Directory Domain.
15499
+ #
15500
+ # For more information, see [ Kerberos Authentication][1] in the *Amazon
15501
+ # RDS User Guide*.
15502
+ #
15503
+ #
15504
+ #
15505
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
15415
15506
  #
15416
15507
  # @option params [String] :domain_iam_role_name
15417
15508
  # Specify the name of the IAM role to be used when making API calls to
@@ -16161,24 +16252,15 @@ module Aws::RDS
16161
16252
  # @option params [String] :domain
16162
16253
  # Specify the Active Directory directory ID to restore the DB instance
16163
16254
  # in. The domain must be created prior to this operation. Currently,
16164
- # only Microsoft SQL Server and Oracle DB instances can be created in an
16165
- # Active Directory Domain.
16255
+ # only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances
16256
+ # can be created in an Active Directory Domain.
16166
16257
  #
16167
- # For Microsoft SQL Server DB instances, Amazon RDS can use Windows
16168
- # Authentication to authenticate users that connect to the DB instance.
16169
- # For more information, see [ Using Windows Authentication with an
16170
- # Amazon RDS DB Instance Running Microsoft SQL Server][1] in the *Amazon
16258
+ # For more information, see [ Kerberos Authentication][1] in the *Amazon
16171
16259
  # RDS User Guide*.
16172
16260
  #
16173
- # For Oracle DB instances, Amazon RDS can use Kerberos authentication to
16174
- # authenticate users that connect to the DB instance. For more
16175
- # information, see [ Using Kerberos Authentication with Amazon RDS for
16176
- # Oracle][2] in the *Amazon RDS User Guide*.
16177
- #
16178
16261
  #
16179
16262
  #
16180
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
16181
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
16263
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
16182
16264
  #
16183
16265
  # @option params [Boolean] :copy_tags_to_snapshot
16184
16266
  # A value that indicates whether to copy all tags from the restored DB
@@ -16454,6 +16536,7 @@ module Aws::RDS
16454
16536
  # resp.db_instance.read_replica_db_instance_identifiers[0] #=> String
16455
16537
  # resp.db_instance.read_replica_db_cluster_identifiers #=> Array
16456
16538
  # resp.db_instance.read_replica_db_cluster_identifiers[0] #=> String
16539
+ # resp.db_instance.replica_mode #=> String, one of "open-read-only", "mounted"
16457
16540
  # resp.db_instance.license_model #=> String
16458
16541
  # resp.db_instance.iops #=> Integer
16459
16542
  # resp.db_instance.option_group_memberships #=> Array
@@ -17012,6 +17095,7 @@ module Aws::RDS
17012
17095
  # resp.db_instance.read_replica_db_instance_identifiers[0] #=> String
17013
17096
  # resp.db_instance.read_replica_db_cluster_identifiers #=> Array
17014
17097
  # resp.db_instance.read_replica_db_cluster_identifiers[0] #=> String
17098
+ # resp.db_instance.replica_mode #=> String, one of "open-read-only", "mounted"
17015
17099
  # resp.db_instance.license_model #=> String
17016
17100
  # resp.db_instance.iops #=> Integer
17017
17101
  # resp.db_instance.option_group_memberships #=> Array
@@ -17304,24 +17388,15 @@ module Aws::RDS
17304
17388
  # @option params [String] :domain
17305
17389
  # Specify the Active Directory directory ID to restore the DB instance
17306
17390
  # in. The domain must be created prior to this operation. Currently,
17307
- # only Microsoft SQL Server and Oracle DB instances can be created in an
17308
- # Active Directory Domain.
17391
+ # only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances
17392
+ # can be created in an Active Directory Domain.
17309
17393
  #
17310
- # For Microsoft SQL Server DB instances, Amazon RDS can use Windows
17311
- # Authentication to authenticate users that connect to the DB instance.
17312
- # For more information, see [ Using Windows Authentication with an
17313
- # Amazon RDS DB Instance Running Microsoft SQL Server][1] in the *Amazon
17394
+ # For more information, see [ Kerberos Authentication][1] in the *Amazon
17314
17395
  # RDS User Guide*.
17315
17396
  #
17316
- # For Oracle DB instances, Amazon RDS can use Kerberos authentication to
17317
- # authenticate users that connect to the DB instance. For more
17318
- # information, see [ Using Kerberos Authentication with Amazon RDS for
17319
- # Oracle][2] in the *Amazon RDS User Guide*.
17320
- #
17321
17397
  #
17322
17398
  #
17323
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
17324
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
17399
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
17325
17400
  #
17326
17401
  # @option params [String] :domain_iam_role_name
17327
17402
  # Specify the name of the IAM role to be used when making API calls to
@@ -17599,6 +17674,7 @@ module Aws::RDS
17599
17674
  # resp.db_instance.read_replica_db_instance_identifiers[0] #=> String
17600
17675
  # resp.db_instance.read_replica_db_cluster_identifiers #=> Array
17601
17676
  # resp.db_instance.read_replica_db_cluster_identifiers[0] #=> String
17677
+ # resp.db_instance.replica_mode #=> String, one of "open-read-only", "mounted"
17602
17678
  # resp.db_instance.license_model #=> String
17603
17679
  # resp.db_instance.iops #=> Integer
17604
17680
  # resp.db_instance.option_group_memberships #=> Array
@@ -18023,6 +18099,7 @@ module Aws::RDS
18023
18099
  # resp.db_instance.read_replica_db_instance_identifiers[0] #=> String
18024
18100
  # resp.db_instance.read_replica_db_cluster_identifiers #=> Array
18025
18101
  # resp.db_instance.read_replica_db_cluster_identifiers[0] #=> String
18102
+ # resp.db_instance.replica_mode #=> String, one of "open-read-only", "mounted"
18026
18103
  # resp.db_instance.license_model #=> String
18027
18104
  # resp.db_instance.iops #=> Integer
18028
18105
  # resp.db_instance.option_group_memberships #=> Array
@@ -18106,8 +18183,26 @@ module Aws::RDS
18106
18183
  # The ID of the AWS KMS key to use to encrypt the snapshot exported to
18107
18184
  # Amazon S3. The KMS key ID is the Amazon Resource Name (ARN), the KMS
18108
18185
  # key identifier, or the KMS key alias for the KMS encryption key. The
18109
- # IAM role used for the snapshot export must have encryption and
18110
- # decryption permissions to use this KMS key.
18186
+ # caller of this operation must be authorized to execute the following
18187
+ # operations. These can be set in the KMS key policy:
18188
+ #
18189
+ # * GrantOperation.Encrypt
18190
+ #
18191
+ # * GrantOperation.Decrypt
18192
+ #
18193
+ # * GrantOperation.GenerateDataKey
18194
+ #
18195
+ # * GrantOperation.GenerateDataKeyWithoutPlaintext
18196
+ #
18197
+ # * GrantOperation.ReEncryptFrom
18198
+ #
18199
+ # * GrantOperation.ReEncryptTo
18200
+ #
18201
+ # * GrantOperation.CreateGrant
18202
+ #
18203
+ # * GrantOperation.DescribeKey
18204
+ #
18205
+ # * GrantOperation.RetireGrant
18111
18206
  #
18112
18207
  # @option params [String] :s3_prefix
18113
18208
  # The Amazon S3 bucket prefix to use as the file name and path of the
@@ -18459,6 +18554,7 @@ module Aws::RDS
18459
18554
  # resp.db_instance.read_replica_db_instance_identifiers[0] #=> String
18460
18555
  # resp.db_instance.read_replica_db_cluster_identifiers #=> Array
18461
18556
  # resp.db_instance.read_replica_db_cluster_identifiers[0] #=> String
18557
+ # resp.db_instance.replica_mode #=> String, one of "open-read-only", "mounted"
18462
18558
  # resp.db_instance.license_model #=> String
18463
18559
  # resp.db_instance.iops #=> Integer
18464
18560
  # resp.db_instance.option_group_memberships #=> Array
@@ -18533,7 +18629,7 @@ module Aws::RDS
18533
18629
  params: params,
18534
18630
  config: config)
18535
18631
  context[:gem_name] = 'aws-sdk-rds'
18536
- context[:gem_version] = '1.93.0'
18632
+ context[:gem_version] = '1.98.0'
18537
18633
  Seahorse::Client::Request.new(handlers, context)
18538
18634
  end
18539
18635