aws-sdk-rds 1.106.0 → 1.107.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.
@@ -146,6 +146,8 @@ module Aws::RDS
146
146
  DBInstanceAutomatedBackupMessage = Shapes::StructureShape.new(name: 'DBInstanceAutomatedBackupMessage')
147
147
  DBInstanceAutomatedBackupNotFoundFault = Shapes::StructureShape.new(name: 'DBInstanceAutomatedBackupNotFoundFault')
148
148
  DBInstanceAutomatedBackupQuotaExceededFault = Shapes::StructureShape.new(name: 'DBInstanceAutomatedBackupQuotaExceededFault')
149
+ DBInstanceAutomatedBackupsReplication = Shapes::StructureShape.new(name: 'DBInstanceAutomatedBackupsReplication')
150
+ DBInstanceAutomatedBackupsReplicationList = Shapes::ListShape.new(name: 'DBInstanceAutomatedBackupsReplicationList')
149
151
  DBInstanceList = Shapes::ListShape.new(name: 'DBInstanceList')
150
152
  DBInstanceMessage = Shapes::StructureShape.new(name: 'DBInstanceMessage')
151
153
  DBInstanceNotFoundFault = Shapes::StructureShape.new(name: 'DBInstanceNotFoundFault')
@@ -520,6 +522,8 @@ module Aws::RDS
520
522
  StartActivityStreamResponse = Shapes::StructureShape.new(name: 'StartActivityStreamResponse')
521
523
  StartDBClusterMessage = Shapes::StructureShape.new(name: 'StartDBClusterMessage')
522
524
  StartDBClusterResult = Shapes::StructureShape.new(name: 'StartDBClusterResult')
525
+ StartDBInstanceAutomatedBackupsReplicationMessage = Shapes::StructureShape.new(name: 'StartDBInstanceAutomatedBackupsReplicationMessage')
526
+ StartDBInstanceAutomatedBackupsReplicationResult = Shapes::StructureShape.new(name: 'StartDBInstanceAutomatedBackupsReplicationResult')
523
527
  StartDBInstanceMessage = Shapes::StructureShape.new(name: 'StartDBInstanceMessage')
524
528
  StartDBInstanceResult = Shapes::StructureShape.new(name: 'StartDBInstanceResult')
525
529
  StartExportTaskMessage = Shapes::StructureShape.new(name: 'StartExportTaskMessage')
@@ -527,6 +531,8 @@ module Aws::RDS
527
531
  StopActivityStreamResponse = Shapes::StructureShape.new(name: 'StopActivityStreamResponse')
528
532
  StopDBClusterMessage = Shapes::StructureShape.new(name: 'StopDBClusterMessage')
529
533
  StopDBClusterResult = Shapes::StructureShape.new(name: 'StopDBClusterResult')
534
+ StopDBInstanceAutomatedBackupsReplicationMessage = Shapes::StructureShape.new(name: 'StopDBInstanceAutomatedBackupsReplicationMessage')
535
+ StopDBInstanceAutomatedBackupsReplicationResult = Shapes::StructureShape.new(name: 'StopDBInstanceAutomatedBackupsReplicationResult')
530
536
  StopDBInstanceMessage = Shapes::StructureShape.new(name: 'StopDBInstanceMessage')
531
537
  StopDBInstanceResult = Shapes::StructureShape.new(name: 'StopDBInstanceResult')
532
538
  StorageQuotaExceededFault = Shapes::StructureShape.new(name: 'StorageQuotaExceededFault')
@@ -706,7 +712,6 @@ module Aws::RDS
706
712
  CopyDBClusterSnapshotMessage.add_member(:pre_signed_url, Shapes::ShapeRef.new(shape: String, location_name: "PreSignedUrl"))
707
713
  CopyDBClusterSnapshotMessage.add_member(:copy_tags, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "CopyTags"))
708
714
  CopyDBClusterSnapshotMessage.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
709
- CopyDBClusterSnapshotMessage.add_member(:destination_region, Shapes::ShapeRef.new(shape: String, location_name: "DestinationRegion", metadata: {"documented"=>false}))
710
715
  CopyDBClusterSnapshotMessage.add_member(:source_region, Shapes::ShapeRef.new(shape: String, location_name: "SourceRegion"))
711
716
  CopyDBClusterSnapshotMessage.struct_class = Types::CopyDBClusterSnapshotMessage
712
717
 
@@ -730,7 +735,6 @@ module Aws::RDS
730
735
  CopyDBSnapshotMessage.add_member(:pre_signed_url, Shapes::ShapeRef.new(shape: String, location_name: "PreSignedUrl"))
731
736
  CopyDBSnapshotMessage.add_member(:option_group_name, Shapes::ShapeRef.new(shape: String, location_name: "OptionGroupName"))
732
737
  CopyDBSnapshotMessage.add_member(:target_custom_availability_zone, Shapes::ShapeRef.new(shape: String, location_name: "TargetCustomAvailabilityZone"))
733
- CopyDBSnapshotMessage.add_member(:destination_region, Shapes::ShapeRef.new(shape: String, location_name: "DestinationRegion", metadata: {"documented"=>false}))
734
738
  CopyDBSnapshotMessage.add_member(:source_region, Shapes::ShapeRef.new(shape: String, location_name: "SourceRegion"))
735
739
  CopyDBSnapshotMessage.struct_class = Types::CopyDBSnapshotMessage
736
740
 
@@ -796,7 +800,6 @@ module Aws::RDS
796
800
  CreateDBClusterMessage.add_member(:domain, Shapes::ShapeRef.new(shape: String, location_name: "Domain"))
