aws-sdk-rds 1.119.0 → 1.123.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.
@@ -238,11 +238,11 @@ module Aws::RDS
238
238
  #
239
239
  # * `oracle-ee`
240
240
  #
241
- # * `oracle-se2`
241
+ # * `oracle-ee-cdb`
242
242
  #
243
- # * `oracle-se1`
243
+ # * `oracle-se2`
244
244
  #
245
- # * `oracle-se`
245
+ # * `oracle-se2-cdb`
246
246
  #
247
247
  # * `postgres`
248
248
  #
@@ -35,7 +35,8 @@ module Aws::RDS
35
35
  end
36
36
  alias :db_security_group_name :name
37
37
 
38
- # Provides the AWS ID of the owner of a specific DB security group.
38
+ # Provides the Amazon Web Services ID of the owner of a specific DB
39
+ # security group.
39
40
  # @return [String]
40
41
  def owner_id
41
42
  data[:owner_id]
@@ -227,11 +228,12 @@ module Aws::RDS
227
228
  # `EC2SecurityGroupOwnerId` and either `EC2SecurityGroupName` or
228
229
  # `EC2SecurityGroupId` must be provided.
229
230
  # @option options [String] :ec2_security_group_owner_id
230
- # AWS account number of the owner of the EC2 security group specified in
231
- # the `EC2SecurityGroupName` parameter. The AWS access key ID isn't an
232
- # acceptable value. For VPC DB security groups, `EC2SecurityGroupId`
233
- # must be provided. Otherwise, `EC2SecurityGroupOwnerId` and either
234
- # `EC2SecurityGroupName` or `EC2SecurityGroupId` must be provided.
231
+ # Amazon Web Services account number of the owner of the EC2 security
232
+ # group specified in the `EC2SecurityGroupName` parameter. The Amazon
233
+ # Web Services access key ID isn't an acceptable value. For VPC DB
234
+ # security groups, `EC2SecurityGroupId` must be provided. Otherwise,
235
+ # `EC2SecurityGroupOwnerId` and either `EC2SecurityGroupName` or
236
+ # `EC2SecurityGroupId` must be provided.
235
237
  # @return [DBSecurityGroup]
236
238
  def authorize_ingress(options = {})
237
239
  options = options.merge(db_security_group_name: @name)
@@ -305,10 +307,10 @@ module Aws::RDS
305
307
  # EC2SecurityGroupOwnerId and either `EC2SecurityGroupName` or
306
308
  # `EC2SecurityGroupId` must be provided.
307
309
  # @option options [String] :ec2_security_group_owner_id
308
- # The AWS account number of the owner of the EC2 security group
309
- # specified in the `EC2SecurityGroupName` parameter. The AWS access key
310
- # ID isn't an acceptable value. For VPC DB security groups,
311
- # `EC2SecurityGroupId` must be provided. Otherwise,
310
+ # The Amazon Web Services account number of the owner of the EC2
311
+ # security group specified in the `EC2SecurityGroupName` parameter. The
312
+ # Amazon Web Services access key ID isn't an acceptable value. For VPC
313
+ # DB security groups, `EC2SecurityGroupId` must be provided. Otherwise,
312
314
  # EC2SecurityGroupOwnerId and either `EC2SecurityGroupName` or
313
315
  # `EC2SecurityGroupId` must be provided.
314
316
  # @return [DBSecurityGroup]
@@ -45,7 +45,7 @@ module Aws::RDS
45
45
  alias :db_snapshot_identifier :snapshot_id
46
46
 
47
47
  # Specifies when the snapshot was taken in Coordinated Universal Time
48
- # (UTC).
48
+ # (UTC). Changes for the copy when the snapshot is copied.
49
49
  # @return [Time]
50
50
  def snapshot_create_time
51
51
  data[:snapshot_create_time]
@@ -139,15 +139,16 @@ module Aws::RDS
139
139
  data[:percent_progress]
140
140
  end
141
141
 
142
- # The AWS Region that the DB snapshot was created in or copied from.
142
+ # The Amazon Web Services Region that the DB snapshot was created in or
143
+ # copied from.
143
144
  # @return [String]
144
145
  def source_region
145
146
  data[:source_region]
146
147
  end
147
148
 
148
149
  # The DB snapshot Amazon Resource Name (ARN) that the DB snapshot was
149
- # copied from. It only has value in case of cross-customer or
150
- # cross-region copy.
150
+ # copied from. It only has a value in the case of a cross-account or
151
+ # cross-Region copy.
151
152
  # @return [String]
152
153
  def source_db_snapshot_identifier
153
154
  data[:source_db_snapshot_identifier]
@@ -172,11 +173,12 @@ module Aws::RDS
172
173
  data[:encrypted]
173
174
  end
174
175
 
175
- # If `Encrypted` is true, the AWS KMS key identifier for the encrypted
176
- # DB snapshot.
176
+ # If `Encrypted` is true, the Amazon Web Services KMS key identifier for
177
+ # the encrypted DB snapshot.
177
178
  #
178
- # The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias
179
- # name for the AWS KMS customer master key (CMK).
179
+ # The Amazon Web Services KMS key identifier is the key ARN, key ID,
180
+ # alias ARN, or alias name for the Amazon Web Services KMS customer
181
+ # master key (CMK).
180
182
  # @return [String]
181
183
  def kms_key_id
182
184
  data[:kms_key_id]
@@ -197,8 +199,8 @@ module Aws::RDS
197
199
  data[:timezone]
198
200
  end
199
201
 
200
- # True if mapping of AWS Identity and Access Management (IAM) accounts
201
- # to database accounts is enabled, and otherwise false.
202
+ # True if mapping of Amazon Web Services Identity and Access Management
203
+ # (IAM) accounts to database accounts is enabled, and otherwise false.
202
204
  # @return [Boolean]
203
205
  def iam_database_authentication_enabled
204
206
  data[:iam_database_authentication_enabled]
@@ -212,7 +214,7 @@ module Aws::RDS
212
214
  end
213
215
 
214
216
  # The identifier for the source DB instance, which can't be changed and
