Kueri sumber daya yang tersedia - - Alibaba Cloud Documentation Center

Anda dapat memanggil operasi DescribeAvailableResource untuk mengkueri sumber daya yang tersedia di suatu wilayah.

Operasi DescribeAvailableResource tidak lagi tersedia. Sebagai gantinya, Anda dapat menggunakan operasi DescribeAvailableZones dan DescribeAvailableClasses.

Catatan Anda dapat memanggil operasi DescribeAvailableResource hingga 20 kali dalam satu menit.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeAvailableResource	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeAvailableResource.
RegionId	String	No	cn-hangzhou	ID wilayah instans. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.
ZoneId	String	No	cn-hangzhou-b	ID zona instans.
InstanceChargeType	String	Yes	Postpaid	Metode penagihan instans. Nilai yang valid: Prepaid: subscription Postpaid: pay-as-you-go
Engine	String	No	MySQL	Engine database instans. Nilai yang valid: MySQL SQLServer PostgreSQL MariaDB
EngineVersion	String	No	5.7	Versi engine database instans. Nilai yang valid: Nilai yang valid saat Anda menetapkan parameter Engine ke MySQL: 5.5, 5.6, 5.7, dan 8.0 Nilai yang valid saat Anda menetapkan parameter Engine ke SQLServer: 2008r2, 2012, 2012_ent_ha, 2012_std_ha, 2012_web, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_ent, dan 2019_ent Nilai yang valid saat Anda menetapkan parameter Engine ke PostgreSQL: 10.0, 11.0, 12.0, 13.0, 14.0, dan 15.0 Nilai yang valid saat Anda menetapkan parameter Engine ke MariaDB: 10.3
DBInstanceClass	String	No	rds.mysql.s1.small	Tipe instans instans. Untuk informasi selengkapnya, lihat Tipe instans ApsaraDB RDS utama.
OrderType	String	No	BUY	Jenis pesanan. Tetapkan nilainya ke BUY.
DBInstanceStorageType	String	No	local_ssd	Jenis penyimpanan instans. Nilai yang valid: local_ssd: SSD lokal cloud_ssd: SSD standar cloud_essd: ESSD tingkat kinerja 1 (PL1) cloud_essd2: ESSD PL2 cloud_essd3: ESSD PL3
Category	String	No	Basic	Edisi RDS dari Instans. Nilai yang valid: Basic: RDS Basic Edition HighAvailability: RDS High-availability Edition AlwaysOn: RDS Cluster Edition Finance: RDS Enterprise Edition
DispenseMode	Integer	No	0	Menentukan apakah akan mengembalikan zona yang mendukung metode penerapan zona tunggal. Nilai yang valid: 1: mengembalikan zona tersebut. 0: tidak mengembalikan zona tersebut. Nilai default: 0. Catatan Metode penerapan zona tunggal memungkinkan Anda menerapkan instans yang menjalankan RDS Enterprise Edition di satu zona.

Parameter respons

Parameter	Type	Example	Description
RequestId	String	A32E046E-2643-4B65-828D-23FEED4853A3	ID permintaan.
AvailableZones	Array of AvailableZone		Array yang berisi zona tempat sumber daya tersedia.
AvailableZone
ZoneId	String	cn-hangzhou-b	ID zona instans.
Status	String	Enable	Menunjukkan apakah sumber daya di wilayah tersebut dapat dibeli. Nilai yang valid: Enable: Sumber daya di wilayah tersebut dapat dibeli. Disable: Sumber daya di wilayah tersebut tidak dapat dibeli.
RegionId	String	cn-hangzhou	ID wilayah instans.
SupportedEngines	Array of SupportedEngine		Array yang berisi engine database yang tersedia di zona tersebut.
SupportedEngine
Engine	String	MySQL	Mesin database yang dijalankan oleh Instans.
SupportedEngineVersions	Array of SupportedEngineVersion		Array yang berisi versi engine database yang tersedia di zona tersebut.
SupportedEngineVersion
Version	String	5.7	Versi engine database yang dijalankan oleh instans.
SupportedCategorys	Array of SupportedCategory		Array yang berisi edisi RDS yang tersedia.
SupportedCategory
Category	String	HighAvailability	Edisi RDS dari Instans.
SupportedStorageTypes	Array of SupportedStorageType		Array yang berisi jenis penyimpanan yang tersedia.
SupportedStorageType
StorageType	String	local_ssd	Jenis penyimpanan instans.
AvailableResources	Array of AvailableResource		Array yang berisi sumber daya yang tersedia.
AvailableResource
StorageRange	String	"{\"values\":[{\"max\":2000,\"min\":5,\"step\":5}]}"	Rentang kapasitas penyimpanan. Nilai ini terdiri dari kapasitas penyimpanan maksimum, kapasitas penyimpanan minimum, dan peningkatan kapasitas penyimpanan.
DBInstanceClass	String	rds.mysql.s1.small	Tipe instans instans.
DBInstanceStorageRange	Object		Array yang berisi rentang kapasitas penyimpanan.
Step	Integer	5	Peningkatan kapasitas penyimpanan. Satuan: GB.
Max	Integer	2000	Kapasitas penyimpanan maksimum yang dapat Anda beli. Satuan: GB.
Min	Integer	5	Kapasitas penyimpanan minimum yang harus Anda beli. Satuan: GB.

Contoh

Permintaan contoh

http(s)://rds.aliyuncs.com/?Action=DescribeAvailableResource
&InstanceChargeType=Postpaid
&<Common request parameters>

Respons sukses contoh

XML format

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 format

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
              }
            } ]
          } ]
        } ]
      } ]
    } ]
  } ]
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Description
400	ArticleNotFound	Article not found	Pesan kesalahan yang dikembalikan karena tidak ditemukan artikel yang relevan.

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.