797
801
  CreateDBClusterMessage.add_member(:domain_iam_role_name, Shapes::ShapeRef.new(shape: String, location_name: "DomainIAMRoleName"))
798
802
  CreateDBClusterMessage.add_member(:enable_global_write_forwarding, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "EnableGlobalWriteForwarding"))
799
- CreateDBClusterMessage.add_member(:destination_region, Shapes::ShapeRef.new(shape: String, location_name: "DestinationRegion", metadata: {"documented"=>false}))
800
803
  CreateDBClusterMessage.add_member(:source_region, Shapes::ShapeRef.new(shape: String, location_name: "SourceRegion"))
801
804
  CreateDBClusterMessage.struct_class = Types::CreateDBClusterMessage
802
805
 
@@ -901,7 +904,6 @@ module Aws::RDS
901
904
  CreateDBInstanceReadReplicaMessage.add_member(:domain_iam_role_name, Shapes::ShapeRef.new(shape: String, location_name: "DomainIAMRoleName"))
902
905
  CreateDBInstanceReadReplicaMessage.add_member(:replica_mode, Shapes::ShapeRef.new(shape: ReplicaMode, location_name: "ReplicaMode"))
903
906
  CreateDBInstanceReadReplicaMessage.add_member(:max_allocated_storage, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "MaxAllocatedStorage"))
904
- CreateDBInstanceReadReplicaMessage.add_member(:destination_region, Shapes::ShapeRef.new(shape: String, location_name: "DestinationRegion", metadata: {"documented"=>false}))
905
907
  CreateDBInstanceReadReplicaMessage.add_member(:source_region, Shapes::ShapeRef.new(shape: String, location_name: "SourceRegion"))
906
908
  CreateDBInstanceReadReplicaMessage.struct_class = Types::CreateDBInstanceReadReplicaMessage
907
909
 
@@ -1306,6 +1308,7 @@ module Aws::RDS
1306
1308
  DBInstance.add_member(:listener_endpoint, Shapes::ShapeRef.new(shape: Endpoint, location_name: "ListenerEndpoint"))
1307
1309
  DBInstance.add_member(:max_allocated_storage, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "MaxAllocatedStorage"))
1308
1310
  DBInstance.add_member(:tag_list, Shapes::ShapeRef.new(shape: TagList, location_name: "TagList"))
1311
+ DBInstance.add_member(:db_instance_automated_backups_replications, Shapes::ShapeRef.new(shape: DBInstanceAutomatedBackupsReplicationList, location_name: "DBInstanceAutomatedBackupsReplications"))
1309
1312
  DBInstance.struct_class = Types::DBInstance
1310
1313
 
1311
1314
  DBInstanceAlreadyExistsFault.struct_class = Types::DBInstanceAlreadyExistsFault
@@ -1333,6 +1336,9 @@ module Aws::RDS
1333
1336
  DBInstanceAutomatedBackup.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: String, location_name: "KmsKeyId"))
1334
1337
  DBInstanceAutomatedBackup.add_member(:timezone, Shapes::ShapeRef.new(shape: String, location_name: "Timezone"))
1335
1338
  DBInstanceAutomatedBackup.add_member(:iam_database_authentication_enabled, Shapes::ShapeRef.new(shape: Boolean, location_name: "IAMDatabaseAuthenticationEnabled"))
1339
+ DBInstanceAutomatedBackup.add_member(:backup_retention_period, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "BackupRetentionPeriod"))
1340
+ DBInstanceAutomatedBackup.add_member(:db_instance_automated_backups_arn, Shapes::ShapeRef.new(shape: String, location_name: "DBInstanceAutomatedBackupsArn"))
1341
+ DBInstanceAutomatedBackup.add_member(:db_instance_automated_backups_replications, Shapes::ShapeRef.new(shape: DBInstanceAutomatedBackupsReplicationList, location_name: "DBInstanceAutomatedBackupsReplications"))
1336
1342
  DBInstanceAutomatedBackup.struct_class = Types::DBInstanceAutomatedBackup
1337
1343
 
1338
1344
  DBInstanceAutomatedBackupList.member = Shapes::ShapeRef.new(shape: DBInstanceAutomatedBackup, location_name: "DBInstanceAutomatedBackup")
@@ -1345,6 +1351,11 @@ module Aws::RDS
1345
1351
 
1346
1352
  DBInstanceAutomatedBackupQuotaExceededFault.struct_class = Types::DBInstanceAutomatedBackupQuotaExceededFault
1347
1353
 
1354
+ DBInstanceAutomatedBackupsReplication.add_member(:db_instance_automated_backups_arn, Shapes::ShapeRef.new(shape: String, location_name: "DBInstanceAutomatedBackupsArn"))
1355
+ DBInstanceAutomatedBackupsReplication.struct_class = Types::DBInstanceAutomatedBackupsReplication
1356
+
1357
+ DBInstanceAutomatedBackupsReplicationList.member = Shapes::ShapeRef.new(shape: DBInstanceAutomatedBackupsReplication, location_name: "DBInstanceAutomatedBackupsReplication")
1358
+
1348
1359
  DBInstanceList.member = Shapes::ShapeRef.new(shape: DBInstance, location_name: "DBInstance")
1349
1360
 
1350
1361
  DBInstanceMessage.add_member(:marker, Shapes::ShapeRef.new(shape: String, location_name: "Marker"))
@@ -1592,7 +1603,8 @@ module Aws::RDS
1592
1603
  DeleteDBClusterSnapshotResult.add_member(:db_cluster_snapshot, Shapes::ShapeRef.new(shape: DBClusterSnapshot, location_name: "DBClusterSnapshot"))