215
- # which is unique to an AWS Region.
217
+ # which is unique to an Amazon Web Services Region.
216
218
  # @return [String]
217
219
  def dbi_resource_id
218
220
  data[:dbi_resource_id]
@@ -229,6 +231,13 @@ module Aws::RDS
229
231
  data[:tag_list]
230
232
  end
231
233
 
234
+ # Specifies the time of the CreateDBSnapshot operation in Coordinated
235
+ # Universal Time (UTC). Doesn't change when the snapshot is copied.
236
+ # @return [Time]
237
+ def original_snapshot_create_time
238
+ data[:original_snapshot_create_time]
239
+ end
240
+
232
241
  # @!endgroup
233
242
 
234
243
  # @return [Client]
@@ -429,26 +438,31 @@ module Aws::RDS
429
438
  #
430
439
  # Example: `my-db-snapshot`
431
440
  # @option options [String] :kms_key_id
432
- # The AWS KMS key identifier for an encrypted DB snapshot. The AWS KMS
433
- # key identifier is the key ARN, key ID, alias ARN, or alias name for
434
- # the AWS KMS customer master key (CMK).
435
- #
436
- # If you copy an encrypted DB snapshot from your AWS account, you can
437
- # specify a value for this parameter to encrypt the copy with a new AWS
438
- # KMS CMK. If you don't specify a value for this parameter, then the
439
- # copy of the DB snapshot is encrypted with the same AWS KMS key as the
440
- # source DB snapshot.
441
+ # The Amazon Web Services KMS key identifier for an encrypted DB
442
+ # snapshot. The Amazon Web Services KMS key identifier is the key ARN,
443
+ # key ID, alias ARN, or alias name for the Amazon Web Services KMS
444
+ # customer master key (CMK).
445
+ #
446
+ # If you copy an encrypted DB snapshot from your Amazon Web Services
447
+ # account, you can specify a value for this parameter to encrypt the
448
+ # copy with a new Amazon Web Services KMS CMK. If you don't specify a
449
+ # value for this parameter, then the copy of the DB snapshot is
450
+ # encrypted with the same Amazon Web Services KMS key as the source DB
451
+ # snapshot.
441
452
  #
442
- # If you copy an encrypted DB snapshot that is shared from another AWS
443
- # account, then you must specify a value for this parameter.
453
+ # If you copy an encrypted DB snapshot that is shared from another
454
+ # Amazon Web Services account, then you must specify a value for this
455
+ # parameter.
444
456
  #
445
457
  # If you specify this parameter when you copy an unencrypted snapshot,
446
458
  # the copy is encrypted.
447
459
  #
448
- # If you copy an encrypted snapshot to a different AWS Region, then you
449
- # must specify a AWS KMS key identifier for the destination AWS Region.
450
- # AWS KMS CMKs are specific to the AWS Region that they are created in,
451
- # and you can't use CMKs from one AWS Region in another AWS Region.
460
+ # If you copy an encrypted snapshot to a different Amazon Web Services
461
+ # Region, then you must specify a Amazon Web Services KMS key identifier
462
+ # for the destination Amazon Web Services Region. Amazon Web Services
463
+ # KMS CMKs are specific to the Amazon Web Services Region that they are
464
+ # created in, and you can't use CMKs from one Amazon Web Services
465
+ # Region in another Amazon Web Services Region.
452
466
  # @option options [Array<Types::Tag>] :tags
453
467
  # A list of tags. For more information, see [Tagging Amazon RDS
454
468
  # Resources][1] in the *Amazon RDS User Guide.*
@@ -461,53 +475,58 @@ module Aws::RDS
461
475
  # snapshot to the target DB snapshot. By default, tags are not copied.
462
476
  # @option options [String] :pre_signed_url
463
477
  # The URL that contains a Signature Version 4 signed request for the
464
- # `CopyDBSnapshot` API action in the source AWS Region that contains the
465
- # source DB snapshot to copy.
478
+ # `CopyDBSnapshot` API action in the source Amazon Web Services Region
479
+ # that contains the source DB snapshot to copy.
466
480
  #
467
481
  # You must specify this parameter when you copy an encrypted DB snapshot
468
- # from another AWS Region by using the Amazon RDS API. Don't specify
469
- # `PreSignedUrl` when you are copying an encrypted DB snapshot in the
470
- # same AWS Region.
482
+ # from another Amazon Web Services Region by using the Amazon RDS API.
483
+ # Don't specify `PreSignedUrl` when you are copying an encrypted DB
484
+ # snapshot in the same Amazon Web Services Region.
471
485
  #
472
486
  # The presigned URL must be a valid request for the `CopyDBSnapshot` API
473
- # action that can be executed in the source AWS Region that contains the
474
- # encrypted DB snapshot to be copied. The presigned URL request must
475
- # contain the following parameter values:
487
+ # action that can be executed in the source Amazon Web Services Region
488
+ # that contains the encrypted DB snapshot to be copied. The presigned
489
+ # URL request must contain the following parameter values:
476
490
  #
477
- # * `DestinationRegion` - The AWS Region that the encrypted DB snapshot
478
- # is copied to. This AWS Region is the same one where the
479
- # `CopyDBSnapshot` action is called that contains this presigned URL.
491
+ # * `DestinationRegion` - The Amazon Web Services Region that the
492
+ # encrypted DB snapshot is copied to. This Amazon Web Services Region
493
+ # is the same one where the `CopyDBSnapshot` action is called that
494
+ # contains this presigned URL.
480
495
  #
481
496
  # For example, if you copy an encrypted DB snapshot from the us-west-2
