aws-sdk-rds 1.146.0 → 1.147.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -579,8 +579,24 @@ module Aws::RDS
579
579
  data[:performance_insights_kms_key_id]
580
580
  end
581
581
 
582
- # The amount of time, in days, to retain Performance Insights data.
583
- # Valid values are 7 or 731 (2 years).
582
+ # The number of days to retain Performance Insights data. The default is
583
+ # 7 days. The following values are valid:
584
+ #
585
+ # * 7
586
+ #
587
+ # * *month* * 31, where *month* is a number of months from 1-23
588
+ #
589
+ # * 731
590
+ #
591
+ # For example, the following values are valid:
592
+ #
593
+ # * 93 (3 months * 31)
594
+ #
595
+ # * 341 (11 months * 31)
596
+ #
597
+ # * 589 (19 months * 31)
598
+ #
599
+ # * 731
584
600
  #
585
601
  # This setting is only for non-Aurora Multi-AZ DB clusters.
586
602
  # @return [Integer]
@@ -1075,25 +1091,25 @@ module Aws::RDS
1075
1091
  #
1076
1092
  # Valid for: Aurora DB clusters and Multi-AZ DB clusters
1077
1093
  # @option options [String] :pre_signed_url
1078
- # A URL that contains a Signature Version 4 signed request for the
1079
- # `CreateDBCluster` action to be called in the source Amazon Web
1080
- # Services Region where the DB cluster is replicated from. Specify
1081
- # `PreSignedUrl` only when you are performing cross-Region replication
1082
- # from an encrypted DB cluster.
1083
- #
1084
- # The pre-signed URL must be a valid request for the `CreateDBCluster`
1085
- # API action that can be executed in the source Amazon Web Services
1086
- # Region that contains the encrypted DB cluster to be copied.
1087
- #
1088
- # The pre-signed URL request must contain the following parameter
1089
- # values:
1090
- #
1091
- # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the KMS
1092
- # key to use to encrypt the copy of the DB cluster in the destination
1093
- # Amazon Web Services Region. This should refer to the same KMS key
1094
- # for both the `CreateDBCluster` action that is called in the
1095
- # destination Amazon Web Services Region, and the action contained in
1096
- # the pre-signed URL.
1094
+ # When you are replicating a DB cluster from one Amazon Web Services
1095
+ # GovCloud (US) Region to another, an URL that contains a Signature
1096
+ # Version 4 signed request for the `CreateDBCluster` operation to be
1097
+ # called in the source Amazon Web Services Region where the DB cluster
1098
+ # is replicated from. Specify `PreSignedUrl` only when you are
1099
+ # performing cross-Region replication from an encrypted DB cluster.
1100
+ #
1101
+ # The presigned URL must be a valid request for the `CreateDBCluster`
1102
+ # API operation that can run in the source Amazon Web Services Region
1103
+ # that contains the encrypted DB cluster to copy.
1104
+ #
1105
+ # The presigned URL request must contain the following parameter values:
1106
+ #
1107
+ # * `KmsKeyId` - The KMS key identifier for the KMS key to use to
1108
+ # encrypt the copy of the DB cluster in the destination Amazon Web
1109
+ # Services Region. This should refer to the same KMS key for both the
1110
+ # `CreateDBCluster` operation that is called in the destination Amazon
1111
+ # Web Services Region, and the operation contained in the presigned
1112
+ # URL.
1097
1113
  #
1098
1114
  # * `DestinationRegion` - The name of the Amazon Web Services Region
1099
1115
  # that Aurora read replica will be created in.
@@ -1114,9 +1130,8 @@ module Aws::RDS
1114
1130
  # <note markdown="1"> If you are using an Amazon Web Services SDK tool or the CLI, you can
1115
1131
  # specify `SourceRegion` (or `--source-region` for the CLI) instead of
1116
1132
  # specifying `PreSignedUrl` manually. Specifying `SourceRegion`
1117
- # autogenerates a pre-signed URL that is a valid request for the
1118
- # operation that can be executed in the source Amazon Web Services
1119
- # Region.
1133
+ # autogenerates a presigned URL that is a valid request for the
1134
+ # operation that can run in the source Amazon Web Services Region.
1120
1135
  #
1121
1136
  # </note>
1122
1137
  #
@@ -1132,7 +1147,7 @@ module Aws::RDS
1132
1147
  # accounts. By default, mapping isn't enabled.
1133
1148
  #
1134
1149
  # For more information, see [ IAM Database Authentication][1] in the
1135
- # *Amazon Aurora User Guide.*.
1150
+ # *Amazon Aurora User Guide*.
1136
1151
  #
1137
1152
  # Valid for: Aurora DB clusters only
1138
1153
  #
@@ -1203,6 +1218,9 @@ module Aws::RDS
1203
1218
  # The `multimaster` engine mode only applies for DB clusters created