1593
1604
  DeleteDBClusterSnapshotResult.struct_class = Types::DeleteDBClusterSnapshotResult
1594
1605
 
1595
- DeleteDBInstanceAutomatedBackupMessage.add_member(:dbi_resource_id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "DbiResourceId"))
1606
+ DeleteDBInstanceAutomatedBackupMessage.add_member(:dbi_resource_id, Shapes::ShapeRef.new(shape: String, location_name: "DbiResourceId"))
1607
+ DeleteDBInstanceAutomatedBackupMessage.add_member(:db_instance_automated_backups_arn, Shapes::ShapeRef.new(shape: String, location_name: "DBInstanceAutomatedBackupsArn"))
1596
1608
  DeleteDBInstanceAutomatedBackupMessage.struct_class = Types::DeleteDBInstanceAutomatedBackupMessage
1597
1609
 
1598
1610
  DeleteDBInstanceAutomatedBackupResult.add_member(:db_instance_automated_backup, Shapes::ShapeRef.new(shape: DBInstanceAutomatedBackup, location_name: "DBInstanceAutomatedBackup"))
@@ -1735,6 +1747,7 @@ module Aws::RDS
1735
1747
  DescribeDBInstanceAutomatedBackupsMessage.add_member(:filters, Shapes::ShapeRef.new(shape: FilterList, location_name: "Filters"))
1736
1748
  DescribeDBInstanceAutomatedBackupsMessage.add_member(:max_records, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "MaxRecords"))
1737
1749
  DescribeDBInstanceAutomatedBackupsMessage.add_member(:marker, Shapes::ShapeRef.new(shape: String, location_name: "Marker"))
1750
+ DescribeDBInstanceAutomatedBackupsMessage.add_member(:db_instance_automated_backups_arn, Shapes::ShapeRef.new(shape: String, location_name: "DBInstanceAutomatedBackupsArn"))
1738
1751
  DescribeDBInstanceAutomatedBackupsMessage.struct_class = Types::DescribeDBInstanceAutomatedBackupsMessage
1739
1752
 
1740
1753
  DescribeDBInstancesMessage.add_member(:db_instance_identifier, Shapes::ShapeRef.new(shape: String, location_name: "DBInstanceIdentifier"))
@@ -2999,6 +3012,7 @@ module Aws::RDS
2999
3012
  RestoreDBInstanceToPointInTimeMessage.add_member(:deletion_protection, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "DeletionProtection"))
3000
3013
  RestoreDBInstanceToPointInTimeMessage.add_member(:source_dbi_resource_id, Shapes::ShapeRef.new(shape: String, location_name: "SourceDbiResourceId"))
3001
3014
  RestoreDBInstanceToPointInTimeMessage.add_member(:max_allocated_storage, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "MaxAllocatedStorage"))
3015
+ RestoreDBInstanceToPointInTimeMessage.add_member(:source_db_instance_automated_backups_arn, Shapes::ShapeRef.new(shape: String, location_name: "SourceDBInstanceAutomatedBackupsArn"))
3002
3016
  RestoreDBInstanceToPointInTimeMessage.struct_class = Types::RestoreDBInstanceToPointInTimeMessage
3003
3017
 
3004
3018
  RestoreDBInstanceToPointInTimeResult.add_member(:db_instance, Shapes::ShapeRef.new(shape: DBInstance, location_name: "DBInstance"))
@@ -3049,6 +3063,7 @@ module Aws::RDS
3049
3063
  SourceRegion.add_member(:region_name, Shapes::ShapeRef.new(shape: String, location_name: "RegionName"))
3050
3064
  SourceRegion.add_member(:endpoint, Shapes::ShapeRef.new(shape: String, location_name: "Endpoint"))
3051
3065
  SourceRegion.add_member(:status, Shapes::ShapeRef.new(shape: String, location_name: "Status"))
3066
+ SourceRegion.add_member(:supports_db_instance_automated_backups_replication, Shapes::ShapeRef.new(shape: Boolean, location_name: "SupportsDBInstanceAutomatedBackupsReplication"))
3052
3067
  SourceRegion.struct_class = Types::SourceRegion
3053
3068
 
3054
3069
  SourceRegionList.member = Shapes::ShapeRef.new(shape: SourceRegion, location_name: "SourceRegion")
@@ -3076,6 +3091,16 @@ module Aws::RDS
3076
3091
  StartDBClusterResult.add_member(:db_cluster, Shapes::ShapeRef.new(shape: DBCluster, location_name: "DBCluster"))
3077
3092
  StartDBClusterResult.struct_class = Types::StartDBClusterResult
3078
3093
 
3094
+ StartDBInstanceAutomatedBackupsReplicationMessage.add_member(:source_db_instance_arn, Shapes::ShapeRef.new(shape: String, required: true, location_name: "SourceDBInstanceArn"))
3095
+ StartDBInstanceAutomatedBackupsReplicationMessage.add_member(:backup_retention_period, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "BackupRetentionPeriod"))
3096
+ StartDBInstanceAutomatedBackupsReplicationMessage.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: String, location_name: "KmsKeyId"))
3097
+ StartDBInstanceAutomatedBackupsReplicationMessage.add_member(:pre_signed_url, Shapes::ShapeRef.new(shape: String, location_name: "PreSignedUrl"))
3098
+ StartDBInstanceAutomatedBackupsReplicationMessage.add_member(:source_region, Shapes::ShapeRef.new(shape: String, location_name: "SourceRegion"))
3099
+ StartDBInstanceAutomatedBackupsReplicationMessage.struct_class = Types::StartDBInstanceAutomatedBackupsReplicationMessage
3100
+
3101
+ StartDBInstanceAutomatedBackupsReplicationResult.add_member(:db_instance_automated_backup, Shapes::ShapeRef.new(shape: DBInstanceAutomatedBackup, location_name: "DBInstanceAutomatedBackup"))
3102
+ StartDBInstanceAutomatedBackupsReplicationResult.struct_class = Types::StartDBInstanceAutomatedBackupsReplicationResult
3103
+
3079
3104
  StartDBInstanceMessage.add_member(:db_instance_identifier, Shapes::ShapeRef.new(shape: String, required: true, location_name: "DBInstanceIdentifier"))
