aws-sdk-docdb 1.40.0 → 1.43.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.
@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
27
27
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
28
28
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
29
  require 'aws-sdk-core/plugins/http_checksum.rb'
30
+ require 'aws-sdk-core/plugins/checksum_algorithm.rb'
30
31
  require 'aws-sdk-core/plugins/defaults_mode.rb'
31
32
  require 'aws-sdk-core/plugins/recursion_detection.rb'
32
33
  require 'aws-sdk-core/plugins/signature_v4.rb'
@@ -76,6 +77,7 @@ module Aws::DocDB
76
77
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
77
78
  add_plugin(Aws::Plugins::TransferEncoding)
78
79
  add_plugin(Aws::Plugins::HttpChecksum)
80
+ add_plugin(Aws::Plugins::ChecksumAlgorithm)
79
81
  add_plugin(Aws::Plugins::DefaultsMode)
80
82
  add_plugin(Aws::Plugins::RecursionDetection)
81
83
  add_plugin(Aws::Plugins::SignatureV4)
@@ -511,12 +513,14 @@ module Aws::DocDB
511
513
  #
512
514
  # * Must specify a valid cluster parameter group.
513
515
  #
514
- # * If the source cluster parameter group is in the same Region as the
515
- # copy, specify a valid parameter group identifier; for example,
516
- # `my-db-cluster-param-group`, or a valid ARN.
516
+ # * If the source cluster parameter group is in the same Amazon Web
517
+ # Services Region as the copy, specify a valid parameter group
518
+ # identifier; for example, `my-db-cluster-param-group`, or a valid
519
+ # ARN.
517
520
  #
518
- # * If the source parameter group is in a different Region than the
519
- # copy, specify a valid cluster parameter group ARN; for example,
521
+ # * If the source parameter group is in a different Amazon Web Services
522
+ # Region than the copy, specify a valid cluster parameter group ARN;
523
+ # for example,
520
524
  # `arn:aws:rds:us-east-1:123456789012:sample-cluster:sample-parameter-group`.
521
525
  #
522
526
  # @option params [required, String] :target_db_cluster_parameter_group_identifier
@@ -579,7 +583,8 @@ module Aws::DocDB
579
583
  # To copy a cluster snapshot from a shared manual cluster snapshot,
580
584
  # `SourceDBClusterSnapshotIdentifier` must be the Amazon Resource Name
581
585
  # (ARN) of the shared cluster snapshot. You can only copy a shared DB
582
- # cluster snapshot, whether encrypted or not, in the same Region.
586
+ # cluster snapshot, whether encrypted or not, in the same Amazon Web
587
+ # Services Region.
583
588
  #
584
589
  # To cancel the copy operation after it is in progress, delete the
585
590
  # target cluster snapshot identified by
@@ -594,11 +599,11 @@ module Aws::DocDB
594
599
  #
595
600
  # * Must specify a valid system snapshot in the *available* state.
596
601
  #
597
- # * If the source snapshot is in the same Region as the copy, specify a
598
- # valid snapshot identifier.
602
+ # * If the source snapshot is in the same Amazon Web Services Region as
603
+ # the copy, specify a valid snapshot identifier.
599
604
  #
600
- # * If the source snapshot is in a different Region than the copy,
601
- # specify a valid cluster snapshot ARN.
605
+ # * If the source snapshot is in a different Amazon Web Services Region
606
+ # than the copy, specify a valid cluster snapshot ARN.
602
607
  #
603
608
  # Example: `my-cluster-snapshot1`
604
609
  #
@@ -621,50 +626,56 @@ module Aws::DocDB
621
626
  # the Amazon Resource Name (ARN), KMS key identifier, or the KMS key
622
627
  # alias for the KMS encryption key.
623
628
  #
624
- # If you copy an encrypted cluster snapshot from your account, you can
625
- # specify a value for `KmsKeyId` to encrypt the copy with a new KMS
626
- # encryption key. If you don't specify a value for `KmsKeyId`, then the
627
- # copy of the cluster snapshot is encrypted with the same KMS key as the
628
- # source cluster snapshot.
629
+ # If you copy an encrypted cluster snapshot from your Amazon Web
630
+ # Services account, you can specify a value for `KmsKeyId` to encrypt
631
+ # the copy with a new KMS encryption key. If you don't specify a value
632
+ # for `KmsKeyId`, then the copy of the cluster snapshot is encrypted
633
+ # with the same KMS key as the source cluster snapshot.
629
634
  #
630
635
  # If you copy an encrypted cluster snapshot that is shared from another
631
- # account, then you must specify a value for `KmsKeyId`.
636
+ # Amazon Web Services account, then you must specify a value for
637
+ # `KmsKeyId`.
632
638
  #