482
- # AWS Region to the us-east-1 AWS Region, then you call the
483
- # `CopyDBSnapshot` action in the us-east-1 AWS Region and provide a
484
- # presigned URL that contains a call to the `CopyDBSnapshot` action in
485
- # the us-west-2 AWS Region. For this example, the `DestinationRegion`
486
- # in the presigned URL must be set to the us-east-1 AWS Region.
487
- #
488
- # * `KmsKeyId` - The AWS KMS key identifier for the customer master key
489
- # (CMK) to use to encrypt the copy of the DB snapshot in the
490
- # destination AWS Region. This is the same identifier for both the
491
- # `CopyDBSnapshot` action that is called in the destination AWS
492
- # Region, and the action contained in the presigned URL.
497
+ # Amazon Web Services Region to the us-east-1 Amazon Web Services
498
+ # Region, then you call the `CopyDBSnapshot` action in the us-east-1
499
+ # Amazon Web Services Region and provide a presigned URL that contains
500
+ # a call to the `CopyDBSnapshot` action in the us-west-2 Amazon Web
501
+ # Services Region. For this example, the `DestinationRegion` in the
502
+ # presigned URL must be set to the us-east-1 Amazon Web Services
503
+ # Region.
504
+ #
505
+ # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the
506
+ # customer master key (CMK) to use to encrypt the copy of the DB
507
+ # snapshot in the destination Amazon Web Services Region. This is the
508
+ # same identifier for both the `CopyDBSnapshot` action that is called
509
+ # in the destination Amazon Web Services Region, and the action
510
+ # contained in the presigned URL.
493
511
  #
494
512
  # * `SourceDBSnapshotIdentifier` - The DB snapshot identifier for the
495
513
  # encrypted snapshot to be copied. This identifier must be in the
496
- # Amazon Resource Name (ARN) format for the source AWS Region. For
497
- # example, if you are copying an encrypted DB snapshot from the
498
- # us-west-2 AWS Region, then your `SourceDBSnapshotIdentifier` looks
499
- # like the following example:
514
+ # Amazon Resource Name (ARN) format for the source Amazon Web Services
515
+ # Region. For example, if you are copying an encrypted DB snapshot
516
+ # from the us-west-2 Amazon Web Services Region, then your
517
+ # `SourceDBSnapshotIdentifier` looks like the following example:
500
518
  # `arn:aws:rds:us-west-2:123456789012:snapshot:mysql-instance1-snapshot-20161115`.
501
519
  #
502
520
  # To learn how to generate a Signature Version 4 signed request, see
503
- # [Authenticating Requests: Using Query Parameters (AWS Signature
504
- # Version 4)][1] and [Signature Version 4 Signing Process][2].
521
+ # [Authenticating Requests: Using Query Parameters (Amazon Web Services
522
+ # Signature Version 4)][1] and [Signature Version 4 Signing Process][2].
505
523
  #
506
- # <note markdown="1"> If you are using an AWS SDK tool or the AWS CLI, you can specify
507
- # `SourceRegion` (or `--source-region` for the AWS CLI) instead of
524
+ # <note markdown="1"> If you are using an Amazon Web Services SDK tool or the CLI, you can
525
+ # specify `SourceRegion` (or `--source-region` for the CLI) instead of
508
526
  # specifying `PreSignedUrl` manually. Specifying `SourceRegion`
509
527
  # autogenerates a pre-signed URL that is a valid request for the
510
- # operation that can be executed in the source AWS Region.
528
+ # operation that can be executed in the source Amazon Web Services
529
+ # Region.
511
530
  #
512
531
  # </note>
513
532
  #
@@ -519,12 +538,13 @@ module Aws::RDS
519
538
  # The name of an option group to associate with the copy of the
520
539
  # snapshot.
521
540
  #
522
- # Specify this option if you are copying a snapshot from one AWS Region
523
- # to another, and your DB instance uses a nondefault option group. If
524
- # your source DB instance uses Transparent Data Encryption for Oracle or
525
- # Microsoft SQL Server, you must specify this option when copying across
526
- # AWS Regions. For more information, see [Option group
527
- # considerations][1] in the *Amazon RDS User Guide.*
541
+ # Specify this option if you are copying a snapshot from one Amazon Web
542
+ # Services Region to another, and your DB instance uses a nondefault
543
+ # option group. If your source DB instance uses Transparent Data
544
+ # Encryption for Oracle or Microsoft SQL Server, you must specify this
545
+ # option when copying across Amazon Web Services Regions. For more
546
+ # information, see [Option group considerations][1] in the *Amazon RDS
547
+ # User Guide.*
528
548
  #
529
549
  #
530
550
  #
@@ -624,9 +644,9 @@ module Aws::RDS
624
644
  # @option options [String] :db_instance_class
625
645
  # The compute and memory capacity of the Amazon RDS DB instance, for
626
646
  # example, `db.m4.large`. Not all DB instance classes are available in
627
- # all AWS Regions, or for all database engines. For the full list of DB
628
- # instance classes, and availability for your engine, see [DB Instance
629
- # Class][1] in the *Amazon RDS User Guide.*
647
+ # all Amazon Web Services Regions, or for all database engines. For the
648
+ # full list of DB instance classes, and availability for your engine,
649
+ # see [DB Instance Class][1] in the *Amazon RDS User Guide.*
630
650
  #
631
651
  # Default: The same DBInstanceClass as the original DB instance.
632
652
  #
@@ -709,11 +729,11 @@ module Aws::RDS
709
729
  #
710
730
  # * `oracle-ee`
711
731
  #
712
- # * `oracle-se2`
732
+ # * `oracle-ee-cdb`
713
733
  #
714
- # * `oracle-se1`
734
+ # * `oracle-se2`
715
735
  #
716
- # * `oracle-se`
736
+ # * `oracle-se2-cdb`
717
737
  #
718
738
  # * `postgres`
719
739
  #
@@ -796,9 +816,9 @@ module Aws::RDS
796
816
  # Specify the name of the IAM role to be used when making API calls to
797
817
  # the Directory Service.
798
818
  # @option options [Boolean] :enable_iam_database_authentication
799
- # A value that indicates whether to enable mapping of AWS Identity and
800
- # Access Management (IAM) accounts to database accounts. By default,
801
- # mapping is disabled.
819
+ # A value that indicates whether to enable mapping of Amazon Web
820
+ # Services Identity and Access Management (IAM) accounts to database
821
+ # accounts. By default, mapping is disabled.
802
822
  #
803
823
  # For more information about IAM database authentication, see [ IAM
