aws-sdk-rds 1.146.0 → 1.147.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.
@@ -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