633
- # To copy an encrypted cluster snapshot to another Region, set
634
- # `KmsKeyId` to the KMS key ID that you want to use to encrypt the copy
635
- # of the cluster snapshot in the destination Region. KMS encryption keys
636
- # are specific to the Region that they are created in, and you can't
637
- # use encryption keys from one Region in another Region.
639
+ # To copy an encrypted cluster snapshot to another Amazon Web Services
640
+ # Region, set `KmsKeyId` to the KMS key ID that you want to use to
641
+ # encrypt the copy of the cluster snapshot in the destination Region.
642
+ # KMS encryption keys are specific to the Amazon Web Services Region
643
+ # that they are created in, and you can't use encryption keys from one
644
+ # Amazon Web Services Region in another Amazon Web Services Region.
638
645
  #
639
646
  # If you copy an unencrypted cluster snapshot and specify a value for
640
647
  # the `KmsKeyId` parameter, an error is returned.
641
648
  #
642
649
  # @option params [String] :pre_signed_url
643
650
  # The URL that contains a Signature Version 4 signed request for
644
- # the`CopyDBClusterSnapshot` API action in the Region that contains the
645
- # source cluster snapshot to copy. You must use the `PreSignedUrl`
646
- # parameter when copying a cluster snapshot from another Region.
651
+ # the`CopyDBClusterSnapshot` API action in the Amazon Web Services
652
+ # Region that contains the source cluster snapshot to copy. You must use
653
+ # the `PreSignedUrl` parameter when copying a cluster snapshot from
654
+ # another Amazon Web Services Region.
647
655
  #
648
656
  # If you are using an Amazon Web Services SDK tool or the CLI, you can
649
657
  # specify `SourceRegion` (or `--source-region` for the CLI) instead of
650
658
  # specifying `PreSignedUrl` manually. Specifying `SourceRegion`
651
659
  # autogenerates a pre-signed URL that is a valid request for the
652
- # operation that can be executed in the source Region.
660
+ # operation that can be executed in the source Amazon Web Services
661
+ # Region.
653
662
  #
654
663
  # The presigned URL must be a valid request for the
655
664
  # `CopyDBClusterSnapshot` API action that can be executed in the source
656
- # Region that contains the cluster snapshot to be copied. The presigned
657
- # URL request must contain the following parameter values:
665
+ # Amazon Web Services Region that contains the cluster snapshot to be
666
+ # copied. The presigned URL request must contain the following parameter
667
+ # values:
658
668
  #
659
669
  # * `SourceRegion` - The ID of the region that contains the snapshot to
660
670
  # be copied.
661
671
  #
662
672
  # * `SourceDBClusterSnapshotIdentifier` - The identifier for the the
663
673
  # encrypted cluster snapshot to be copied. This identifier must be in
664
- # the Amazon Resource Name (ARN) format for the source Region. For
665
- # example, if you are copying an encrypted cluster snapshot from the
666
- # us-east-1 Region, then your `SourceDBClusterSnapshotIdentifier`
667
- # looks something like the following:
674
+ # the Amazon Resource Name (ARN) format for the source Amazon Web
675
+ # Services Region. For example, if you are copying an encrypted
676
+ # cluster snapshot from the us-east-1 Amazon Web Services Region, then
677
+ # your `SourceDBClusterSnapshotIdentifier` looks something like the
678
+ # following:
668
679
  # `arn:aws:rds:us-east-1:12345678012:sample-cluster:sample-cluster-snapshot`.
669
680
  #
670
681
  # * `TargetDBClusterSnapshotIdentifier` - The identifier for the new
@@ -820,7 +831,7 @@ module Aws::DocDB
820
831
  # parameter.
821
832
  #
822
833
  # The default is a 30-minute window selected at random from an 8-hour
823
- # block of time for each Region.
834
+ # block of time for each Amazon Web Services Region.
824
835
  #
825
836
  # Constraints:
826
837
  #
@@ -839,7 +850,8 @@ module Aws::DocDB
839
850
  # Format: `ddd:hh24:mi-ddd:hh24:mi`
840
851
  #
841
852
  # The default is a 30-minute window selected at random from an 8-hour
842
- # block of time for each Region, occurring on a random day of the week.
853
+ # block of time for each Amazon Web Services Region, occurring on a
854
+ # random day of the week.
843
855
  #
844
856
  # Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
845
857
  #
@@ -855,10 +867,10 @@ module Aws::DocDB
855
867
  # The KMS key identifier for an encrypted cluster.
856
868
  #
857
869
  # The KMS key identifier is the Amazon Resource Name (ARN) for the KMS
858
- # encryption key. If you are creating a cluster using the same account
859
- # that owns the KMS encryption key that is used to encrypt the new
860
- # cluster, you can use the KMS key alias instead of the ARN for the KMS
861
- # encryption key.
870
+ # encryption key. If you are creating a cluster using the same Amazon
871
+ # Web Services account that owns the KMS encryption key that is used to
872
+ # encrypt the new cluster, you can use the KMS key alias instead of the
873
+ # ARN for the KMS encryption key.
862
874
  #
863
875
  # If an encryption key is not specified in `KmsKeyId`\:
864
876
  #
@@ -867,8 +879,9 @@ module Aws::DocDB
867
879
  #
868
880
  # ^
869
881
  #