1204
1219
  # with Aurora MySQL version 5.6.10a.
1205
1220
  #
1221
+ # The `serverless` engine mode only applies for Aurora Serverless v1 DB
1222
+ # clusters.
1223
+ #
1206
1224
  # For Aurora PostgreSQL, the `global` engine mode isn't required, and
1207
1225
  # both the `parallelquery` and the `multimaster` engine modes currently
1208
1226
  # aren't supported.
@@ -1211,22 +1229,25 @@ module Aws::RDS
1211
1229
  # information, see the following sections in the *Amazon Aurora User
1212
1230
  # Guide*\:
1213
1231
  #
1214
- # * [ Limitations of Aurora Serverless v1][1]
1232
+ # * [Limitations of Aurora Serverless v1][1]
1215
1233
  #
1216
- # * [ Limitations of Parallel Query][2]
1234
+ # * [Requirements for Aurora Serverless v2][2]
1217
1235
  #
1218
- # * [ Limitations of Aurora Global Databases][3]
1236
+ # * [Limitations of Parallel Query][3]
1219
1237
  #
1220
- # * [ Limitations of Multi-Master Clusters][4]
1238
+ # * [Limitations of Aurora Global Databases][4]
1239
+ #
1240
+ # * [Limitations of Multi-Master Clusters][5]
1221
1241
  #
1222
1242
  # Valid for: Aurora DB clusters only
1223
1243
  #
1224
1244
  #
1225
1245
  #
1226
1246
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html#aurora-serverless.limitations
1227
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-mysql-parallel-query.html#aurora-mysql-parallel-query-limitations
1228
- # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database.html#aurora-global-database.limitations
1229
- # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-multi-master.html#aurora-multi-master-limitations
1247
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.requirements.html
1248
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-mysql-parallel-query.html#aurora-mysql-parallel-query-limitations
1249
+ # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database.html#aurora-global-database.limitations
1250
+ # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-multi-master.html#aurora-multi-master-limitations
1230
1251
  # @option options [Types::ScalingConfiguration] :scaling_configuration
1231
1252
  # For DB clusters in `serverless` DB engine mode, the scaling properties
1232
1253
  # of the DB cluster.
@@ -1449,8 +1470,27 @@ module Aws::RDS
1449
1470
  #
1450
1471
  # Valid for: Multi-AZ DB clusters only
1451
1472
  # @option options [Integer] :performance_insights_retention_period
1452
- # The amount of time, in days, to retain Performance Insights data.
1453
- # Valid values are 7 or 731 (2 years).
1473
+ # The number of days to retain Performance Insights data. The default is
1474
+ # 7 days. The following values are valid:
1475
+ #
1476
+ # * 7
1477
+ #
1478
+ # * *month* * 31, where *month* is a number of months from 1-23
1479
+ #
1480
+ # * 731
1481
+ #
1482
+ # For example, the following values are valid:
1483
+ #
1484
+ # * 93 (3 months * 31)
1485
+ #
1486
+ # * 341 (11 months * 31)
1487
+ #
1488
+ # * 589 (19 months * 31)
1489
+ #
1490
+ # * 731
1491
+ #
1492
+ # If you specify a retention period such as 94, which isn't a valid
1493
+ # value, RDS issues an error.
1454
1494
  #
1455
1495
  # Valid for: Multi-AZ DB clusters only
1456
1496
  # @option options [Types::ServerlessV2ScalingConfiguration] :serverless_v2_scaling_configuration
@@ -2066,8 +2106,27 @@ module Aws::RDS
2066
2106
  #
2067
2107
  # Valid for: Multi-AZ DB clusters only
2068
2108
  # @option options [Integer] :performance_insights_retention_period
2069
- # The amount of time, in days, to retain Performance Insights data.
2070
- # Valid values are 7 or 731 (2 years).
2109
+ # The number of days to retain Performance Insights data. The default is
2110
+ # 7 days. The following values are valid:
2111
+ #
2112
+ # * 7
2113
+ #
2114
+ # * *month* * 31, where *month* is a number of months from 1-23
2115
+ #
2116
+ # * 731
2117
+ #
2118
+ # For example, the following values are valid:
2119
+ #
2120
+ # * 93 (3 months * 31)
2121
+ #
2122
+ # * 341 (11 months * 31)
2123
+ #
2124
+ # * 589 (19 months * 31)
2125
+ #
2126
+ # * 731
2127
+ #
2128
+ # If you specify a retention period such as 94, which isn't a valid
2129
+ # value, RDS issues an error.
2071
2130
  #
2072
2131
  # Valid for: Multi-AZ DB clusters only
2073
2132
  # @option options [Types::ServerlessV2ScalingConfiguration] :serverless_v2_scaling_configuration
