aws-sdk-rds 1.119.0 → 1.123.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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