All Products
Search

This Product

    PolarDB:EvaluateRegionResource

    Document Center

    PolarDB:EvaluateRegionResource

    Last Updated:Sep 24, 2026

    Evaluates resource availability.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    DBType

    string

    Yes

    The type of the database engine. Valid values:

    • MySQL

    • PostgreSQL

    • Oracle

    MySQL
    DBVersion

    string

    Yes

    The database DPI engine version number.

    • Valid version numbers for MySQL:

      • 5.6

      • 5.7

      • 8.0

    • Valid version numbers for PostgreSQL:

      • 11

      • 14

    • Valid version numbers for Oracle:

      • 11

      • 14

    8.0
    SubDomain

    string

    No

    The subdomain. The subdomain is the next level under the top-level domain (first-level domain or parent domain). For example, if the parent domain is cn-beijing, the subdomain can be cn-beijing-i-aliyun.

    cn-beijing-i-aliyun
    DBNodeClass

    string

    Yes

    The node specification. For more information, see the following topics:

    polar.mysql.x4.large
    DBInstanceConnType

    string

    No

    The cluster link type. The backend randomly selects a default value. Valid values:

    • lvs: Linux virtual server.

    • proxy: proxy server.

    • dns: Domain Name System.

    Valid values:

    • proxy :

      Proxy server.

    • dns :

      Domain Name System.

    • lvs :

      Linux virtual server.

    lvs
    DispenseMode

    string

    No

    Specifies whether to return the list of zones that support single-zone deployment. Valid values:

    • 0 (default): does not return the list.

    • 1: returns the list.

    1
    NeedMaxScaleLink

    string

    Yes

    Specifies whether to create MaxScale. Valid values:

    • true (default): creates MaxScale.

    • false: does not create MaxScale.

    Valid values:

    • false :

      Does not create MaxScale.

    • true :

      Creates MaxScale.

    true
    ResourceGroupId

    string

    No

    The resource group ID.

    rg-************
    RegionId

    string

    Yes

    The region ID.

    Note

    You can call the DescribeRegions operation to query available regions.

    cn-hangzhou
    ZoneId

    string

    Yes

    The zone ID.

    Note

    You can call the DescribeRegions operation to query available zones.

    cn-hangzhou-g

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID.

    69A85BAF-1089-4CDF-A82F-0A140F******
    DBInstanceAvailable

    string

    Indicates whether sufficient resources are available.

    • true: Sufficient resources are available.

    • false: Resources are insufficient.

    true
    DBType

    string

    The type of the database engine. Valid values:

    • MySQL

    • PostgreSQL

    • Oracle

    MySQL
    DBVersion

    string

    The database DPI engine version number.

    • Valid version numbers for MySQL:

      • 5.6

      • 5.7

      • 8.0

    • Valid version numbers for PostgreSQL:

      • 11

      • 14

    • Valid version number for Oracle: 11.

    8.0

    Examples

    Success response

    JSON format

    {
  "RequestId": "69A85BAF-1089-4CDF-A82F-0A140F******",
  "DBInstanceAvailable": "true",
  "DBType": "MySQL",
  "DBVersion": "8.0"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidDBType.Malformed The Specified DBType is not valid. The specified database type is invalid.
    400 InvalidDBVersion.Malformed The Specified DBVersion is not valid. The specified DBVersion parameter is invalid.
    400 InvalidDBNodeClass.Malformed The specified parameter DBNodeClass is not valid. The specified DBNodeClass parameter is invalid.
    404 SubDomain.Malformed The specified SubDomain does not exist or ZoneId is not valid. The specified subdomain does not exist or the specified zone is invalid.
    404 NeedMaxScaleLink.Malformed The specified NeedMaxScaleLink is not valid. The specified NeedMaxScaleLink parameter is invalid.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.