870
- # KMS creates the default encryption key for your account. Your account
871
- # has a different default encryption key for each Regions.
882
+ # KMS creates the default encryption key for your Amazon Web Services
883
+ # account. Your Amazon Web Services account has a different default
884
+ # encryption key for each Amazon Web Services Regions.
872
885
  #
873
886
  # @option params [String] :pre_signed_url
874
887
  # Not currently supported.
@@ -972,6 +985,7 @@ module Aws::DocDB
972
985
  # resp.db_cluster.associated_roles #=> Array
973
986
  # resp.db_cluster.associated_roles[0].role_arn #=> String
974
987
  # resp.db_cluster.associated_roles[0].status #=> String
988
+ # resp.db_cluster.clone_group_id #=> String
975
989
  # resp.db_cluster.cluster_create_time #=> Time
976
990
  # resp.db_cluster.enabled_cloudwatch_logs_exports #=> Array
977
991
  # resp.db_cluster.enabled_cloudwatch_logs_exports[0] #=> String
@@ -1173,7 +1187,7 @@ module Aws::DocDB
1173
1187
  # The Amazon EC2 Availability Zone that the instance is created in.
1174
1188
  #
1175
1189
  # Default: A random, system-chosen Availability Zone in the endpoint's
1176
- # Region.
1190
+ # Amazon Web Services Region.
1177
1191
  #
1178
1192
  # Example: `us-east-1d`
1179
1193
  #
@@ -1184,7 +1198,8 @@ module Aws::DocDB
1184
1198
  # Format: `ddd:hh24:mi-ddd:hh24:mi`
1185
1199
  #
1186
1200
  # The default is a 30-minute window selected at random from an 8-hour
1187
- # block of time for each Region, occurring on a random day of the week.
1201
+ # block of time for each Amazon Web Services Region, occurring on a
1202
+ # random day of the week.
1188
1203
  #
1189
1204
  # Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
1190
1205
  #
@@ -1203,6 +1218,10 @@ module Aws::DocDB
1203
1218
  # @option params [required, String] :db_cluster_identifier
1204
1219
  # The identifier of the cluster that the instance will belong to.
1205
1220
  #
1221
+ # @option params [Boolean] :copy_tags_to_snapshot
1222
+ # A value that indicates whether to copy tags from the DB instance to
1223
+ # snapshots of the DB instance. By default, tags are not copied.
1224
+ #
1206
1225
  # @option params [Integer] :promotion_tier
1207
1226
  # A value that specifies the order in which an Amazon DocumentDB replica
1208
1227
  # is promoted to the primary instance after a failure of the existing
@@ -1212,6 +1231,27 @@ module Aws::DocDB
1212
1231
  #
1213
1232
  # Valid values: 0-15
1214
1233
  #
1234
+ # @option params [Boolean] :enable_performance_insights
1235
+ # A value that indicates whether to enable Performance Insights for the
1236
+ # DB Instance. For more information, see [Using Amazon Performance
1237
+ # Insights][1].
1238
+ #
1239
+ #
1240
+ #
1241
+ # [1]: https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html
1242
+ #
1243
+ # @option params [String] :performance_insights_kms_key_id
1244
+ # The KMS key identifier for encryption of Performance Insights data.
1245
+ #
1246
+ # The KMS key identifier is the key ARN, key ID, alias ARN, or alias
1247
+ # name for the KMS key.
1248
+ #
1249
+ # If you do not specify a value for PerformanceInsightsKMSKeyId, then
1250
+ # Amazon DocumentDB uses your default KMS key. There is a default KMS
1251
+ # key for your Amazon Web Services account. Your Amazon Web Services
1252
+ # account has a different default KMS key for each Amazon Web Services
1253
+ # region.
1254
+ #
1215
1255
  # @return [Types::CreateDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1216
1256
  #
1217
1257
  # * {Types::CreateDBInstanceResult#db_instance #db_instance} => Types::DBInstance
@@ -1232,7 +1272,10 @@ module Aws::DocDB
1232
1272
  # },
1233
1273
  # ],
1234
1274
  # db_cluster_identifier: "String", # required
1275
+ # copy_tags_to_snapshot: false,
1235
1276
  # promotion_tier: 1,
1277
+ # enable_performance_insights: false,
1278
+ # performance_insights_kms_key_id: "String",
1236
1279
  # })
1237
1280
  #
1238
1281
  # @example Response structure
@@ -1292,6 +1335,7 @@ module Aws::DocDB
1292
1335
  # resp.db_instance.kms_key_id #=> String
1293
1336
  # resp.db_instance.dbi_resource_id #=> String
1294
1337
  # resp.db_instance.ca_certificate_identifier #=> String
1338
+ # resp.db_instance.copy_tags_to_snapshot #=> Boolean
1295
1339
  # resp.db_instance.promotion_tier #=> Integer
1296
1340
  # resp.db_instance.db_instance_arn #=> String
1297
1341
  # resp.db_instance.enabled_cloudwatch_logs_exports #=> Array
@@ -1307,7 +1351,8 @@ module Aws::DocDB
1307
1351
  end
1308
1352
 
1309
1353
  # Creates a new subnet group. subnet groups must contain at least one