804
824
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
@@ -856,10 +876,11 @@ module Aws::RDS
856
876
  # from outside of its virtual private cloud (VPC) on your local network.
857
877
  #
858
878
  # For more information about RDS on Outposts, see [Working with Amazon
859
- # RDS on AWS Outposts][1] in the *Amazon RDS User Guide*.
879
+ # RDS on Amazon Web Services Outposts][1] in the *Amazon RDS User
880
+ # Guide*.
860
881
  #
861
882
  # For more information about CoIPs, see [Customer-owned IP addresses][2]
862
- # in the *AWS Outposts User Guide*.
883
+ # in the *Amazon Web Services Outposts User Guide*.
863
884
  #
864
885
  #
865
886
  #
@@ -46,10 +46,10 @@ module Aws::RDS
46
46
  # The value or values for the manual DB snapshot attribute.
47
47
  #
48
48
  # If the `AttributeName` field is set to `restore`, then this element
49
- # returns a list of IDs of the AWS accounts that are authorized to copy
50
- # or restore the manual DB snapshot. If a value of `all` is in the list,
51
- # then the manual DB snapshot is public and available for any AWS
52
- # account to copy or restore.
49
+ # returns a list of IDs of the Amazon Web Services accounts that are
50
+ # authorized to copy or restore the manual DB snapshot. If a value of
51
+ # `all` is in the list, then the manual DB snapshot is public and
52
+ # available for any Amazon Web Services account to copy or restore.
53
53
  # @return [Array<String>]
54
54
  def attribute_values
55
55
  data[:attribute_values]
@@ -195,19 +195,21 @@ module Aws::RDS
195
195
  # A list of DB snapshot attributes to add to the attribute specified by
196
196
  # `AttributeName`.
197
197
  #
198
- # To authorize other AWS accounts to copy or restore a manual snapshot,
199
- # set this list to include one or more AWS account IDs, or `all` to make
200
- # the manual DB snapshot restorable by any AWS account. Do not add the
201
- # `all` value for any manual DB snapshots that contain private
202
- # information that you don't want available to all AWS accounts.
198
+ # To authorize other Amazon Web Services accounts to copy or restore a
199
+ # manual snapshot, set this list to include one or more Amazon Web
200
+ # Services account IDs, or `all` to make the manual DB snapshot
201
+ # restorable by any Amazon Web Services account. Do not add the `all`
202
+ # value for any manual DB snapshots that contain private information
203
+ # that you don't want available to all Amazon Web Services accounts.
203
204
  # @option options [Array<String>] :values_to_remove
204
205
  # A list of DB snapshot attributes to remove from the attribute
205
206
  # specified by `AttributeName`.
206
207
  #
207
- # To remove authorization for other AWS accounts to copy or restore a
208
- # manual snapshot, set this list to include one or more AWS account
209
- # identifiers, or `all` to remove authorization for any AWS account to
210
- # copy or restore the DB snapshot. If you specify `all`, an AWS account
208
+ # To remove authorization for other Amazon Web Services accounts to copy
209
+ # or restore a manual snapshot, set this list to include one or more
210
+ # Amazon Web Services account identifiers, or `all` to remove
211
+ # authorization for any Amazon Web Services account to copy or restore
212
+ # the DB snapshot. If you specify `all`, an Amazon Web Services account
211
213
  # whose account ID is explicitly added to the `restore` attribute can
212
214
  # still copy or restore the manual DB snapshot.
213
215
  # @return [Types::ModifyDBSnapshotAttributeResult]
@@ -35,8 +35,8 @@ module Aws::RDS
35
35
  end
36
36
  alias :cust_subscription_id :name
37
37
 
38
- # The AWS customer account associated with the RDS event notification
39
- # subscription.
38
+ # The Amazon Web Services customer account associated with the RDS event
39
+ # notification subscription.
40
40
  # @return [String]
41
41
  def customer_aws_id
42
42
  data[:customer_aws_id]
@@ -245,11 +245,11 @@ module Aws::RDS
245
245
  #
246
246
  # * `oracle-ee`
247
247
  #
248
- # * `oracle-se2`
248
+ # * `oracle-ee-cdb`
249
249
  #
250
- # * `oracle-se1`
250
+ # * `oracle-se2`
251
251
  #
252
- # * `oracle-se`
252
+ # * `oracle-se2-cdb`
253
253
  #
254
254
  # * `postgres`
255
255
  #
@@ -122,8 +122,8 @@ module Aws::RDS
122
122
  # The unique identifier for the lease associated with the reserved DB
123
123
  # instance.
124
124
  #
125
- # <note markdown="1"> AWS Support might request the lease ID for an issue related to a
126
- # reserved DB instance.
125
+ # <note markdown="1"> Amazon Web Services Support might request the lease ID for an issue
126
+ # related to a reserved DB instance.
127
127
  #
128
128
  # </note>
129
129
  # @return [String]
@@ -87,9 +87,9 @@ module Aws::RDS
87
87
  # @param [Hash] options ({})
88
88
  # @option options [Array<String>] :availability_zones
89
89
  # A list of Availability Zones (AZs) where instances in the DB cluster
90
- # can be created. For information on AWS Regions and Availability Zones,
91
- # see [Choosing the Regions and Availability Zones][1] in the *Amazon
92
- # Aurora User Guide*.
90
+ # can be created. For information on Amazon Web Services Regions and
91
+ # Availability Zones, see [Choosing the Regions and Availability
92
+ # Zones][1] in the *Amazon Aurora User Guide*.
93
93
  #
94
94
  #
95
95
  #
@@ -213,8 +213,9 @@ module Aws::RDS
213
213
  # parameter.
214
214
  #
215
215
  # The default is a 30-minute window selected at random from an 8-hour
216
- # block of time for each AWS Region. To view the time blocks available,
217
- # see [ Backup window][1] in the *Amazon Aurora User Guide.*
216
+ # block of time for each Amazon Web Services Region. To view the time
217
+ # blocks available, see [ Backup window][1] in the *Amazon Aurora User
218
+ # Guide.*
218
219
  #
219
220
  # Constraints:
220
221
  #
@@ -236,9 +237,10 @@ module Aws::RDS
236
237
  # Format: `ddd:hh24:mi-ddd:hh24:mi`
237
238
  #
238
239
  # The default is a 30-minute window selected at random from an 8-hour
239
- # block of time for each AWS Region, occurring on a random day of the
240
- # week. To see the time blocks available, see [ Adjusting the Preferred
241
- # DB Cluster Maintenance Window][1] in the *Amazon Aurora User Guide.*
240
+ # block of time for each Amazon Web Services Region, occurring on a
241
+ # random day of the week. To see the time blocks available, see [
242
+ # Adjusting the Preferred DB Cluster Maintenance Window][1] in the
243
+ # *Amazon Aurora User Guide.*
242
244
  #
243
245
  # Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.
244
246
  #
@@ -255,11 +257,13 @@ module Aws::RDS
255
257
  # @option options [Boolean] :storage_encrypted
256
258
  # A value that indicates whether the DB cluster is encrypted.
257
259
  # @option options [String] :kms_key_id
258
- # The AWS KMS key identifier for an encrypted DB cluster.
260
+ # The Amazon Web Services KMS key identifier for an encrypted DB
261
+ # cluster.
259
262
  #
260
- # The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias
261
- # name for the AWS KMS customer master key (CMK). To use a CMK in a
262
- # different AWS account, specify the key ARN or alias ARN.
263
+ # The Amazon Web Services KMS key identifier is the key ARN, key ID,
264
+ # alias ARN, or alias name for the Amazon Web Services KMS customer
265
+ # master key (CMK). To use a CMK in a different Amazon Web Services
266
+ # account, specify the key ARN or alias ARN.
263
267
  #
264
268
  # When a CMK isn't specified in `KmsKeyId`\:
265
269
  #
@@ -271,53 +275,58 @@ module Aws::RDS
271
275
  # `ReplicationSourceIdentifier` isn't specified, then Amazon RDS will
272
276
  # use your default CMK.
273
277
  #
274
- # There is a default CMK for your AWS account. Your AWS account has a
275
- # different default CMK for each AWS Region.
278
+ # There is a default CMK for your Amazon Web Services account. Your
279
+ # Amazon Web Services account has a different default CMK for each
280
+ # Amazon Web Services Region.
276
281
  #
277
- # If you create a read replica of an encrypted DB cluster in another AWS
278
- # Region, you must set `KmsKeyId` to a AWS KMS key identifier that is
279
- # valid in the destination AWS Region. This CMK is used to encrypt the
280
- # read replica in that AWS Region.
282
+ # If you create a read replica of an encrypted DB cluster in another
283
+ # Amazon Web Services Region, you must set `KmsKeyId` to a Amazon Web
284
+ # Services KMS key identifier that is valid in the destination Amazon
285
+ # Web Services Region. This CMK is used to encrypt the read replica in
286
+ # that Amazon Web Services Region.
281
287
  # @option options [String] :pre_signed_url
282
288
  # A URL that contains a Signature Version 4 signed request for the
283
- # `CreateDBCluster` action to be called in the source AWS Region where
284
- # the DB cluster is replicated from. You only need to specify
285
- # `PreSignedUrl` when you are performing cross-region replication from
286
- # an encrypted DB cluster.
289
+ # `CreateDBCluster` action to be called in the source Amazon Web
290
+ # Services Region where the DB cluster is replicated from. You only need
291
+ # to specify `PreSignedUrl` when you are performing cross-region
292
+ # replication from an encrypted DB cluster.
287
293
  #
288
294
  # The pre-signed URL must be a valid request for the `CreateDBCluster`
289
- # API action that can be executed in the source AWS Region that contains
290
- # the encrypted DB cluster to be copied.
295
+ # API action that can be executed in the source Amazon Web Services
296
+ # Region that contains the encrypted DB cluster to be copied.
291
297
  #
292
298
  # The pre-signed URL request must contain the following parameter
293
299
  # values:
294
300
  #
295
- # * `KmsKeyId` - The AWS KMS key identifier for the key to use to
296
- # encrypt the copy of the DB cluster in the destination AWS Region.
297
- # This should refer to the same AWS KMS CMK for both the
298
- # `CreateDBCluster` action that is called in the destination AWS
299
- # Region, and the action contained in the pre-signed URL.
301
+ # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the key
302
+ # to use to encrypt the copy of the DB cluster in the destination
303
+ # Amazon Web Services Region. This should refer to the same Amazon Web
304
+ # Services KMS CMK for both the `CreateDBCluster` action that is
305
+ # called in the destination Amazon Web Services Region, and the action
306
+ # contained in the pre-signed URL.
300
307
  #
301
- # * `DestinationRegion` - The name of the AWS Region that Aurora read
302
- # replica will be created in.
308
+ # * `DestinationRegion` - The name of the Amazon Web Services Region
309
+ # that Aurora read replica will be created in.
303
310
  #
304
311
  # * `ReplicationSourceIdentifier` - The DB cluster identifier for the
305
312
  # encrypted DB cluster to be copied. This identifier must be in the
306
- # Amazon Resource Name (ARN) format for the source AWS Region. For
307
- # example, if you are copying an encrypted DB cluster from the
308
- # us-west-2 AWS Region, then your `ReplicationSourceIdentifier` would
309
- # look like Example:
313
+ # Amazon Resource Name (ARN) format for the source Amazon Web Services
314
+ # Region. For example, if you are copying an encrypted DB cluster from
315
+ # the us-west-2 Amazon Web Services Region, then your
316
+ # `ReplicationSourceIdentifier` would look like Example:
310
317
  # `arn:aws:rds:us-west-2:123456789012:cluster:aurora-cluster1`.
311
318
  #
312
319
  # To learn how to generate a Signature Version 4 signed request, see [
313
- # Authenticating Requests: Using Query Parameters (AWS Signature Version
314
- # 4)][1] and [ Signature Version 4 Signing Process][2].
320
+ # Authenticating Requests: Using Query Parameters (Amazon Web Services
321
+ # Signature Version 4)][1] and [ Signature Version 4 Signing
322
+ # Process][2].
315
323
  #
