Queries the available resources in a specified zone.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DescribeAvailableResource |
The operation that you want to perform. Set the value to DescribeAvailableResource. |
RegionId | String | Yes | cn-hangzhou |
The region ID of the instance. You can call the DescribeRegions operation to query the most recent region list. |
ZoneId | String | No | cn-hangzhou-h |
The zone ID of the instance. You can call the DescribeRegions operation to query the most recent zone list. |
InstanceChargeType | String | No | PrePaid |
The billing method of the instance. Default value: PrePaid. Valid values:
|
DbType | String | No | sharding |
The architecture of the instance. Valid values:
|
ResourceGroupId | String | No | rg-acfmyiu4ekp**** |
The ID of the resource group. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 344EE51D-8850-4935-B68B-58A8F4DCE3BD |
The ID of the request. |
SupportedDBTypes | Array of SupportedDBType |
The available database types. |
|
SupportedDBType | |||
AvailableZones | Array of AvailableZone |
The available zones. |
|
AvailableZone | |||
SupportedEngineVersions | Array of SupportedEngineVersion |
The available storage engine versions. |
|
SupportedEngineVersion | |||
SupportedEngines | Array of SupportedEngine |
The available storage engines. |
|
SupportedEngine | |||
SupportedNodeTypes | Array of SupportedNodeType |
The available node types. |
|
SupportedNodeType | |||
NodeType | String | 3 |
The number of nodes in the instance. |
NetworkTypes | String | VPC |
The network type of the instance. |
AvailableResources | Array of AvailableResource |
Details about the available resources. |
|
AvailableResource | |||
InstanceClassRemark | String | 4 cores, 8 GB (Dedicated) (Current instance type: mdb.shard.2x.xlarge.d (4 cores, 8 GB (Dedicated cloud-disk), maximum connections: 3000, maximum IOPS: min{1800 + 50 × Storage capacity, 21000})) |
The instance type. |
InstanceClass | String | mdb.shard.2x.xlarge.d |
The instance class. |
DBInstanceStorageRange | Object |
The storage capacity range of the instance. |
|
Min | Integer | 20 |
The minimum storage capacity. Unit: GB. |
Max | Integer | 16000 |
The maximum storage capacity. Unit: GB. |
Step | Integer | 10 |
The step size for adjusting the storage capacity. Unit: GB. |
Engine | String | WiredTiger |
The storage engine of the instance. |
Version | String | 4.0 |
The database engine version of the instance. |
ZoneId | String | cn-hangzhou-h |
The zone ID of the instance. |
RegionId | String | cn-hangzhou |
The region ID of the instance. |
DbType | String | sharding |
The architecture of the instance. Valid values:
|
Examples
Sample requests
http(s)://mongodb.aliyuncs.com/?Action=DescribeAvailableResource
&RegionId=cn-hangzhou
&<Common request parameters>
Sample success responses
XML
format
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 cores, 8 GB (Dedicated) (Current instance type: mdb.shard.2x.xlarge.d (4 cores, 8 GB (Dedicated cloud-disk), maximum connections: 3000, maximum IOPS: min{1800 + 50 × Storage capacity, 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
format
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 cores, 8 GB (Dedicated) (Current instance type: mdb.shard.2x.xlarge.d (4 cores, 8 GB (Dedicated cloud-disk), maximum connections: 3000, maximum IOPS: min{1800 + 50 × Storage capacity, 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"
} ]
}
Error codes
For a list of error codes, visit the API Error Center.