3080
3105
  StartDBInstanceMessage.struct_class = Types::StartDBInstanceMessage
3081
3106
 
@@ -3106,6 +3131,12 @@ module Aws::RDS
3106
3131
  StopDBClusterResult.add_member(:db_cluster, Shapes::ShapeRef.new(shape: DBCluster, location_name: "DBCluster"))
3107
3132
  StopDBClusterResult.struct_class = Types::StopDBClusterResult
3108
3133
 
3134
+ StopDBInstanceAutomatedBackupsReplicationMessage.add_member(:source_db_instance_arn, Shapes::ShapeRef.new(shape: String, required: true, location_name: "SourceDBInstanceArn"))
3135
+ StopDBInstanceAutomatedBackupsReplicationMessage.struct_class = Types::StopDBInstanceAutomatedBackupsReplicationMessage
3136
+
3137
+ StopDBInstanceAutomatedBackupsReplicationResult.add_member(:db_instance_automated_backup, Shapes::ShapeRef.new(shape: DBInstanceAutomatedBackup, location_name: "DBInstanceAutomatedBackup"))
3138
+ StopDBInstanceAutomatedBackupsReplicationResult.struct_class = Types::StopDBInstanceAutomatedBackupsReplicationResult
3139
+
3109
3140
  StopDBInstanceMessage.add_member(:db_instance_identifier, Shapes::ShapeRef.new(shape: String, required: true, location_name: "DBInstanceIdentifier"))
3110
3141
  StopDBInstanceMessage.add_member(:db_snapshot_identifier, Shapes::ShapeRef.new(shape: String, location_name: "DBSnapshotIdentifier"))
3111
3142
  StopDBInstanceMessage.struct_class = Types::StopDBInstanceMessage
@@ -4934,6 +4965,19 @@ module Aws::RDS
4934
4965
  o.errors << Shapes::ShapeRef.new(shape: KMSKeyNotAccessibleFault)
4935
4966
  end)
4936
4967
 
4968
+ api.add_operation(:start_db_instance_automated_backups_replication, Seahorse::Model::Operation.new.tap do |o|
4969
+ o.name = "StartDBInstanceAutomatedBackupsReplication"
4970
+ o.http_method = "POST"
4971
+ o.http_request_uri = "/"
4972
+ o.input = Shapes::ShapeRef.new(shape: StartDBInstanceAutomatedBackupsReplicationMessage)
4973
+ o.output = Shapes::ShapeRef.new(shape: StartDBInstanceAutomatedBackupsReplicationResult)
4974
+ o.errors << Shapes::ShapeRef.new(shape: DBInstanceNotFoundFault)
4975
+ o.errors << Shapes::ShapeRef.new(shape: InvalidDBInstanceStateFault)
4976
+ o.errors << Shapes::ShapeRef.new(shape: KMSKeyNotAccessibleFault)
4977
+ o.errors << Shapes::ShapeRef.new(shape: DBInstanceAutomatedBackupQuotaExceededFault)
4978
+ o.errors << Shapes::ShapeRef.new(shape: StorageTypeNotSupportedFault)
4979
+ end)
4980
+
4937
4981
  api.add_operation(:start_export_task, Seahorse::Model::Operation.new.tap do |o|
4938
4982
  o.name = "StartExportTask"
4939
4983
  o.http_method = "POST"
@@ -4987,6 +5031,16 @@ module Aws::RDS
4987
5031
  o.errors << Shapes::ShapeRef.new(shape: SnapshotQuotaExceededFault)
4988
5032
  o.errors << Shapes::ShapeRef.new(shape: InvalidDBClusterStateFault)
4989
5033
  end)
5034
+
5035
+ api.add_operation(:stop_db_instance_automated_backups_replication, Seahorse::Model::Operation.new.tap do |o|
5036
+ o.name = "StopDBInstanceAutomatedBackupsReplication"
5037
+ o.http_method = "POST"
5038
+ o.http_request_uri = "/"
5039
+ o.input = Shapes::ShapeRef.new(shape: StopDBInstanceAutomatedBackupsReplicationMessage)
5040
+ o.output = Shapes::ShapeRef.new(shape: StopDBInstanceAutomatedBackupsReplicationResult)
5041
+ o.errors << Shapes::ShapeRef.new(shape: DBInstanceNotFoundFault)
5042
+ o.errors << Shapes::ShapeRef.new(shape: InvalidDBInstanceStateFault)
5043
+ end)
4990
5044
  end
4991
5045
 
4992
5046
  end
@@ -236,6 +236,9 @@ module Aws::RDS
236
236
 
237
237
  # If `StorageEncrypted` is enabled, the AWS KMS key identifier for the
238
238
  # encrypted DB cluster.
239
+ #
240
+ # The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias
241
+ # name for the AWS KMS customer master key (CMK).
239
242
  # @return [String]
240
243
  def kms_key_id
