AWS AmazonRDS documentation change
Summary
Added documentation for checking Aurora Serverless v2 platform versions, including how to view current version, check default version, identify pending upgrades, and schedule platform version updates. Also added clarifications about blue/green deployment limitations.
Security assessment
The changes are routine documentation updates about platform version management for Aurora Serverless v2. They describe how to check and upgrade platform versions, which is a standard feature management process. There is no evidence of addressing a specific security vulnerability, weakness, or incident. The note about inability to downgrade after upgrading is a standard operational warning, not a security issue. The changes do not introduce or document security features.
Diff
diff --git a/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2-administration.md b/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2-administration.md index 1cbb294d3..dfc9cff34 100644 --- a//AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2-administration.md +++ b//AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2-administration.md @@ -7 +7 @@ -Setting the Aurora Serverless v2 capacity range for a clusterChecking the Aurora Serverless v2 capacity rangeAdding an Aurora Serverless v2 readerConverting from provisioned to Aurora Serverless v2Converting from Aurora Serverless v2 to provisionedPausing Aurora Serverless v2 DB instancesChoosing the promotion tier for an Aurora Serverless v2 readerUsing TLS/SSL with Aurora Serverless v2Viewing Aurora Serverless v2 writers and readersLogging for Aurora Serverless v2 +Setting the Aurora Serverless v2 capacity range for a clusterChecking the Aurora Serverless v2 capacity rangeChecking the Aurora Serverless v2 platform versionAdding an Aurora Serverless v2 readerConverting from provisioned to Aurora Serverless v2Converting from Aurora Serverless v2 to provisionedPausing Aurora Serverless v2 DB instancesChoosing the promotion tier for an Aurora Serverless v2 readerUsing TLS/SSL with Aurora Serverless v2Viewing Aurora Serverless v2 writers and readersLogging for Aurora Serverless v2 @@ -20,0 +21,2 @@ In the following topics, you can learn about management considerations for clust + * Checking the platform version for an existing Aurora Serverless v2 cluster + @@ -218 +220,3 @@ However, stopping and starting a DB cluster incurs some downtime, usually severa -If you maintain your database credentials in AWS Secrets Manager, you can't use blue/green deployments. + * If you maintain your database credentials in AWS Secrets Manager, you can't use blue/green deployments. + + * Aurora Global Database doesn't support blue/green deployments. @@ -220 +224 @@ If you maintain your database credentials in AWS Secrets Manager, you can't use -Aurora Global Database doesn't support blue/green deployments. + * **Important:** Once you upgrade to a newer platform version, you cannot downgrade to a previous version. @@ -254,0 +259,89 @@ You can check the capacity range that's configured for Aurora Serverless v2 DB i +## Checking the platform version for an existing Aurora Serverless v2 cluster + +The platform version is displayed in the Instance Configuration section of the instance. + + + +You can use the `describe-db-clusters` command to check the platform version for existing cluster(s). + +###### Example + + + aws rds describe-db-clusters \ + --db-cluster-identifier mydbcluster + +### Checking the default platform version + +You can use the `describe-serverless-v2-platform-versions` command to check the details of a platform version or to check the default platform version that you will get when you create a new cluster. + +###### Example + + + $ aws rds describe-serverless-v2-platform-versions + { + "ServerlessV2PlatformVersions": [ + { + "Engine": "aurora-postgresql", + "ServerlessV2PlatformVersion": "3", + "ServerlessV2PlatformVersionDescription": "Version 3 powered by Graviton 3 processors offering scaling up to 256 ACUs, and performance improvement up to 30% compared to version 2" + "ServerlessV2FeatureSupport": { + "MinCapacity": 0 + "MaxCapacity": 256 + }, + "Status": "available", + "IsDefault": True + }, + ... + ] + } + + # describing the default platform version for an engine + $ aws rds describe-serverless-v2-platform-versions --engine aurora-postgresql --default-only + { + "ServerlessV2PlatformVersions": [ + { + "Engine": "aurora-postgresql", + "ServerlessV2PlatformVersion": "3", + "ServerlessV2PlatformVersionDescription": "Version 3 powered by Graviton 3 processors offering scaling up to 256 ACUs, and performance improvement up to 30% compared to version 2" + "ServerlessV2FeatureSupport": { + "MinCapacity": 0 + "MaxCapacity": 256 + }, + "Status": "available", + "IsDefault": True + } + ] + } + +### Checking for pending platform version upgrades + +You can use the `describe-pending-maintenance-actions` command to check whether there are any pending platform version upgrades for your Aurora Serverless v2 DB clusters. + +To check for pending upgrades on a specific cluster, use the `--resource-identifier` parameter to specify the Amazon Resource Name (ARN) of your DB cluster: + +###### Example + + + aws rds describe-pending-maintenance-actions \ + --resource-identifier arn:aws:rds:us-east-1:123456789012 + :cluster:my-serverless-cluster + +#### Scheduling a platform version upgrade + +After you identify a pending platform version upgrade, you can use the `apply-pending-maintenance-action` command to schedule when the upgrade occurs. + +To schedule a platform version upgrade, specify the following parameters: + + * `--resource-identifier` – The ARN of your Aurora Serverless v2 DB cluster + + * `--apply-action` – Use `serverless-platform-version-update` to specify a platform version upgrade + + * `--opt-in-type` – Choose when to apply the upgrade: + + * `immediate` – Apply the upgrade immediately + + * `next-maintenance` – Apply the upgrade during your next schedule + + + +