1310
- # subnet in at least two Availability Zones in the Region.
1354
+ # subnet in at least two Availability Zones in the Amazon Web Services
1355
+ # Region.
1311
1356
  #
1312
1357
  # @option params [required, String] :db_subnet_group_name
1313
1358
  # The name for the subnet group. This value is stored as a lowercase
@@ -1490,11 +1535,12 @@ module Aws::DocDB
1490
1535
  end
1491
1536
 
1492
1537
  # Creates an Amazon DocumentDB global cluster that can span multiple
1493
- # multiple Regions. The global cluster contains one primary cluster with
1494
- # read-write capability, and up-to give read-only secondary clusters.
1495
- # Global clusters uses storage-based fast replication across regions
1496
- # with latencies less than one second, using dedicated infrastructure
1497
- # with no impact to your workload’s performance.
1538
+ # multiple Amazon Web Services Regions. The global cluster contains one
1539
+ # primary cluster with read-write capability, and up-to give read-only
1540
+ # secondary clusters. Global clusters uses storage-based fast
1541
+ # replication across regions with latencies less than one second, using
1542
+ # dedicated infrastructure with no impact to your workload’s
1543
+ # performance.
1498
1544
  #
1499
1545
  #
1500
1546
  #
@@ -1671,6 +1717,7 @@ module Aws::DocDB
1671
1717
  # resp.db_cluster.associated_roles #=> Array
1672
1718
  # resp.db_cluster.associated_roles[0].role_arn #=> String
1673
1719
  # resp.db_cluster.associated_roles[0].status #=> String
1720
+ # resp.db_cluster.clone_group_id #=> String
1674
1721
  # resp.db_cluster.cluster_create_time #=> Time
1675
1722
  # resp.db_cluster.enabled_cloudwatch_logs_exports #=> Array
1676
1723
  # resp.db_cluster.enabled_cloudwatch_logs_exports[0] #=> String
@@ -1848,6 +1895,7 @@ module Aws::DocDB
1848
1895
  # resp.db_instance.kms_key_id #=> String
1849
1896
  # resp.db_instance.dbi_resource_id #=> String
1850
1897
  # resp.db_instance.ca_certificate_identifier #=> String
1898
+ # resp.db_instance.copy_tags_to_snapshot #=> Boolean
1851
1899
  # resp.db_instance.promotion_tier #=> Integer
1852
1900
  # resp.db_instance.db_instance_arn #=> String
1853
1901
  # resp.db_instance.enabled_cloudwatch_logs_exports #=> Array
@@ -1988,7 +2036,7 @@ module Aws::DocDB
1988
2036
  end
1989
2037
 
1990
2038
  # Returns a list of certificate authority (CA) certificates provided by
1991
- # Amazon DocumentDB for this account.
2039
+ # Amazon DocumentDB for this Amazon Web Services account.
1992
2040
  #
1993
2041
  # @option params [String] :certificate_identifier
1994
2042
  # The user-supplied certificate identifier. If this parameter is
@@ -2223,12 +2271,13 @@ module Aws::DocDB
2223
2271
  # Returns a list of cluster snapshot attribute names and values for a
2224
2272
  # manual DB cluster snapshot.
2225
2273
  #
2226
- # When you share snapshots with other accounts,
2274
+ # When you share snapshots with other Amazon Web Services accounts,
2227
2275
  # `DescribeDBClusterSnapshotAttributes` returns the `restore` attribute
2228
- # and a list of IDs for the accounts that are authorized to copy or
2229
- # restore the manual cluster snapshot. If `all` is included in the list
2230
- # of values for the `restore` attribute, then the manual cluster
2231
- # snapshot is public and can be copied or restored by all accounts.
2276
+ # and a list of IDs for the Amazon Web Services accounts that are
2277
+ # authorized to copy or restore the manual cluster snapshot. If `all` is
2278
+ # included in the list of values for the `restore` attribute, then the
2279
+ # manual cluster snapshot is public and can be copied or restored by all
2280
+ # Amazon Web Services accounts.
2232
2281
  #
2233
2282
  # @option params [required, String] :db_cluster_snapshot_identifier
2234
2283
  # The identifier for the cluster snapshot to describe the attributes
@@ -2293,13 +2342,13 @@ module Aws::DocDB
2293
2342
  # the following values:
2294
2343
  #
2295
2344
  # * `automated` - Return all cluster snapshots that Amazon DocumentDB
2296
- # has automatically created for your account.
2345
+ # has automatically created for your Amazon Web Services account.
2297
2346
  #
2298
2347
  # * `manual` - Return all cluster snapshots that you have manually
2299
- # created for your account.
2348
+ # created for your Amazon Web Services account.
2300
2349
  #
2301
2350
  # * `shared` - Return all manual cluster snapshots that have been shared
2302
- # to your account.
2351
+ # to your Amazon Web Services account.
2303
2352
  #
2304
2353
  # * `public` - Return all cluster snapshots that have been marked as
2305
2354
  # public.
@@ -2336,13 +2385,14 @@ module Aws::DocDB
2336
2385
  #
