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.
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