241
244
  data[:kms_key_id]
@@ -243,7 +246,7 @@ module Aws::RDS
243
246
 
244
247
  # The AWS Region-unique, immutable identifier for the DB cluster. This
245
248
  # identifier is found in AWS CloudTrail log entries whenever the AWS KMS
246
- # key for the DB cluster is accessed.
249
+ # CMK for the DB cluster is accessed.
247
250
  # @return [String]
248
251
  def db_cluster_resource_id
249
252
  data[:db_cluster_resource_id]
@@ -403,6 +406,9 @@ module Aws::RDS
403
406
 
404
407
  # The AWS KMS key identifier used for encrypting messages in the
405
408
  # database activity stream.
409
+ #
410
+ # The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias
411
+ # name for the AWS KMS customer master key (CMK).
406
412
  # @return [String]
407
413
  def activity_stream_kms_key_id
408
414
  data[:activity_stream_kms_key_id]
@@ -808,30 +814,27 @@ module Aws::RDS
808
814
  # @option options [String] :kms_key_id
809
815
  # The AWS KMS key identifier for an encrypted DB cluster.
810
816
  #
811
- # The KMS key identifier is the Amazon Resource Name (ARN) for the KMS
812
- # encryption key. If you are creating a DB cluster with the same AWS
813
- # account that owns the KMS encryption key used to encrypt the new DB
814
- # cluster, then you can use the KMS key alias instead of the ARN for the
815
- # KMS encryption key.
817
+ # The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias
818
+ # name for the AWS KMS customer master key (CMK). To use a CMK in a
819
+ # different AWS account, specify the key ARN or alias ARN.
816
820
  #
817
- # If an encryption key isn't specified in `KmsKeyId`\:
821
+ # When a CMK isn't specified in `KmsKeyId`\:
818
822
  #
819
823
  # * If `ReplicationSourceIdentifier` identifies an encrypted source,
820
- # then Amazon RDS will use the encryption key used to encrypt the
821
- # source. Otherwise, Amazon RDS will use your default encryption key.
824
+ # then Amazon RDS will use the CMK used to encrypt the source.
825
+ # Otherwise, Amazon RDS will use your default CMK.
822
826
  #
823
827
  # * If the `StorageEncrypted` parameter is enabled and
824
828
  # `ReplicationSourceIdentifier` isn't specified, then Amazon RDS will
825
- # use your default encryption key.
829
+ # use your default CMK.
826
830
  #
827
- # AWS KMS creates the default encryption key for your AWS account. Your
828
- # AWS account has a different default encryption key for each AWS
829
- # Region.
831
+ # There is a default CMK for your AWS account. Your AWS account has a
832
+ # different default CMK for each AWS Region.
830
833
  #
831
834
  # If you create a read replica of an encrypted DB cluster in another AWS
832
- # Region, you must set `KmsKeyId` to a KMS key ID that is valid in the
833
- # destination AWS Region. This key is used to encrypt the read replica
834
- # in that AWS Region.
835
+ # Region, you must set `KmsKeyId` to a AWS KMS key identifier that is
836
+ # valid in the destination AWS Region. This CMK is used to encrypt the
837
+ # read replica in that AWS Region.
835
838
  # @option options [String] :pre_signed_url
836
839
  # A URL that contains a Signature Version 4 signed request for the
837
840
  # `CreateDBCluster` action to be called in the source AWS Region where
@@ -848,9 +851,9 @@ module Aws::RDS
848
851
  #
849
852
  # * `KmsKeyId` - The AWS KMS key identifier for the key to use to
850
853
  # encrypt the copy of the DB cluster in the destination AWS Region.
851
- # This should refer to the same KMS key for both the `CreateDBCluster`
852
- # action that is called in the destination AWS Region, and the action
853
- # contained in the pre-signed URL.
854
+ # This should refer to the same AWS KMS CMK for both the
855
+ # `CreateDBCluster` action that is called in the destination AWS
856
+ # Region, and the action contained in the pre-signed URL.
854
857
  #
855
858
  # * `DestinationRegion` - The name of the AWS Region that Aurora read
856
859
  # replica will be created in.
@@ -1010,7 +1013,6 @@ module Aws::RDS
1010
1013
  # This parameter only applies to DB clusters that are secondary clusters
1011
1014
  # in an Aurora global database. By default, Aurora disallows write
1012
1015
  # operations for secondary clusters.
1013
- # @option options [String] :destination_region
1014
1016
  # @option options [String] :source_region
1015
1017
  # The source region of the snapshot. This is only needed when the
1016
1018
  # shapshot is encrypted and in a different region.
@@ -1525,23 +1527,21 @@ module Aws::RDS
1525
1527
  # The AWS KMS key identifier to use when restoring an encrypted DB
1526
1528
  # cluster from an encrypted DB cluster.
1527
1529
  #
1528
- # The KMS key identifier is the Amazon Resource Name (ARN) for the KMS
1529
- # encryption key. If you are restoring a DB cluster with the same AWS
1530
- # account that owns the KMS encryption key used to encrypt the new DB
1531
- # cluster, then you can use the KMS key alias instead of the ARN for the
1532
- # KMS encryption key.
1530
+ # The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias
1531
+ # name for the AWS KMS customer master key (CMK). To use a CMK in a
1532
+ # different AWS account, specify the key ARN or alias ARN.
1533
1533
  #
1534
1534
  # You can restore to a new DB cluster and encrypt the new DB cluster
