调用DescribeAvailableResource查询云数据库MongoDB指定可用区的资源信息。

调试

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

请求参数

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

系统规定参数。取值:DescribeAvailableResource

RegionId String cn-hangzhou

地域ID。您可以通过调用DescribeRegions接口进行查询。

ZoneId String cn-hangzhou-h

可用区ID。您可以通过DescribeRegions接口查看可用的可用区。

InstanceChargeType String PrePaid

付费类型,取值说明:

  • PrePaid(默认值):包年包月。
  • PostPaid:按量付费。
DbType String sharding

实例的数据库类型,取值说明:

  • normal:副本集实例。
  • sharding:分片集群实例。
ResourceGroupId String rg-acfmyiu4ekp****

资源组ID。

返回数据

名称 类型 示例值 描述
RequestId String 344EE51D-8850-4935-B68B-58A8F4DCE3BD

请求ID。

SupportedDBTypes Array of SupportedDBType

支持的数据库类型。

SupportedDBType
AvailableZones Array of AvailableZone

可用区。

AvailableZone
SupportedEngineVersions Array of SupportedEngineVersion

支持的存储引擎版本。

SupportedEngineVersion
SupportedEngines Array of SupportedEngine

支持的存储引擎。

SupportedEngine
SupportedNodeTypes Array of SupportedNodeType

支持的实例类型。

SupportedNodeType
NodeType String 3

实例的节点数。

NetworkTypes String VPC

实例的网络类型。

AvailableResources Array of AvailableResource

可用的资源详情。

AvailableResource
InstanceClassRemark String 4核8GB(独享型)(当前选择规格:mdb.shard.2x.xlarge.d(4核8G(独享型云盘版),最大连接数:3000,最大IOPS:min{1800+50*存储空间, 21000}))

实例规格。

InstanceClass String mdb.shard.2x.xlarge.d

实例规格族。

DBInstanceStorageRange Object

实例的存储空间范围。

Min Integer 20

存储空间的最小值,单位:GB。

Max Integer 16000

存储空间的最大值,单位:GB。

Step Integer 10

调整存储空间的最小粒度,单位:GB。

Engine String WiredTiger

实例的存储引擎。

Version String 4.0

实例的数据库版本。

ZoneId String cn-hangzhou-h

可用区ID。

RegionId String cn-hangzhou

地域ID。

DbType String sharding

实例的数据库类型,取值说明:

  • normal:副本集实例。
  • sharding:分片集群实例。

示例

请求示例

http(s)://mongodb.aliyuncs.com/?Action=DescribeAvailableResource
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式

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

<DescribeAvailableResourceResponse>
    <RequestId>344EE51D-8850-4935-B68B-58A8F4DCE3BD</RequestId>
    <SupportedDBTypes>
        <AvailableZones>
            <SupportedEngineVersions>
                <SupportedEngines>
                    <SupportedNodeTypes>
                        <NodeType>3</NodeType>
                        <NetworkTypes>VPC</NetworkTypes>
                        <AvailableResources>
                            <InstanceClassRemark>4核8GB(独享型)(当前选择规格:mdb.shard.2x.xlarge.d(4核8G(独享型云盘版),最大连接数:3000,最大IOPS:min{1800+50*存储空间, 21000}))</InstanceClassRemark>
                            <InstanceClass>mdb.shard.2x.xlarge.d</InstanceClass>
                            <DBInstanceStorageRange>
                                <Min>20</Min>
                                <Max>16000</Max>
                                <Step>10</Step>
                            </DBInstanceStorageRange>
                        </AvailableResources>
                    </SupportedNodeTypes>
                    <Engine>WiredTiger</Engine>
                </SupportedEngines>
                <Version>4.0</Version>
            </SupportedEngineVersions>
            <ZoneId>cn-hangzhou-h</ZoneId>
            <RegionId>cn-hangzhou</RegionId>
        </AvailableZones>
        <DbType>sharding</DbType>
    </SupportedDBTypes>
</DescribeAvailableResourceResponse>

JSON格式

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

{
  "RequestId" : "344EE51D-8850-4935-B68B-58A8F4DCE3BD",
  "SupportedDBTypes" : [ {
    "AvailableZones" : [ {
      "SupportedEngineVersions" : [ {
        "SupportedEngines" : [ {
          "SupportedNodeTypes" : [ {
            "NodeType" : "3",
            "NetworkTypes" : "VPC",
            "AvailableResources" : [ {
              "InstanceClassRemark" : "4核8GB(独享型)(当前选择规格:mdb.shard.2x.xlarge.d(4核8G(独享型云盘版),最大连接数:3000,最大IOPS:min{1800+50*存储空间, 21000}))",
              "InstanceClass" : "mdb.shard.2x.xlarge.d",
              "DBInstanceStorageRange" : {
                "Min" : 20,
                "Max" : 16000,
                "Step" : 10
              }
            } ]
          } ],
          "Engine" : "WiredTiger"
        } ],
        "Version" : "4.0"
      } ],
      "ZoneId" : "cn-hangzhou-h",
      "RegionId" : "cn-hangzhou"
    } ],
    "DbType" : "sharding"
  } ]
}

错误码

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