調用DescribeAvailableResource接口查詢某地域可售賣資源信息。

本接口已下線，請使用DescribeAvailableZones和DescribeAvailableClasses。

說明 1分鐘內最多調用20次本接口。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 DescribeAvailableResource

系統規定參數。取值：DescribeAvailableResource。

RegionId String 否 cn-hangzhou

地域ID，可以通過接口DescribeRegions查看可用的地域ID。

ZoneId String 否 cn-hangzhou-b

可用區ID。
InstanceChargeType String 是 Postpaid

付費類型，取值：

  • Prepaid：包年包月
  • Postpaid：按量付費
Engine String 否 MySQL

數據庫類型，取值：

  • MySQL
  • SQLServer
  • PostgreSQL
  • MariaDB
EngineVersion String 否 5.7

數據庫版本，取值：

  • MySQL：5.5/5.6/5.7/8.0
  • SQL Server：2008r2/2012/2012_ent_ha/2012_std_ha/2012_web/2014_std_ha/2016_ent_ha/2016_std_ha/2016_web/2017_ent/2019_ent
  • PostgreSQL：9.4/10.0/11.0/12.0/13.0/14.0/15.0
  • MariaDB：10.3
DBInstanceClass String 否 rds.mysql.s1.small

實例規格，詳情請參見實例規格表。

OrderType String 否 BUY

訂單類型。僅唯一取值：BUY。

DBInstanceStorageType String 否 local_ssd

實例儲存類型，取值：

  • local_ssd：本地SSD盤
  • cloud_ssd：SSD云盤
  • cloud_essd：ESSD PL1云盤
  • cloud_essd2：ESSD PL2云盤
  • cloud_essd3：ESSD PL3云盤
Category String 否 Basic

實例系列，取值：

  • Basic：基礎版
  • HighAvailability：高可用版
  • AlwaysOn：集群版
  • Finance：三節點企業版
DispenseMode Integer 否 0

是否返回支持單可用區部署功能的可用區列表。取值：

  • 1：返回。
  • 0：不返回。

默認值：0

說明 單可用區部署功能支持將三節點企業版實例安裝到單個可用區中。

返回數據

名稱 類型 示例值 描述
RequestId String A32E046E-2643-4B65-828D-23FEED4853A3

請求ID。
AvailableZones Array of AvailableZone

支持售賣資源的可用區列表。
AvailableZone
ZoneId String cn-hangzhou-b

可用區ID。
Status String Enable

當前地域是否可以售賣資源。取值：

  • Enable：可售賣
  • Disable：不可售賣
RegionId String cn-hangzhou

地域ID。
SupportedEngines Array of SupportedEngine

支持售賣的數據庫類型列表。
SupportedEngine
Engine String MySQL

數據庫類型。
SupportedEngineVersions Array of SupportedEngineVersion

支持售賣的數據庫版本列表。
SupportedEngineVersion
Version String 5.7

數據庫版本。
SupportedCategorys Array of SupportedCategory

支持售賣的系列列表。
SupportedCategory
Category String HighAvailability

實例系列。
SupportedStorageTypes Array of SupportedStorageType

支持售賣的存儲類型列表。
SupportedStorageType
StorageType String local_ssd

存儲類型。
AvailableResources Array of AvailableResource

可售賣的資源列表。
AvailableResource
StorageRange String "{\"values\":[{\"max\":2000,\"min\":5,\"step\":5}]}"

可售賣的存儲空間的規格。包括最大值、最小值和遞增大小。
DBInstanceClass String rds.mysql.s1.small

實例規格。
DBInstanceStorageRange Object

可售賣的存儲空間范圍列表。
Step Integer 5

存儲空間的遞增大小。單位：GB。
Max Integer 2000

可售賣的存儲空間最大值。單位：GB。
Min Integer 5

可售賣的存儲空間最小值。單位：GB。

示例

請求示例

http(s)://rds.aliyuncs.com/?Action=DescribeAvailableResource
&InstanceChargeType=Postpaid
&<公共請求參數>

正常返回示例

XML格式 

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

<DescribeAvailableResourceResponse>
    <RequestId>A32E046E-2643-4B65-828D-23FEED4853A3</RequestId>
    <AvailableZones>
        <ZoneId>cn-hangzhou-b</ZoneId>
        <Status>Enable</Status>
        <RegionId>cn-hangzhou</RegionId>
        <SupportedEngines>
            <Engine>MySQL</Engine>
            <SupportedEngineVersions>
                <Version>5.7</Version>
                <SupportedCategorys>
                    <Category>HighAvailability</Category>
                    <SupportedStorageTypes>
                        <StorageType>local_ssd</StorageType>
                        <AvailableResources>
                            <StorageRange>"{\"values\":[{\"max\":2000,\"min\":5,\"step\":5}]}"</StorageRange>
                            <DBInstanceClass>rds.mysql.s1.small</DBInstanceClass>
                            <DBInstanceStorageRange>
                                <Step>5</Step>
                                <Max>2000</Max>
                                <Min>5</Min>
                            </DBInstanceStorageRange>
                        </AvailableResources>
                    </SupportedStorageTypes>
                </SupportedCategorys>
            </SupportedEngineVersions>
        </SupportedEngines>
    </AvailableZones>
</DescribeAvailableResourceResponse>

JSON格式 

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

{
  "RequestId" : "A32E046E-2643-4B65-828D-23FEED4853A3",
  "AvailableZones" : [ {
    "ZoneId" : "cn-hangzhou-b",
    "Status" : "Enable",
    "RegionId" : "cn-hangzhou",
    "SupportedEngines" : [ {
      "Engine" : "MySQL",
      "SupportedEngineVersions" : [ {
        "Version" : "5.7",
        "SupportedCategorys" : [ {
          "Category" : "HighAvailability",
          "SupportedStorageTypes" : [ {
            "StorageType" : "local_ssd",
            "AvailableResources" : [ {
              "StorageRange" : "\"{\\\"values\\\":[{\\\"max\\\":2000,\\\"min\\\":5,\\\"step\\\":5}]}\"",
              "DBInstanceClass" : "rds.mysql.s1.small",
              "DBInstanceStorageRange" : {
                "Step" : 5,
                "Max" : 2000,
                "Min" : 5
              }
            } ]
          } ]
        } ]
      } ]
    } ]
  } ]
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 ArticleNotFound Article not found 沒有找到相關約束

訪問錯誤中心查看更多錯誤碼。