2337
2386
  # @option params [Boolean] :include_shared
2338
2387
  # Set to `true` to include shared manual cluster snapshots from other
2339
- # accounts that this account has been given permission to copy or
2340
- # restore, and otherwise `false`. The default is `false`.
2388
+ # Amazon Web Services accounts that this Amazon Web Services account has
2389
+ # been given permission to copy or restore, and otherwise `false`. The
2390
+ # default is `false`.
2341
2391
  #
2342
2392
  # @option params [Boolean] :include_public
2343
2393
  # Set to `true` to include manual cluster snapshots that are public and
2344
- # can be copied or restored by any account, and otherwise `false`. The
2345
- # default is `false`.
2394
+ # can be copied or restored by any Amazon Web Services account, and
2395
+ # otherwise `false`. The default is `false`.
2346
2396
  #
2347
2397
  # @return [Types::DBClusterSnapshotMessage] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2348
2398
  #
@@ -2508,6 +2558,7 @@ module Aws::DocDB
2508
2558
  # resp.db_clusters[0].associated_roles #=> Array
2509
2559
  # resp.db_clusters[0].associated_roles[0].role_arn #=> String
2510
2560
  # resp.db_clusters[0].associated_roles[0].status #=> String
2561
+ # resp.db_clusters[0].clone_group_id #=> String
2511
2562
  # resp.db_clusters[0].cluster_create_time #=> Time
2512
2563
  # resp.db_clusters[0].enabled_cloudwatch_logs_exports #=> Array
2513
2564
  # resp.db_clusters[0].enabled_cloudwatch_logs_exports[0] #=> String
@@ -2750,6 +2801,7 @@ module Aws::DocDB
2750
2801
  # resp.db_instances[0].kms_key_id #=> String
2751
2802
  # resp.db_instances[0].dbi_resource_id #=> String
2752
2803
  # resp.db_instances[0].ca_certificate_identifier #=> String
2804
+ # resp.db_instances[0].copy_tags_to_snapshot #=> Boolean
2753
2805
  # resp.db_instances[0].promotion_tier #=> Integer
2754
2806
  # resp.db_instances[0].db_instance_arn #=> String
2755
2807
  # resp.db_instances[0].enabled_cloudwatch_logs_exports #=> Array
@@ -3467,6 +3519,7 @@ module Aws::DocDB
3467
3519
  # resp.db_cluster.associated_roles #=> Array
3468
3520
  # resp.db_cluster.associated_roles[0].role_arn #=> String
3469
3521
  # resp.db_cluster.associated_roles[0].status #=> String
3522
+ # resp.db_cluster.clone_group_id #=> String
3470
3523
  # resp.db_cluster.cluster_create_time #=> Time
3471
3524
  # resp.db_cluster.enabled_cloudwatch_logs_exports #=> Array
3472
3525
  # resp.db_cluster.enabled_cloudwatch_logs_exports[0] #=> String
@@ -3605,7 +3658,7 @@ module Aws::DocDB
3605
3658
  # parameter.
3606
3659
  #
3607
3660
  # The default is a 30-minute window selected at random from an 8-hour
3608
- # block of time for each Region.
3661
+ # block of time for each Amazon Web Services Region.
3609
3662
  #
3610
3663
  # Constraints:
3611
3664
  #
@@ -3624,7 +3677,8 @@ module Aws::DocDB
3624
3677
  # Format: `ddd:hh24:mi-ddd:hh24:mi`
3625
3678
  #
3626
3679
  # The default is a 30-minute window selected at random from an 8-hour
3627
- # block of time for each Region, occurring on a random day of the week.
3680
+ # block of time for each Amazon Web Services Region, occurring on a
3681
+ # random day of the week.
3628
3682
  #
3629
3683
  # Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
3630
3684
  #
@@ -3712,6 +3766,7 @@ module Aws::DocDB
3712
3766
  # resp.db_cluster.associated_roles #=> Array
3713
3767
  # resp.db_cluster.associated_roles[0].role_arn #=> String
3714
3768
  # resp.db_cluster.associated_roles[0].status #=> String
3769
+ # resp.db_cluster.clone_group_id #=> String
3715
3770
  # resp.db_cluster.cluster_create_time #=> Time
3716
3771
  # resp.db_cluster.enabled_cloudwatch_logs_exports #=> Array
3717
3772
  # resp.db_cluster.enabled_cloudwatch_logs_exports[0] #=> String
@@ -3792,17 +3847,19 @@ module Aws::DocDB
3792
3847
  # Adds an attribute and values to, or removes an attribute and values
3793
3848
  # from, a manual cluster snapshot.
3794
3849
  #