1535
- # with a KMS key that is different than the KMS key used to encrypt the
1536
- # source DB cluster. The new DB cluster is encrypted with the KMS key
1537
- # identified by the `KmsKeyId` parameter.
1535
+ # with a AWS KMS CMK that is different than the AWS KMS key used to
1536
+ # encrypt the source DB cluster. The new DB cluster is encrypted with
1537
+ # the AWS KMS CMK identified by the `KmsKeyId` parameter.
1538
1538
  #
1539
1539
  # If you don't specify a value for the `KmsKeyId` parameter, then the
1540
1540
  # following occurs:
1541
1541
  #
1542
1542
  # * If the DB cluster is encrypted, then the restored DB cluster is
1543
- # encrypted using the KMS key that was used to encrypt the source DB
1544
- # cluster.
1543
+ # encrypted using the AWS KMS CMK that was used to encrypt the source
1544
+ # DB cluster.
1545
1545
  #
1546
1546
  # * If the DB cluster isn't encrypted, then the restored DB cluster
1547
1547
  # isn't encrypted.
@@ -136,6 +136,9 @@ module Aws::RDS
136
136
 
137
137
  # If `StorageEncrypted` is true, the AWS KMS key identifier for the
138
138
  # encrypted DB cluster snapshot.
139
+ #
140
+ # The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias
141
+ # name for the AWS KMS customer master key (CMK).
139
142
  # @return [String]
140
143
  def kms_key_id
141
144
  data[:kms_key_id]
@@ -365,25 +368,25 @@ module Aws::RDS
365
368
  #
366
369
  # Example: `my-cluster-snapshot2`
367
370
  # @option options [String] :kms_key_id
368
- # The AWS KMS key ID for an encrypted DB cluster snapshot. The KMS key
369
- # ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS
370
- # key alias for the KMS encryption key.
371
+ # The AWS KMS key identifier for an encrypted DB cluster snapshot. The
372
+ # AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias
373
+ # name for the AWS KMS customer master key (CMK).
371
374
  #
372
375
  # If you copy an encrypted DB cluster snapshot from your AWS account,
373
376
  # you can specify a value for `KmsKeyId` to encrypt the copy with a new
374
- # KMS encryption key. If you don't specify a value for `KmsKeyId`, then
375
- # the copy of the DB cluster snapshot is encrypted with the same KMS key
377
+ # AWS KMS CMK. If you don't specify a value for `KmsKeyId`, then the
378
+ # copy of the DB cluster snapshot is encrypted with the same AWS KMS key
376
379
  # as the source DB cluster snapshot.
377
380
  #
378
381
  # If you copy an encrypted DB cluster snapshot that is shared from
379
382
  # another AWS account, then you must specify a value for `KmsKeyId`.
380
383
  #
381
384
  # To copy an encrypted DB cluster snapshot to another AWS Region, you
382
- # must set `KmsKeyId` to the KMS key ID you want to use to encrypt the
383
- # copy of the DB cluster snapshot in the destination AWS Region. KMS
384
- # encryption keys are specific to the AWS Region that they are created
385
- # in, and you can't use encryption keys from one AWS Region in another
386
- # AWS Region.
385
+ # must set `KmsKeyId` to the AWS KMS key identifier you want to use to
386
+ # encrypt the copy of the DB cluster snapshot in the destination AWS
387
+ # Region. AWS KMS CMKs are specific to the AWS Region that they are
388
+ # created in, and you can't use CMKs from one AWS Region in another AWS
389
+ # Region.
387
390
  #
388
391
  # If you copy an unencrypted DB cluster snapshot and specify a value for
389
392
  # the `KmsKeyId` parameter, an error is returned.
@@ -401,9 +404,9 @@ module Aws::RDS
401
404
  # copied. The pre-signed URL request must contain the following
402
405
  # parameter values:
403
406
  #
404
- # * `KmsKeyId` - The AWS KMS key identifier for the key to use to
405
- # encrypt the copy of the DB cluster snapshot in the destination AWS
406
- # Region. This is the same identifier for both the
407
+ # * `KmsKeyId` - The AWS KMS key identifier for the customer master key
408
+ # (CMK) to use to encrypt the copy of the DB cluster snapshot in the
409
+ # destination AWS Region. This is the same identifier for both the
407
410
  # `CopyDBClusterSnapshot` action that is called in the destination AWS
408
411
  # Region, and the action contained in the pre-signed URL.
409
412
  #
@@ -446,7 +449,6 @@ module Aws::RDS
446
449
  #
447
450
  #
448
451
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html
449
- # @option options [String] :destination_region
450
452
  # @option options [String] :source_region
451
453
  # The source region of the snapshot. This is only needed when the
452
454
  # shapshot is encrypted and in a different region.
@@ -596,18 +598,17 @@ module Aws::RDS
596
598
  # The AWS KMS key identifier to use when restoring an encrypted DB
597
599
  # cluster from a DB snapshot or DB cluster snapshot.
598
600
  #
599
- # The KMS key identifier is the Amazon Resource Name (ARN) for the KMS
600
- # encryption key. If you are restoring a DB cluster with the same AWS
601
- # account that owns the KMS encryption key used to encrypt the new DB
602
- # cluster, then you can use the KMS key alias instead of the ARN for the
603
- # KMS encryption key.
601
+ # The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias
602
+ # name for the AWS KMS customer master key (CMK). To use a CMK in a
603
+ # different AWS account, specify the key ARN or alias ARN.
604
604
  #
605
- # If you don't specify a value for the `KmsKeyId` parameter, then the
605
+ # When you don't specify a value for the `KmsKeyId` parameter, then the
606
606
  # following occurs:
607
607
  #
