DescribeRegions - - Alibaba Cloud Documentation Center

Mengambil daftar wilayah Alibaba Cloud yang tersedia.

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.

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeRegions	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeRegions.
InstanceChargeType	String	No	PrePaid	Metode penagihan instans. Untuk informasi selengkapnya, lihat Billing overview. Nilai yang valid: PrePaid: subscription. Jika Anda menetapkan parameter ini ke PrePaid, pastikan saldo atau kredit akun Anda mencukupi. Jika tidak, kode kesalahan InvalidPayMethod akan dikembalikan. PostPaid: pay-as-you-go. Nilai default: PostPaid.
ResourceType	String	No	instance	Jenis resource. Nilai yang valid: instance: Elastic Compute Service (ECS) instance. disk: disk reservedinstance: reserved instance scu: storage capacity unit (SCU) Nilai default: instance.
AcceptLanguage	String	No	zh-CN	Bahasa alami yang digunakan untuk memfilter respons. Untuk informasi selengkapnya, lihat RFC 7231. Nilai yang valid: zh-CN: Chinese en-US: English ja: Japanese Nilai default: zh-CN.

Response parameters

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.
Regions	Array of Region		Detail mengenai wilayah.
Region
Status	String	available	Menunjukkan apakah kluster telah habis terjual. Nilai yang valid: available soldOut
RegionEndpoint	String	ecs.aliyuncs.com	Titik akhir untuk wilayah tersebut.
LocalName	String	China (Qingdao)	Nama wilayah.
RegionId	String	cn-qingdao-et2-bo1	ID wilayah.

Examples

Contoh permintaan

https://ecs.aliyuncs.com/?Action=DescribeRegions
&RegionId=cn-qingdao
&InstanceChargeType=PrePaid
&ResourceType=Instance
&AcceptLanguage=en-US
&<Common request parameters>

Contoh respons sukses

XML format

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

<DescribeRegionsResponse>
    <RequestId>38EC7366-F5A9-46B1-BDB1-0FDC2E296397</RequestId>
    <Regions>
        <Region>
            <RegionId>cn-qingdao-et2-b01</RegionId>
            <RegionEndpoint>ecs.aliyuncs.com</RegionEndpoint>
            <LocalName>China (Qingdao)</LocalName>
        </Region>
        <Region>
            <RegionId>cn-qingdao-nebula</RegionId>
            <RegionEndpoint>ecs.cn-qingdao-nebula.aliyuncs.com</RegionEndpoint>
            <LocalName>cn-qingdao-nebula</LocalName>
        </Region>
    </Regions>
</DescribeRegionsResponse>

JSON format

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

{
  "RequestId" : "38EC7366-F5A9-46B1-BDB1-0FDC2E296397",
  "Regions" : {
    "Region" : [ {
      "RegionId" : "cn-qingdao-et2-b01",
      "RegionEndpoint" : "ecs.aliyuncs.com",
      "LocalName" : "China (Qingdao)"
    }, {
      "RegionId" : "cn-qingdao-nebula",
      "RegionEndpoint" : "ecs.cn-qingdao-nebula.aliyuncs.com",
      "LocalName" : "cn-qingdao-nebula"
    } ]
  }
}

Error codes

HTTP status code	Error code	Error message	Description
403	Unauthorized.EmptyRegion	The specified account has no access authority to any region.	Anda tidak memiliki izin untuk mengakses wilayah. Ajukan izin yang diperlukan dan coba lagi.
404	InvalidAcceptLanguage.NotFound	Only Chinese (zh-CN), English (en-US), and Japanese (ja) are allowed.	Bahasa yang dipilih tidak didukung. Hanya bahasa Mandarin, Inggris, dan Jepang yang didukung.
404	InvalidResourceType.NotFound	The ResourceType provided does not exist in our records.	Jenis resource yang ditentukan tidak ditemukan.

Untuk daftar kode kesalahan, lihat Service error codes.