3795
- # To share a manual cluster snapshot with other accounts, specify
3796
- # `restore` as the `AttributeName`, and use the `ValuesToAdd` parameter
3797
- # to add a list of IDs of the accounts that are authorized to restore
3798
- # the manual cluster snapshot. Use the value `all` to make the manual
3799
- # cluster snapshot public, which means that it can be copied or restored
3800
- # by all accounts. Do not add the `all` value for any manual cluster
3801
- # snapshots that contain private information that you don't want
3802
- # available to all accounts. If a manual cluster snapshot is encrypted,
3803
- # it can be shared, but only by specifying a list of authorized account
3804
- # IDs for the `ValuesToAdd` parameter. You can't use `all` as a value
3805
- # for that parameter in this case.
3850
+ # To share a manual cluster snapshot with other Amazon Web Services
3851
+ # accounts, specify `restore` as the `AttributeName`, and use the
3852
+ # `ValuesToAdd` parameter to add a list of IDs of the Amazon Web
3853
+ # Services accounts that are authorized to restore the manual cluster
3854
+ # snapshot. Use the value `all` to make the manual cluster snapshot
3855
+ # public, which means that it can be copied or restored by all Amazon
3856
+ # Web Services accounts. Do not add the `all` value for any manual
3857
+ # cluster snapshots that contain private information that you don't
3858
+ # want available to all Amazon Web Services accounts. If a manual
3859
+ # cluster snapshot is encrypted, it can be shared, but only by
3860
+ # specifying a list of authorized Amazon Web Services account IDs for
3861
+ # the `ValuesToAdd` parameter. You can't use `all` as a value for that
3862
+ # parameter in this case.
3806
3863
  #
3807
3864
  # @option params [required, String] :db_cluster_snapshot_identifier
3808
3865
  # The identifier for the cluster snapshot to modify the attributes for.
@@ -3810,29 +3867,31 @@ module Aws::DocDB
3810
3867
  # @option params [required, String] :attribute_name
3811
3868
  # The name of the cluster snapshot attribute to modify.
3812
3869
  #
3813
- # To manage authorization for other accounts to copy or restore a manual
3814
- # cluster snapshot, set this value to `restore`.
3870
+ # To manage authorization for other Amazon Web Services accounts to copy
3871
+ # or restore a manual cluster snapshot, set this value to `restore`.
3815
3872
  #
3816
3873
  # @option params [Array<String>] :values_to_add
3817
3874
  # A list of cluster snapshot attributes to add to the attribute
3818
3875
  # specified by `AttributeName`.
3819
3876
  #
3820
- # To authorize other accounts to copy or restore a manual cluster
3821
- # snapshot, set this list to include one or more account IDs. To make
3822
- # the manual cluster snapshot restorable by any account, set it to
3823
- # `all`. Do not add the `all` value for any manual cluster snapshots
3824
- # that contain private information that you don't want to be available
3825
- # to all accounts.
3877
+ # To authorize other Amazon Web Services accounts to copy or restore a
3878
+ # manual cluster snapshot, set this list to include one or more Amazon
3879
+ # Web Services account IDs. To make the manual cluster snapshot
3880
+ # restorable by any Amazon Web Services account, set it to `all`. Do not
3881
+ # add the `all` value for any manual cluster snapshots that contain
3882
+ # private information that you don't want to be available to all Amazon
3883
+ # Web Services accounts.
3826
3884
  #
3827
3885
  # @option params [Array<String>] :values_to_remove
3828
3886
  # A list of cluster snapshot attributes to remove from the attribute
3829
3887
  # specified by `AttributeName`.
3830
3888
  #
3831
- # To remove authorization for other accounts to copy or restore a manual
3832
- # cluster snapshot, set this list to include one or more account
3833
- # identifiers. To remove authorization for any account to copy or
3834
- # restore the cluster snapshot, set it to `all` . If you specify `all`,
3835
- # an account whose account ID is explicitly added to the `restore`
3889
+ # To remove authorization for other Amazon Web Services accounts to copy
3890
+ # or restore a manual cluster snapshot, set this list to include one or
3891
+ # more Amazon Web Services account identifiers. To remove authorization
3892
+ # for any Amazon Web Services account to copy or restore the cluster
3893
+ # snapshot, set it to `all` . If you specify `all`, an Amazon Web
3894
+ # Services account whose account ID is explicitly added to the `restore`
3836
3895
  # attribute can still copy or restore a manual cluster snapshot.
3837
3896
  #
3838
3897
  # @return [Types::ModifyDBClusterSnapshotAttributeResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -3880,7 +3939,8 @@ module Aws::DocDB
3880
3939
  #
3881
3940
  # @option params [String] :db_instance_class
3882
3941
  # The new compute and memory capacity of the instance; for example,
3883
- # `db.r5.large`. Not all instance classes are available in all Regions.
3942
+ # `db.r5.large`. Not all instance classes are available in all Amazon
3943
+ # Web Services Regions.
3884
3944
  #
3885
3945
  # If you modify the instance class, an outage occurs during the change.
3886
3946
  # The change is applied during the next maintenance window, unless
@@ -3944,6 +4004,10 @@ module Aws::DocDB
3944
4004
  # Indicates the certificate that needs to be associated with the
3945
4005
  # instance.
3946
4006
  #
4007
+ # @option params [Boolean] :copy_tags_to_snapshot
4008
+ # A value that indicates whether to copy all tags from the DB instance
4009
+ # to snapshots of the DB instance. By default, tags are not copied.
4010
+ #
3947
4011
  # @option params [Integer] :promotion_tier