316
- # <note markdown="1"> If you are using an AWS SDK tool or the AWS CLI, you can specify
317
- # `SourceRegion` (or `--source-region` for the AWS CLI) instead of
324
+ # <note markdown="1"> If you are using an Amazon Web Services SDK tool or the CLI, you can
325
+ # specify `SourceRegion` (or `--source-region` for the CLI) instead of
318
326
  # specifying `PreSignedUrl` manually. Specifying `SourceRegion`
319
327
  # autogenerates a pre-signed URL that is a valid request for the
320
- # operation that can be executed in the source AWS Region.
328
+ # operation that can be executed in the source Amazon Web Services
329
+ # Region.
321
330
  #
322
331
  # </note>
323
332
  #
@@ -326,9 +335,9 @@ module Aws::RDS
326
335
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html
327
336
  # [2]: https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html
328
337
  # @option options [Boolean] :enable_iam_database_authentication
329
- # A value that indicates whether to enable mapping of AWS Identity and
330
- # Access Management (IAM) accounts to database accounts. By default,
331
- # mapping is disabled.
338
+ # A value that indicates whether to enable mapping of Amazon Web
339
+ # Services Identity and Access Management (IAM) accounts to database
340
+ # accounts. By default, mapping is disabled.
332
341
  #
333
342
  # For more information, see [ IAM Database Authentication][1] in the
334
343
  # *Amazon Aurora User Guide.*
@@ -816,10 +825,10 @@ module Aws::RDS
816
825
  # * Web and Express editions: Must be an integer from 20 to 1024.
817
826
  # @option options [required, String] :db_instance_class
818
827
  # The compute and memory capacity of the DB instance, for example,
819
- # `db.m4.large`. Not all DB instance classes are available in all AWS
820
- # Regions, or for all database engines. For the full list of DB instance
821
- # classes, and availability for your engine, see [DB Instance Class][1]
822
- # in the *Amazon RDS User Guide.*
828
+ # `db.m4.large`. Not all DB instance classes are available in all Amazon
829
+ # Web Services Regions, or for all database engines. For the full list
830
+ # of DB instance classes, and availability for your engine, see [DB
831
+ # Instance Class][1] in the *Amazon RDS User Guide.*
823
832
  #
824
833
  #
825
834
  #
@@ -827,7 +836,8 @@ module Aws::RDS
827
836
  # @option options [required, String] :engine
828
837
  # The name of the database engine to be used for this instance.
829
838
  #
830
- # Not every database engine is available for every AWS Region.
839
+ # Not every database engine is available for every Amazon Web Services
840
+ # Region.
831
841
  #
832
842
  # Valid Values:
833
843
  #
@@ -843,11 +853,11 @@ module Aws::RDS
843
853
  #
844
854
  # * `oracle-ee`
845
855
  #
846
- # * `oracle-se2`
856
+ # * `oracle-ee-cdb`
847
857
  #
848
- # * `oracle-se1`
858
+ # * `oracle-se2`
849
859
  #
850
- # * `oracle-se`
860
+ # * `oracle-se2-cdb`
851
861
  #
852
862
  # * `postgres`
853
863
  #
@@ -968,17 +978,18 @@ module Aws::RDS
968
978
  # VPC.
969
979
  # @option options [String] :availability_zone
970
980
  # The Availability Zone (AZ) where the database will be created. For
971
- # information on AWS Regions and Availability Zones, see [Regions and
972
- # Availability Zones][1].
981
+ # information on Amazon Web Services Regions and Availability Zones, see
982
+ # [Regions and Availability Zones][1].
973
983
  #
974
984
  # Default: A random, system-chosen Availability Zone in the endpoint's
975
- # AWS Region.
985
+ # Amazon Web Services Region.
976
986
  #
977
987
  # Example: `us-east-1d`
978
988
  #
979
989
  # Constraint: The `AvailabilityZone` parameter can't be specified if
980
990
  # the DB instance is a Multi-AZ deployment. The specified Availability
981
- # Zone must be in the same AWS Region as the current endpoint.
991
+ # Zone must be in the same Amazon Web Services Region as the current
992
+ # endpoint.
982
993
  #
983
994
  # <note markdown="1"> If you're creating a DB instance in an RDS on VMware environment,
984
995
  # specify the identifier of the custom Availability Zone to create the
@@ -1005,8 +1016,8 @@ module Aws::RDS
1005
1016
  # Format: `ddd:hh24:mi-ddd:hh24:mi`
1006
1017
  #
1007
1018
  # The default is a 30-minute window selected at random from an 8-hour
1008
- # block of time for each AWS Region, occurring on a random day of the
1009
- # week.
1019
+ # block of time for each Amazon Web Services Region, occurring on a
1020
+ # random day of the week.
1010
1021
  #
1011
1022
  # Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.
1012
1023
  #
@@ -1048,8 +1059,8 @@ module Aws::RDS
1048
1059
  # The daily time range during which automated backups are created if
1049
1060
  # automated backups are enabled, using the `BackupRetentionPeriod`
1050
1061
  # parameter. The default is a 30-minute window selected at random from
1051
- # an 8-hour block of time for each AWS Region. For more information, see
1052
- # [Backup window][1] in the *Amazon RDS User Guide*.
1062
+ # an 8-hour block of time for each Amazon Web Services Region. For more
1063
+ # information, see [Backup window][1] in the *Amazon RDS User Guide*.
1053
1064
  #
1054
1065
  # **Amazon Aurora**
1055
1066
  #
@@ -1128,7 +1139,8 @@ module Aws::RDS
1128
1139
  #
1129
1140
  # The following are the database engines and links to information about
1130
1141
  # the major and minor versions that are available with Amazon RDS. Not
1131
- # every database engine is available for every AWS Region.
1142
+ # every database engine is available for every Amazon Web Services
1143
+ # Region.
1132
1144
  #
1133
1145
  # **Amazon Aurora**
1134
1146
  #