608
608
  # * If the DB snapshot or DB cluster snapshot in `SnapshotIdentifier` is
609
- # encrypted, then the restored DB cluster is encrypted using the KMS
610
- # key that was used to encrypt the DB snapshot or DB cluster snapshot.
609
+ # encrypted, then the restored DB cluster is encrypted using the AWS
610
+ # KMS CMK that was used to encrypt the DB snapshot or DB cluster
611
+ # snapshot.
611
612
  #
612
613
  # * If the DB snapshot or DB cluster snapshot in `SnapshotIdentifier`
613
614
  # isn't encrypted, then the restored DB cluster isn't encrypted.
@@ -341,6 +341,9 @@ module Aws::RDS
341
341
 
342
342
  # If `StorageEncrypted` is true, the AWS KMS key identifier for the
343
343
  # encrypted DB instance.
344
+ #
345
+ # The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias
346
+ # name for the AWS KMS customer master key (CMK).
344
347
  # @return [String]
345
348
  def kms_key_id
346
349
  data[:kms_key_id]
@@ -348,7 +351,7 @@ module Aws::RDS
348
351
 
349
352
  # The AWS Region-unique, immutable identifier for the DB instance. This
350
353
  # identifier is found in AWS CloudTrail log entries whenever the AWS KMS
351
- # key for the DB instance is accessed.
354
+ # customer master key (CMK) for the DB instance is accessed.
352
355
  # @return [String]
353
356
  def dbi_resource_id
354
357
  data[:dbi_resource_id]
@@ -454,8 +457,10 @@ module Aws::RDS
454
457
  end
455
458
 
456
459
  # The AWS KMS key identifier for encryption of Performance Insights
457
- # data. The KMS key ID is the Amazon Resource Name (ARN), KMS key
458
- # identifier, or the KMS key alias for the KMS encryption key.
460
+ # data.
461
+ #
462
+ # The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias
463
+ # name for the AWS KMS customer master key (CMK).
459
464
  # @return [String]
460
465
  def performance_insights_kms_key_id
461
466
  data[:performance_insights_kms_key_id]
@@ -533,6 +538,13 @@ module Aws::RDS
533
538
  data[:tag_list]
534
539
  end
535
540
 
541
+ # The list of replicated automated backups associated with the DB
542
+ # instance.
543
+ # @return [Array<Types::DBInstanceAutomatedBackupsReplication>]
544
+ def db_instance_automated_backups_replications
545
+ data[:db_instance_automated_backups_replications]
546
+ end
547
+
536
548
  # @!endgroup
537
549
 
538
550
  # @return [Client]
@@ -1355,22 +1367,19 @@ module Aws::RDS
1355
1367
  # @option options [String] :kms_key_id
1356
1368
  # The AWS KMS key identifier for an encrypted DB instance.
1357
1369
  #
1358
- # The KMS key identifier is the Amazon Resource Name (ARN) for the KMS
1359
- # encryption key. If you are creating a DB instance with the same AWS
1360
- # account that owns the KMS encryption key used to encrypt the new DB
1361
- # instance, then you can use the KMS key alias instead of the ARN for
1362
- # the KM encryption key.
1370
+ # The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias
1371
+ # name for the AWS KMS customer master key (CMK). To use a CMK in a
1372
+ # different AWS account, specify the key ARN or alias ARN.
1363
1373
  #
1364
1374
  # **Amazon Aurora**
1365
1375
  #
1366
- # Not applicable. The KMS key identifier is managed by the DB cluster.
1367
- # For more information, see `CreateDBCluster`.
1376
+ # Not applicable. The AWS KMS key identifier is managed by the DB
1377
+ # cluster. For more information, see `CreateDBCluster`.
1368
1378
  #
1369
1379
  # If `StorageEncrypted` is enabled, and you do not specify a value for
1370
- # the `KmsKeyId` parameter, then Amazon RDS will use your default
1371
- # encryption key. AWS KMS creates the default encryption key for your
1372
- # AWS account. Your AWS account has a different default encryption key
1373
- # for each AWS Region.
1380
+ # the `KmsKeyId` parameter, then Amazon RDS uses your default CMK. There
1381
+ # is a default CMK for your AWS account. Your AWS account has a
1382
+ # different default CMK for each AWS Region.
1374
1383
  # @option options [String] :domain
1375
1384
  # The Active Directory directory ID to create the DB instance in.
1376
1385
  # Currently, only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
@@ -1462,13 +1471,15 @@ module Aws::RDS
1462
1471
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
1463
1472
  # @option options [String] :performance_insights_kms_key_id
1464
1473
  # The AWS KMS key identifier for encryption of Performance Insights
1465
- # data. The KMS key ID is the Amazon Resource Name (ARN), KMS key
1466
- # identifier, or the KMS key alias for the KMS encryption key.
1474
+ # data.
1475
+ #
1476
+ # The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias
1477
+ # name for the AWS KMS customer master key (CMK).
1467
1478
  #
1468
1479
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
1469
- # Amazon RDS uses your default encryption key. AWS KMS creates the
1470
- # default encryption key for your AWS account. Your AWS account has a
1471
- # different default encryption key for each AWS Region.
1480
+ # Amazon RDS uses your default CMK. There is a default CMK for your AWS
1481
+ # account. Your AWS account has a different default CMK for each AWS
1482
+ # Region.
1472
1483
  # @option options [Integer] :performance_insights_retention_period
1473
1484
  # The amount of time, in days, to retain Performance Insights data.
1474
1485
  # Valid values are 7 or 731 (2 years).
@@ -1747,20 +1758,21 @@ module Aws::RDS
1747
1758
  #