3948
4012
  # A value that specifies the order in which an Amazon DocumentDB replica
3949
4013
  # is promoted to the primary instance after a failure of the existing
@@ -3953,6 +4017,27 @@ module Aws::DocDB
3953
4017
  #
3954
4018
  # Valid values: 0-15
3955
4019
  #
4020
+ # @option params [Boolean] :enable_performance_insights
4021
+ # A value that indicates whether to enable Performance Insights for the
4022
+ # DB Instance. For more information, see [Using Amazon Performance
4023
+ # Insights][1].
4024
+ #
4025
+ #
4026
+ #
4027
+ # [1]: https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html
4028
+ #
4029
+ # @option params [String] :performance_insights_kms_key_id
4030
+ # The KMS key identifier for encryption of Performance Insights data.
4031
+ #
4032
+ # The KMS key identifier is the key ARN, key ID, alias ARN, or alias
4033
+ # name for the KMS key.
4034
+ #
4035
+ # If you do not specify a value for PerformanceInsightsKMSKeyId, then
4036
+ # Amazon DocumentDB uses your default KMS key. There is a default KMS
4037
+ # key for your Amazon Web Services account. Your Amazon Web Services
4038
+ # account has a different default KMS key for each Amazon Web Services
4039
+ # region.
4040
+ #
3956
4041
  # @return [Types::ModifyDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3957
4042
  #
3958
4043
  # * {Types::ModifyDBInstanceResult#db_instance #db_instance} => Types::DBInstance
@@ -3967,7 +4052,10 @@ module Aws::DocDB
3967
4052
  # auto_minor_version_upgrade: false,
3968
4053
  # new_db_instance_identifier: "String",
3969
4054
  # ca_certificate_identifier: "String",
4055
+ # copy_tags_to_snapshot: false,
3970
4056
  # promotion_tier: 1,
4057
+ # enable_performance_insights: false,
4058
+ # performance_insights_kms_key_id: "String",
3971
4059
  # })
3972
4060
  #
3973
4061
  # @example Response structure
@@ -4027,6 +4115,7 @@ module Aws::DocDB
4027
4115
  # resp.db_instance.kms_key_id #=> String
4028
4116
  # resp.db_instance.dbi_resource_id #=> String
4029
4117
  # resp.db_instance.ca_certificate_identifier #=> String
4118
+ # resp.db_instance.copy_tags_to_snapshot #=> Boolean
4030
4119
  # resp.db_instance.promotion_tier #=> Integer
4031
4120
  # resp.db_instance.db_instance_arn #=> String
4032
4121
  # resp.db_instance.enabled_cloudwatch_logs_exports #=> Array
@@ -4042,7 +4131,8 @@ module Aws::DocDB
4042
4131
  end
4043
4132
 
4044
4133
  # Modifies an existing subnet group. subnet groups must contain at least
4045
- # one subnet in at least two Availability Zones in the Region.
4134
+ # one subnet in at least two Availability Zones in the Amazon Web
4135
+ # Services Region.
4046
4136
  #
4047
4137
  # @option params [required, String] :db_subnet_group_name
4048
4138
  # The name for the subnet group. This value is stored as a lowercase
@@ -4322,6 +4412,7 @@ module Aws::DocDB
4322
4412
  # resp.db_instance.kms_key_id #=> String
4323
4413
  # resp.db_instance.dbi_resource_id #=> String
4324
4414
  # resp.db_instance.ca_certificate_identifier #=> String
4415
+ # resp.db_instance.copy_tags_to_snapshot #=> Boolean
4325
4416
  # resp.db_instance.promotion_tier #=> Integer
4326
4417
  # resp.db_instance.db_instance_arn #=> String
4327
4418
  # resp.db_instance.enabled_cloudwatch_logs_exports #=> Array
@@ -4604,10 +4695,10 @@ module Aws::DocDB
4604
4695
  # a DB snapshot or cluster snapshot.
4605
4696
  #
4606
4697
  # The KMS key identifier is the Amazon Resource Name (ARN) for the KMS
4607
- # encryption key. If you are restoring a cluster with the same account
4608
- # that owns the KMS encryption key used to encrypt the new cluster, then
4609
- # you can use the KMS key alias instead of the ARN for the KMS
4610
- # encryption key.
4698
+ # encryption key. If you are restoring a cluster with the same Amazon
4699
+ # Web Services account that owns the KMS encryption key used to encrypt
4700
+ # the new cluster, then you can use the KMS key alias instead of the ARN
4701
+ # for the KMS encryption key.
4611
4702
  #
4612
4703
  # If you do not specify a value for the `KmsKeyId` parameter, then the
4613
4704
  # following occurs:
@@ -4695,6 +4786,7 @@ module Aws::DocDB
4695
4786
  # resp.db_cluster.associated_roles #=> Array
4696
4787
  # resp.db_cluster.associated_roles[0].role_arn #=> String
4697
4788
  # resp.db_cluster.associated_roles[0].status #=> String