@@ -1268,21 +1280,24 @@ module Aws::RDS
1268
1280
  # Not applicable. The encryption for DB instances is managed by the DB
1269
1281
  # cluster.
1270
1282
  # @option options [String] :kms_key_id
1271
- # The AWS KMS key identifier for an encrypted DB instance.
1283
+ # The Amazon Web Services KMS key identifier for an encrypted DB
1284
+ # instance.
1272
1285
  #
1273
- # The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias
1274
- # name for the AWS KMS customer master key (CMK). To use a CMK in a
1275
- # different AWS account, specify the key ARN or alias ARN.
1286
+ # The Amazon Web Services KMS key identifier is the key ARN, key ID,
1287
+ # alias ARN, or alias name for the Amazon Web Services KMS customer
1288
+ # master key (CMK). To use a CMK in a different Amazon Web Services
1289
+ # account, specify the key ARN or alias ARN.
1276
1290
  #
1277
1291
  # **Amazon Aurora**
1278
1292
  #
1279
- # Not applicable. The AWS KMS key identifier is managed by the DB
1280
- # cluster. For more information, see `CreateDBCluster`.
1293
+ # Not applicable. The Amazon Web Services KMS key identifier is managed
1294
+ # by the DB cluster. For more information, see `CreateDBCluster`.
1281
1295
  #
1282
1296
  # If `StorageEncrypted` is enabled, and you do not specify a value for
1283
1297
  # the `KmsKeyId` parameter, then Amazon RDS uses your default CMK. There
1284
- # is a default CMK for your AWS account. Your AWS account has a
1285
- # different default CMK for each AWS Region.
1298
+ # is a default CMK for your Amazon Web Services account. Your Amazon Web
1299
+ # Services account has a different default CMK for each Amazon Web
1300
+ # Services Region.
1286
1301
  # @option options [String] :domain
1287
1302
  # The Active Directory directory ID to create the DB instance in.
1288
1303
  # Currently, only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
@@ -1349,12 +1364,13 @@ module Aws::RDS
1349
1364
  #
1350
1365
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.TimeZone
1351
1366
  # @option options [Boolean] :enable_iam_database_authentication
1352
- # A value that indicates whether to enable mapping of AWS Identity and
1353
- # Access Management (IAM) accounts to database accounts. By default,
1354
- # mapping is disabled.
1367
+ # A value that indicates whether to enable mapping of Amazon Web
1368
+ # Services Identity and Access Management (IAM) accounts to database
1369
+ # accounts. By default, mapping is disabled.
1355
1370
  #
1356
- # This setting doesn't apply to Amazon Aurora. Mapping AWS IAM accounts
1357
- # to database accounts is managed by the DB cluster.
1371
+ # This setting doesn't apply to Amazon Aurora. Mapping Amazon Web
1372
+ # Services IAM accounts to database accounts is managed by the DB
1373
+ # cluster.
1358
1374
  #
1359
1375
  # For more information, see [ IAM Database Authentication for MySQL and
1360
1376
  # PostgreSQL][1] in the *Amazon RDS User Guide.*
@@ -1373,16 +1389,17 @@ module Aws::RDS
1373
1389
  #
1374
1390
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
1375
1391
  # @option options [String] :performance_insights_kms_key_id
1376
- # The AWS KMS key identifier for encryption of Performance Insights
1377
- # data.
1392
+ # The Amazon Web Services KMS key identifier for encryption of
1393
+ # Performance Insights data.
1378
1394
  #
1379
- # The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias
1380
- # name for the AWS KMS customer master key (CMK).
1395
+ # The Amazon Web Services KMS key identifier is the key ARN, key ID,
1396
+ # alias ARN, or alias name for the Amazon Web Services KMS customer
1397
+ # master key (CMK).
1381
1398
  #
1382
1399
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
1383
- # Amazon RDS uses your default CMK. There is a default CMK for your AWS
1384
- # account. Your AWS account has a different default CMK for each AWS
1385
- # Region.
1400
+ # Amazon RDS uses your default CMK. There is a default CMK for your
1401
+ # Amazon Web Services account. Your Amazon Web Services account has a
1402
+ # different default CMK for each Amazon Web Services Region.
1386
1403
  # @option options [Integer] :performance_insights_retention_period
1387
1404
  # The amount of time, in days, to retain Performance Insights data.
1388
1405
  # Valid values are 7 or 731 (2 years).
@@ -1461,10 +1478,11 @@ module Aws::RDS
1461
1478
  # from outside of its virtual private cloud (VPC) on your local network.
1462
1479
  #
1463
1480
  # For more information about RDS on Outposts, see [Working with Amazon
1464
- # RDS on AWS Outposts][1] in the *Amazon RDS User Guide*.
1481
+ # RDS on Amazon Web Services Outposts][1] in the *Amazon RDS User
1482
+ # Guide*.
1465
1483
  #
1466
1484
  # For more information about CoIPs, see [Customer-owned IP addresses][2]
1467
- # in the *AWS Outposts User Guide*.
1485
+ # in the *Amazon Web Services Outposts User Guide*.
1468
1486
  #
1469
1487
  #
1470
1488
  #
@@ -1544,11 +1562,11 @@ module Aws::RDS
1544
1562
  #
1545
1563
  # * `oracle-ee`
1546
1564
  #
1547
- # * `oracle-se2`
1565
+ # * `oracle-ee-cdb`
1548
1566
  #
1549
- # * `oracle-se1`
1567
+ # * `oracle-se2`
1550
1568
  #
1551
- # * `oracle-se`
1569
+ # * `oracle-se2-cdb`
1552
1570
  #
1553
1571
  # * `postgres`
1554
1572
  #
@@ -1783,11 +1801,11 @@ module Aws::RDS
1783
1801
  #
1784
1802
  # * `oracle-ee`
1785
1803
  #
1786
- # * `oracle-se2`
1804
+ # * `oracle-ee-cdb`
1787
1805
  #
1788
- # * `oracle-se1`
1806
+ # * `oracle-se2`
1789
1807
  #
1790
- # * `oracle-se`
1808
+ # * `oracle-se2-cdb`
1791
1809
  #
