调用EvaluateRegionResource接口进行资源评估。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 EvaluateRegionResource

系统规定参数。取值：EvaluateRegionResource。
DBType String 是 MySQL

数据库引擎类型，取值范围如下：

  • MySQL
  • PostgreSQL
  • Oracle
DBVersion String 是 8.0

数据库引擎版本号。

  • MySQL版本号取值范围如下：
    • 5.6
    • 5.7
    • 8.0
  • PostgreSQL版本号取值范围如下：
    • 11
    • 14
  • Oracle版本号取值为11。
SubDomain String 否 cn-beijing-i-aliyun

子域。即顶级域名（一级域名或父域名）的下一级。例如：父域名为：cn-beijing，则它的子域可以为cn-beijing-i-aliyun。
DBNodeClass String 是 polar.mysql.x4.large

节点规格，详情请参见如下文档：
DBInstanceConnType String 否 lvs

指定集群链路类型，后端随机选择默认值，取值范围如下：

  • lvs：Linux虚拟服务器。
  • proxy：代理服务器。
  • dns：域名系统。
DispenseMode String 否 1

是否返回支持单可用区部署功能的可用区列表。取值范围如下：

  • 0（默认）：不返回。
  • 1：返回。
NeedMaxScaleLink String 是 true

是否创建Maxscale，取值范围如下：

  • true（默认）：创建Maxscale。
  • false：不创建Maxscale。
ResourceGroupId String 否 rg-************

资源组ID。
RegionId String 是 cn-hangzhou

地域ID。

说明 您可以通过DescribeRegions接口查看可用地域。
ZoneId String 是 cn-hangzhou-g

可用区ID。

说明 您可以通过DescribeRegions接口查看可选的可用区。

返回数据

名称 类型 示例值 描述
RequestId String 69A85BAF-1089-4CDF-A82F-0A140F******

请求ID。
DBInstanceAvailable String true

是否有足够的资源。

  • true：有足够的资源。
  • false：资源不足。
DBType String MySQL

数据库引擎类型，取值范围如下：

  • MySQL
  • PostgreSQL
  • Oracle
DBVersion String 8.0

数据库引擎版本号。

  • MySQL版本号取值范围如下：
    • 5.6
    • 5.7
    • 8.0
  • PostgreSQL版本号取值范围如下：
    • 11
    • 14
  • Oracle版本号取值为11。

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=EvaluateRegionResource
&DBType=MySQL
&DBVersion=8.0
&SubDomain=cn-beijing-i-aliyun
&DBNodeClass=polar.mysql.x4.large
&DBInstanceConnType=lvs
&DispenseMode=1
&NeedMaxScaleLink=true
&ResourceGroupId=rg-************
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-g
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<EvaluateRegionResourceResponse>
    <RequestId>69A85BAF-1089-4CDF-A82F-0A140F******</RequestId>
    <DBInstanceAvailable>true</DBInstanceAvailable>
    <DBType>MySQL</DBType>
    <DBVersion>8.0</DBVersion>
</EvaluateRegionResourceResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode 错误码 错误信息 描述
400 InvalidDBType.Malformed The Specified DBType is not valid. 指定的数据库类型无效.
400 InvalidDBVersion.Malformed The Specified DBVersion is not valid. 指定的DBVersion无效
404 SubDomain.Malformed The specified SubDomain does not exist or ZoneId is not valid. 指定的子域不存在或可用区无效。

访问错误中心查看更多错误码。