4789
+ # resp.db_cluster.clone_group_id #=> String
4698
4790
  # resp.db_cluster.cluster_create_time #=> Time
4699
4791
  # resp.db_cluster.enabled_cloudwatch_logs_exports #=> Array
4700
4792
  # resp.db_cluster.enabled_cloudwatch_logs_exports[0] #=> String
@@ -4727,6 +4819,22 @@ module Aws::DocDB
4727
4819
  #
4728
4820
  # * Cannot end with a hyphen or contain two consecutive hyphens.
4729
4821
  #
4822
+ # @option params [String] :restore_type
4823
+ # The type of restore to be performed. You can specify one of the
4824
+ # following values:
4825
+ #
4826
+ # * `full-copy` - The new DB cluster is restored as a full copy of the
4827
+ # source DB cluster.
4828
+ #
4829
+ # * `copy-on-write` - The new DB cluster is restored as a clone of the
4830
+ # source DB cluster.
4831
+ #
4832
+ # Constraints: You can't specify `copy-on-write` if the engine version
4833
+ # of the source DB cluster is earlier than 1.11.
4834
+ #
4835
+ # If you don't specify a `RestoreType` value, then the new DB cluster
4836
+ # is restored as a full copy of the source DB cluster.
4837
+ #
4730
4838
  # @option params [required, String] :source_db_cluster_identifier
4731
4839
  # The identifier of the source cluster from which to restore.
4732
4840
  #
@@ -4791,10 +4899,10 @@ module Aws::DocDB
4791
4899
  # an encrypted cluster.
4792
4900
  #
4793
4901
  # The KMS key identifier is the Amazon Resource Name (ARN) for the KMS
4794
- # encryption key. If you are restoring a cluster with the same account
4795
- # that owns the KMS encryption key used to encrypt the new cluster, then
4796
- # you can use the KMS key alias instead of the ARN for the KMS
4797
- # encryption key.
4902
+ # encryption key. If you are restoring a cluster with the same Amazon
4903
+ # Web Services account that owns the KMS encryption key used to encrypt
4904
+ # the new cluster, then you can use the KMS key alias instead of the ARN
4905
+ # for the KMS encryption key.
4798
4906
  #
4799
4907
  # You can restore to a new cluster and encrypt the new cluster with an
4800
4908
  # KMS key that is different from the KMS key used to encrypt the source
@@ -4831,6 +4939,7 @@ module Aws::DocDB
4831
4939
  #
4832
4940
  # resp = client.restore_db_cluster_to_point_in_time({
4833
4941
  # db_cluster_identifier: "String", # required
4942
+ # restore_type: "String",
4834
4943
  # source_db_cluster_identifier: "String", # required
4835
4944
  # restore_to_time: Time.now,
4836
4945
  # use_latest_restorable_time: false,
@@ -4888,6 +4997,7 @@ module Aws::DocDB
4888
4997
  # resp.db_cluster.associated_roles #=> Array
4889
4998
  # resp.db_cluster.associated_roles[0].role_arn #=> String
4890
4999
  # resp.db_cluster.associated_roles[0].status #=> String
5000
+ # resp.db_cluster.clone_group_id #=> String
4891
5001
  # resp.db_cluster.cluster_create_time #=> Time
4892
5002
  # resp.db_cluster.enabled_cloudwatch_logs_exports #=> Array
4893
5003
  # resp.db_cluster.enabled_cloudwatch_logs_exports[0] #=> String
@@ -4964,6 +5074,7 @@ module Aws::DocDB
4964
5074
  # resp.db_cluster.associated_roles #=> Array
4965
5075
  # resp.db_cluster.associated_roles[0].role_arn #=> String
4966
5076
  # resp.db_cluster.associated_roles[0].status #=> String
5077
+ # resp.db_cluster.clone_group_id #=> String
4967
5078
  # resp.db_cluster.cluster_create_time #=> Time
4968
5079
  # resp.db_cluster.enabled_cloudwatch_logs_exports #=> Array
4969
5080
  # resp.db_cluster.enabled_cloudwatch_logs_exports[0] #=> String
@@ -5040,6 +5151,7 @@ module Aws::DocDB
5040
5151
  # resp.db_cluster.associated_roles #=> Array
5041
5152
  # resp.db_cluster.associated_roles[0].role_arn #=> String
5042
5153
  # resp.db_cluster.associated_roles[0].status #=> String
5154
+ # resp.db_cluster.clone_group_id #=> String
5043
5155
  # resp.db_cluster.cluster_create_time #=> Time
5044
5156
  # resp.db_cluster.enabled_cloudwatch_logs_exports #=> Array
5045
5157
  # resp.db_cluster.enabled_cloudwatch_logs_exports[0] #=> String
@@ -5067,7 +5179,7 @@ module Aws::DocDB
5067
5179
  params: params,
5068
5180
  config: config)
5069
5181
  context[:gem_name] = 'aws-sdk-docdb'
5070
- context[:gem_version] = '1.40.0'
5182
+ context[:gem_version] = '1.43.0'
5071
5183
  Seahorse::Client::Request.new(handlers, context)
5072
5184
  end
5073
5185