1792
1810
  # * `postgres`
1793
1811
  #
@@ -1979,14 +1997,24 @@ module Aws::RDS
1979
1997
  #
1980
1998
  # Supported filters:
1981
1999
  #
2000
+ # * `clone-group-id` - Accepts clone group identifiers. The results list
2001
+ # will only include information about the DB clusters associated with
2002
+ # these clone groups.
2003
+ #
1982
2004
  # * `db-cluster-id` - Accepts DB cluster identifiers and DB cluster
1983
2005
  # Amazon Resource Names (ARNs). The results list will only include
1984
2006
  # information about the DB clusters identified by these ARNs.
1985
2007
  #
1986
- # ^
2008
+ # * `domain` - Accepts Active Directory directory IDs. The results list
2009
+ # will only include information about the DB clusters associated with
2010
+ # these domains.
2011
+ #
2012
+ # * `engine` - Accepts engine names. The results list will only include
2013
+ # information about the DB clusters for these engines.
1987
2014
  # @option options [Boolean] :include_shared
1988
2015
  # Optional Boolean parameter that specifies whether the output includes
1989
- # information about clusters shared from other AWS accounts.
2016
+ # information about clusters shared from other Amazon Web Services
2017
+ # accounts.
1990
2018
  # @return [DBCluster::Collection]
1991
2019
  def db_clusters(options = {})
1992
2020
  batches = Enumerator.new do |y|
@@ -2061,11 +2089,11 @@ module Aws::RDS
2061
2089
  #
2062
2090
  # * `oracle-ee`
2063
2091
  #
2064
- # * `oracle-se2`
2092
+ # * `oracle-ee-cdb`
2065
2093
  #
2066
- # * `oracle-se1`
2094
+ # * `oracle-se2`
2067
2095
  #
2068
- # * `oracle-se`
2096
+ # * `oracle-se2-cdb`
2069
2097
  #
2070
2098
  # * `postgres`
2071
2099
  #
@@ -2353,21 +2381,21 @@ module Aws::RDS
2353
2381
  # following values:
2354
2382
  #
2355
2383
  # * `automated` - Return all DB snapshots that have been automatically
2356
- # taken by Amazon RDS for my AWS account.
2384
+ # taken by Amazon RDS for my Amazon Web Services account.
2357
2385
  #
2358
- # * `manual` - Return all DB snapshots that have been taken by my AWS
2359
- # account.
2386
+ # * `manual` - Return all DB snapshots that have been taken by my Amazon
2387
+ # Web Services account.
2360
2388
  #
2361
2389
  # * `shared` - Return all manual DB snapshots that have been shared to
2362
- # my AWS account.
2390
+ # my Amazon Web Services account.
2363
2391
  #
2364
2392
  # * `public` - Return all DB snapshots that have been marked as public.
2365
2393
  #
2366
- # * `awsbackup` - Return the DB snapshots managed by the AWS Backup
2367
- # service.
2394
+ # * `awsbackup` - Return the DB snapshots managed by the Amazon Web
2395
+ # Services Backup service.
2368
2396
  #
2369
- # For information about AWS Backup, see the [ *AWS Backup Developer
2370
- # Guide.* ][1]
2397
+ # For information about Amazon Web Services Backup, see the [ *Amazon
2398
+ # Web Services Backup Developer Guide.* ][1]
2371
2399
  #
2372
2400
  # The `awsbackup` type does not apply to Aurora.
2373
2401
  #
@@ -2404,17 +2432,17 @@ module Aws::RDS
2404
2432
  # * `engine` - Accepts names of database engines.
2405
2433
  # @option options [Boolean] :include_shared
2406
2434
  # A value that indicates whether to include shared manual DB cluster
2407
- # snapshots from other AWS accounts that this AWS account has been given
2408
- # permission to copy or restore. By default, these snapshots are not
2409
- # included.
2435
+ # snapshots from other Amazon Web Services accounts that this Amazon Web
2436
+ # Services account has been given permission to copy or restore. By
2437
+ # default, these snapshots are not included.
2410
2438
  #
2411
- # You can give an AWS account permission to restore a manual DB snapshot
2412
- # from another AWS account by using the `ModifyDBSnapshotAttribute` API
2413
- # action.
2439
+ # You can give an Amazon Web Services account permission to restore a
2440
+ # manual DB snapshot from another Amazon Web Services account by using
2441
+ # the `ModifyDBSnapshotAttribute` API action.
2414
2442
  # @option options [Boolean] :include_public
2415
2443
  # A value that indicates whether to include manual DB cluster snapshots
2416
- # that are public and can be copied or restored by any AWS account. By
2417
- # default, the public snapshots are not included.
2444
+ # that are public and can be copied or restored by any Amazon Web
2445
+ # Services account. By default, the public snapshots are not included.
2418
2446
  #
2419
2447
  # You can share a manual DB snapshot as public by using the
2420
2448
  # ModifyDBSnapshotAttribute API.
@@ -2711,11 +2739,11 @@ module Aws::RDS
2711
2739
  #
2712
2740
  # * `oracle-ee`
2713
2741
  #
2714
- # * `oracle-se2`
2742
+ # * `oracle-ee-cdb`
2715
2743
  #
2716
- # * `oracle-se1`
2744
+ # * `oracle-se2`
2717
2745
  #
2718
- # * `oracle-se`
2746
+ # * `oracle-se2-cdb`
2719
2747
  #
2720
2748
  # * `postgres`
2721
2749
  #
@@ -2819,8 +2847,8 @@ module Aws::RDS
2819
2847
  # The lease identifier filter value. Specify this parameter to show only
2820
2848
  # the reservation that matches the specified lease ID.
2821
2849
  #
2822
- # <note markdown="1"> AWS Support might request the lease ID for an issue related to a
2823
- # reserved DB instance.
2850
+ # <note markdown="1"> Amazon Web Services Support might request the lease ID for an issue
2851
+ # related to a reserved DB instance.
2824
2852
  #
2825
2853
  # </note>
2826
2854
  # @option options [Array<Types::Filter>] :filters