1748
1759
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.html#USER_Monitoring.OS.IAMRole
1749
1760
  # @option options [String] :kms_key_id
1750
- # The AWS KMS key ID for an encrypted read replica. The KMS key ID is
1751
- # the Amazon Resource Name (ARN), KMS key identifier, or the KMS key
1752
- # alias for the KMS encryption key.
1761
+ # The AWS KMS key identifier for an encrypted read replica.
1762
+ #
1763
+ # The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias
1764
+ # name for the AWS KMS CMK.
1753
1765
  #
1754
1766
  # If you create an encrypted read replica in the same AWS Region as the
1755
1767
  # source DB instance, then you do not have to specify a value for this
1756
- # parameter. The read replica is encrypted with the same KMS key as the
1757
- # source DB instance.
1768
+ # parameter. The read replica is encrypted with the same AWS KMS CMK as
1769
+ # the source DB instance.
1758
1770
  #
1759
1771
  # If you create an encrypted read replica in a different AWS Region,
1760
- # then you must specify a KMS key for the destination AWS Region. KMS
1761
- # encryption keys are specific to the AWS Region that they are created
1762
- # in, and you can't use encryption keys from one AWS Region in another
1763
- # AWS Region.
1772
+ # then you must specify a AWS KMS key identifier for the destination AWS
1773
+ # Region. AWS KMS CMKs are specific to the AWS Region that they are
1774
+ # created in, and you can't use CMKs from one AWS Region in another AWS
1775
+ # Region.
1764
1776
  #
1765
1777
  # You can't create an encrypted read replica from an unencrypted DB
1766
1778
  # instance.
@@ -1849,13 +1861,15 @@ module Aws::RDS
1849
1861
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
1850
1862
  # @option options [String] :performance_insights_kms_key_id
1851
1863
  # The AWS KMS key identifier for encryption of Performance Insights
1852
- # data. The KMS key ID is the Amazon Resource Name (ARN), KMS key
1853
- # identifier, or the KMS key alias for the KMS encryption key.
1864
+ # data.
1865
+ #
1866
+ # The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias
1867
+ # name for the AWS KMS customer master key (CMK).
1854
1868
  #
1855
1869
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
1856
- # Amazon RDS uses your default encryption key. AWS KMS creates the
1857
- # default encryption key for your AWS account. Your AWS account has a
1858
- # different default encryption key for each AWS Region.
1870
+ # Amazon RDS uses your default CMK. There is a default CMK for your AWS
1871
+ # account. Your AWS account has a different default CMK for each AWS
1872
+ # Region.
1859
1873
  # @option options [Integer] :performance_insights_retention_period
1860
1874
  # The amount of time, in days, to retain Performance Insights data.
1861
1875
  # Valid values are 7 or 731 (2 years).
@@ -1921,7 +1935,6 @@ module Aws::RDS
1921
1935
  # @option options [Integer] :max_allocated_storage
1922
1936
  # The upper limit to which Amazon RDS can automatically scale the
1923
1937
  # storage of the DB instance.
1924
- # @option options [String] :destination_region
1925
1938
  # @option options [String] :source_region
1926
1939
  # The source region of the snapshot. This is only needed when the
1927
1940
  # shapshot is encrypted and in a different region.
@@ -2597,13 +2610,15 @@ module Aws::RDS
2597
2610
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
2598
2611
  # @option options [String] :performance_insights_kms_key_id
2599
2612
  # The AWS KMS key identifier for encryption of Performance Insights
2600
- # data. The KMS key ID is the Amazon Resource Name (ARN), KMS key
2601
- # identifier, or the KMS key alias for the KMS encryption key.
2613
+ # data.
2614
+ #
2615
+ # The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias
2616
+ # name for the AWS KMS customer master key (CMK).
2602
2617
  #
2603
2618
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
2604
- # Amazon RDS uses your default encryption key. AWS KMS creates the
2605
- # default encryption key for your AWS account. Your AWS account has a
2606
- # different default encryption key for each AWS Region.
2619
+ # Amazon RDS uses your default CMK. There is a default CMK for your AWS
2620
+ # account. Your AWS account has a different default CMK for each AWS
2621
+ # Region.
2607
2622
  # @option options [Integer] :performance_insights_retention_period
2608
2623
  # The amount of time, in days, to retain Performance Insights data.
2609
2624
  # Valid values are 7 or 731 (2 years).
@@ -2809,6 +2824,7 @@ module Aws::RDS
2809
2824
  # deletion_protection: false,
2810
2825
  # source_dbi_resource_id: "String",
2811
2826
  # max_allocated_storage: 1,
2827
+ # source_db_instance_automated_backups_arn: "String",
2812
2828
  # })
2813
2829
  # @param [Hash] options ({})
2814
2830
  # @option options [required, String] :target_db_instance_identifier
@@ -3061,6 +3077,10 @@ module Aws::RDS
3061
3077
  # @option options [Integer] :max_allocated_storage
3062
3078
  # The upper limit to which Amazon RDS can automatically scale the
3063
3079
  # storage of the DB instance.
3080
+ # @option options [String] :source_db_instance_automated_backups_arn
3081
+ # The Amazon Resource Name (ARN) of the replicated automated backups
3082
+ # from which to restore, for example,
3083
+ # `arn:aws:rds:useast-1:123456789012:auto-backup:ab-L2IJCEXJP7XQ7HOJ4SIEXAMPLE`.
3064
3084
  # @return [DBInstance]
3065
3085
  def restore(options = {})
3066
3086
  options = options.merge(source_db_instance_identifier: @id)