@@ -2307,7 +2366,7 @@ module Aws::RDS
2307
2366
  #
2308
2367
  # For more information about exporting CloudWatch Logs for Amazon RDS,
2309
2368
  # see [Publishing Database Logs to Amazon CloudWatch Logs][1] in the
2310
- # *Amazon RDS User Guide.*.
2369
+ # *Amazon RDS User Guide*.
2311
2370
  #
2312
2371
  # For more information about exporting CloudWatch Logs for Amazon
2313
2372
  # Aurora, see [Publishing Database Logs to Amazon CloudWatch Logs][2] in
@@ -408,26 +408,30 @@ module Aws::RDS
408
408
  # If you copy an unencrypted DB cluster snapshot and specify a value for
409
409
  # the `KmsKeyId` parameter, an error is returned.
410
410
  # @option options [String] :pre_signed_url
411
- # The URL that contains a Signature Version 4 signed request for the
412
- # `CopyDBClusterSnapshot` API action in the Amazon Web Services Region
413
- # that contains the source DB cluster snapshot to copy. The
414
- # `PreSignedUrl` parameter must be used when copying an encrypted DB
415
- # cluster snapshot from another Amazon Web Services Region. Don't
416
- # specify `PreSignedUrl` when you are copying an encrypted DB cluster
417
- # snapshot in the same Amazon Web Services Region.
418
- #
419
- # The pre-signed URL must be a valid request for the
420
- # `CopyDBClusterSnapshot` API action that can be executed in the source
411
+ # When you are copying a DB cluster snapshot from one Amazon Web
412
+ # Services GovCloud (US) Region to another, the URL that contains a
413
+ # Signature Version 4 signed request for the `CopyDBClusterSnapshot` API
414
+ # operation in the Amazon Web Services Region that contains the source
415
+ # DB cluster snapshot to copy. Use the `PreSignedUrl` parameter when
416
+ # copying an encrypted DB cluster snapshot from another Amazon Web
417
+ # Services Region. Don't specify `PreSignedUrl` when copying an
418
+ # encrypted DB cluster snapshot in the same Amazon Web Services Region.
419
+ #
420
+ # This setting applies only to Amazon Web Services GovCloud (US)
421
+ # Regions. It's ignored in other Amazon Web Services Regions.
422
+ #
423
+ # The presigned URL must be a valid request for the
424
+ # `CopyDBClusterSnapshot` API operation that can run in the source
421
425
  # Amazon Web Services Region that contains the encrypted DB cluster
422
- # snapshot to be copied. The pre-signed URL request must contain the
423
- # following parameter values:
426
+ # snapshot to copy. The presigned URL request must contain the following
427
+ # parameter values:
424
428
  #
425
- # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the KMS
426
- # key to use to encrypt the copy of the DB cluster snapshot in the
427
- # destination Amazon Web Services Region. This is the same identifier
428
- # for both the `CopyDBClusterSnapshot` action that is called in the
429
- # destination Amazon Web Services Region, and the action contained in
430
- # the pre-signed URL.
429
+ # * `KmsKeyId` - The KMS key identifier for the KMS key to use to
430
+ # encrypt the copy of the DB cluster snapshot in the destination
431
+ # Amazon Web Services Region. This is the same identifier for both the
432
+ # `CopyDBClusterSnapshot` operation that is called in the destination
433
+ # Amazon Web Services Region, and the operation contained in the
434
+ # presigned URL.
431
435
  #
432
436
  # * `DestinationRegion` - The name of the Amazon Web Services Region
433
437
  # that the DB cluster snapshot is to be created in.
@@ -449,9 +453,8 @@ module Aws::RDS
449
453
  # <note markdown="1"> If you are using an Amazon Web Services SDK tool or the CLI, you can
450
454
  # specify `SourceRegion` (or `--source-region` for the CLI) instead of
451
455
  # specifying `PreSignedUrl` manually. Specifying `SourceRegion`
452
- # autogenerates a pre-signed URL that is a valid request for the
453
- # operation that can be executed in the source Amazon Web Services
454
- # Region.
456
+ # autogenerates a presigned URL that is a valid request for the
457
+ # operation that can run in the source Amazon Web Services Region.
455
458
  #
456
459
  # </note>
457
460
  #
@@ -743,7 +746,7 @@ module Aws::RDS
743
746
  #
744
747
  # For more information about exporting CloudWatch Logs for Amazon RDS,
745
748
  # see [Publishing Database Logs to Amazon CloudWatch Logs][1] in the
746
- # *Amazon RDS User Guide.*.
749
+ # *Amazon RDS User Guide*.
747
750
  #
748
751
  # For more information about exporting CloudWatch Logs for Amazon
749
752
  # Aurora, see [Publishing Database Logs to Amazon CloudWatch Logs][2] in