All Products
Search
Document Center

PolarDB:DescribeDBClusterAvailableResources

Last Updated:Mar 01, 2024

Queries available resources in a PolarDB cluster.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
PayTypestringYes

The billing method of the cluster. Valid values:

  • Postpaid: pay-as-you-go
  • Prepaid: subscription
Postpaid
DBTypestringNo

The type of the database engine. Valid values:

  • MySQL
  • PostgreSQL
  • Oracle
MySQL
DBVersionstringNo

The version of the database engine. Valid values for the MySQL database engine:

  • 5.6
  • 5.7
  • 8.0

Valid values for the PostgreSQL database engine:

  • 11
  • 14

Valid value for the Oracle database engine: 11

Note This parameter is required when you specify the DBType parameter.
5.6
DBNodeClassstringNo

The specifications of the node. For more information, see Specifications of compute nodes.

polar.mysql.x4.large
RegionIdstringNo

The region ID of the cluster. Default value: cn-hangzhou.

Note You can call the DescribeRegions operation to query the available regions.
cn-hangzhou
ZoneIdstringNo

The zone ID of the cluster.

Note You can call the DescribeRegions operation to query the available zones.
cn-hangzhou-i

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the request.

2B19F698-8FFC-4918-B9E2-58D878******
AvailableZonesobject []

The available zones of the cluster.

SupportedEnginesobject []

The database engines that the available resources support.

Enginestring

The version of the database engine.

mysql57
AvailableResourcesobject []

The available resources.

DBNodeClassstring

The specifications of the node.

polar.mysql.x4.large
Categorystring

The edition of the cluster. Valid values:

  • Normal: Cluster Edition.
  • Basic: Single Node Edition.
  • ArchiveNormal: X-Engine.
  • NormalMultimaster: Multi-master Cluster (Database/Table) Edition.
  • SENormal: Standard Edition.
Note
  • Only PolarDB for MySQL supports Single Node Edition.
  • Only PolarDB for MySQL 8.0 supports X-Engine Edition and Multi-master Cluster (Database/Table) Edition.
  • Normal
    ZoneIdstring

    The zone ID of the cluster.

    cn-hangzhou-i
    RegionIdstring

    The region ID of the cluster.

    cn-hangzhou

    Examples

    Sample success responses

    JSONformat

    {
      "RequestId": "2B19F698-8FFC-4918-B9E2-58D878******",
      "AvailableZones": [
        {
          "SupportedEngines": [
            {
              "Engine": "mysql57",
              "AvailableResources": [
                {
                  "DBNodeClass": "polar.mysql.x4.large",
                  "Category": "Normal"
                }
              ]
            }
          ],
          "ZoneId": "cn-hangzhou-i",
          "RegionId": "cn-hangzhou"
        }
      ]
    }

    Error codes

    HTTP status codeError codeError messageDescription
    400InvalidDBVersion.MalformedThe Specified DBVersion is not valid.The specified DBVersion parameter is invalid.

    For a list of error codes, visit the Service error codes.

    Change history

    Change timeSummary of changesOperation
    2022-11-24The Error code has changedsee changesets
    Change itemChange content
    Error CodesThe Error code has changed.
      Error Codes 400 change