調用DescribeAvailableResource介面查詢某地區可售賣資源資訊。

说明 1分鐘內最多調用20次本介面。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱 類型 是否必選 樣本值 描述
Action String 是 DescribeAvailableResource

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

InstanceChargeType String 是 Postpaid

付費類型，取值：

  • Prepaid：訂用帳戶；
  • Postpaid：隨用隨付。
RegionId String 否 cn-hangzhou

地區ID，可以通過介面DescribeRegions查看可用的地區ID。

ZoneId String 否 cn-hangzhou-b

可用性區域ID。多可用性區域用英文冒號（:）分隔。
Engine String 否 MySQL

資料庫類型，取值：

  • MySQL；
  • SQLServer；
  • PostgreSQL；
  • PPAS；
  • 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/2016_ent_ha/2016_std_ha/2016_web/2017_ent；
  • PostgreSQL：9.4/10.0；
  • PPAS：9.3/10.0；
  • MariaDB：10.3。
DBInstanceClass String 否 rds.mysql.s1.small

執行個體規格，詳情請參見執行個體規格表。

OrderType String 否 BUY

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

返回資料

名稱 類型 樣本值 描述
AvailableZones

可售賣的資源清單。
RegionId String cn-hangzhou

地區ID。
Status String Enable

當前地區是否可以售賣資源。取值：Enable | Disable
SupportedEngines

支援售賣的資料庫類型列表。
Engine String MySQL

資料庫類型。
SupportedEngineVersions

支援售賣的資料庫版本列表。
SupportedCategorys

支援售賣的系列列表。
Category String HighAvailability

執行個體系列。
SupportedStorageTypes

支援售賣的儲存類型列表。
AvailableResources

可售賣的資源清單。
DBInstanceClass String rds.mysql.s1.small

執行個體規格。
DBInstanceStorageRange

可售賣的儲存空間範圍列表。
Max Integer 2000

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

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

儲存空間的遞增大小。單位：GB。
StorageRange String "{\"values\":[{\"max\":2000,\"min\":5,\"step\":5}]}"

可售賣的儲存空間的規格。包括最大值、最小值和遞增大小。
StorageType String local_ssd

儲存類型。
Version String 5.7

資料庫版本。
ZoneId String cn-hangzhou-b

可用性區域ID。
RequestId String A32E046E-2643-4B65-828D-23FEED4853A3

請求ID。

樣本

請求樣本


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

正常返回樣本

XML 格式 

<DescribeAvailableResourceResponse>
  <RequestId>A32E046E-2643-4B65-828D-23FEED4853A3</RequestId>
	  <AvailableZones>
		    <AvailableZone>
			      <Status>Enable</Status>
			      <RegionId>cn-hangzhou</RegionId>
			      <ZoneId>cn-hangzhou-b</ZoneId>
			      <SupportedEngines>
				        <SupportedEngine>
					          <SupportedEngineVersions>
						            <SupportedEngineVersion>
							              <Version>5.6</Version>
							              <SupportedCategorys>
								                <SupportedCategory>
									                  <Category>HighAvailability</Category>
									                  <SupportedStorageTypes>
										                    <SupportedStorageType>
											                      <AvailableResources>
												                        <AvailableResource>
													                          <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>
												                        </AvailableResource>
											                      </AvailableResources>
											                      <StorageType>local_ssd</StorageType>
										                    </SupportedStorageType>
									                  </SupportedStorageTypes>
								                </SupportedCategory>
							              </SupportedCategorys>
						            </SupportedEngineVersion>
					          </SupportedEngineVersions>
					          <Engine>MySQL</Engine>
				        </SupportedEngine>
			      </SupportedEngines>
		    </AvailableZone>
	  </AvailableZones>
</DescribeAvailableResourceResponse>

JSON 格式 

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

錯誤碼

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