View a markdown version of this page

DescribeServerlessV2PlatformVersions - Amazon Relational Database Service

DescribeServerlessV2PlatformVersions

Describes the properties of specific platform versions for Aurora Serverless v2.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

DefaultOnly

Specifies whether to return only the default platform versions for each engine. The default platform version is the version used for new DB clusters.

Type: Boolean

Required: No

Engine

The database engine to return platform version details for.

Valid Values:

  • aurora-mysql

  • aurora-postgresql

Type: String

Required: No

Filters.Filter.N

This parameter isn't currently supported.

Type: Array of Filter objects

Required: No

IncludeAll

Specifies whether to also include platform versions which are no longer in use.

Type: Boolean

Required: No

Marker

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

Type: String

Required: No

MaxRecords

The maximum number of records to include in the response. If more than the MaxRecords value is available, a pagination token called a marker is included in the response so you can retrieve the remaining results.

Default: 20

Constraints: Minimum 1, maximum 200.

Type: Integer

Required: No

ServerlessV2PlatformVersion

A specific platform version to return details for.

Example: 3

Type: String

Required: No

Response Elements

The following elements are returned by the service.

Marker

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

Type: String

ServerlessV2PlatformVersions.member.N

A list of ServerlessV2PlatformVersionInfo elements.

Type: Array of ServerlessV2PlatformVersionInfo objects

Errors

For information about the errors that are common to all actions, see Common Error Types.

Examples

Example

This example illustrates one usage of DescribeServerlessV2PlatformVersions.

Sample Request

https://rds.us-east-1.amazonaws.com/ ?Action=DescribeServerlessV2PlatformVersions &MaxRecords=3 &SignatureMethod=HmacSHA256 &SignatureVersion=4 &Version=2014-10-31 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20260331/us-east-1/rds/aws4_request &X-Amz-Date=20260331T003734Z &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date &X-Amz-Signature=a9be10ebb18697cfb30621749934561405d97a3e836a749e92080dda950dbdfb

Sample Response

<DescribeServerlessV2PlatformVersionsResponse> <DescribeServerlessV2PlatformVersionsResult> <ServerlessV2PlatformVersions> <member> <IsDefault>true</IsDefault> <ServerlessV2PlatformVersionDescription> Version 4 offering scaling up to 256 ACUs, and performance improvement up to 30% compared to version 3 </ServerlessV2PlatformVersionDescription> <Engine>aurora-postgresql</Engine> <ServerlessV2FeaturesSupport> <MaxCapacity>256.0</MaxCapacity> <MinCapacity>0.0</MinCapacity> </ServerlessV2FeaturesSupport> <ServerlessV2PlatformVersion>4</ServerlessV2PlatformVersion> <Status>enabled</Status> </member> <member> <IsDefault>false</IsDefault> <ServerlessV2PlatformVersionDescription> Version 3 offering scaling up to 256 ACUs, and performance improvement up to 30% compared to version 2 </ServerlessV2PlatformVersionDescription> <Engine>aurora-postgresql</Engine> <ServerlessV2FeaturesSupport> <MaxCapacity>256.0</MaxCapacity> <MinCapacity>0.0</MinCapacity> </ServerlessV2FeaturesSupport> <ServerlessV2PlatformVersion>3</ServerlessV2PlatformVersion> <Status>enabled</Status> </member> <member> <IsDefault>false</IsDefault> <ServerlessV2PlatformVersionDescription> Version 2 offering scaling up to 256 ACUs </ServerlessV2PlatformVersionDescription> <Engine>aurora-postgresql</Engine> <ServerlessV2FeaturesSupport> <MaxCapacity>256.0</MaxCapacity> <MinCapacity>0.0</MinCapacity> </ServerlessV2FeaturesSupport> <ServerlessV2PlatformVersion>2</ServerlessV2PlatformVersion> <Status>enabled</Status> </member> </ServerlessV2PlatformVersions> <Marker>dGhpcyBpcyBhbiBleGFtcGxlIG1hcmtlcg==</Marker> </DescribeServerlessV2PlatformVersionsResult> <ResponseMetadata> <RequestId>a1da1a67-9f9a-43d0-975c-5800dc1b1f59</RequestId> </ResponseMetadata> </DescribeServerlessV2PlatformVersionsResponse>

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: