All Products
Search

This Product

    ApsaraDB for MongoDB:DescribeAvailabilityZones

    Document Center

    ApsaraDB for MongoDB:DescribeAvailabilityZones

    Last Updated:Jun 10, 2026

    Mengkueri daftar zona yang didukung oleh instans Database Apsara untuk MongoDB.

    Deskripsi operasi

    Queries the zones in which an ApsaraDB for MongoDB instance can be deployed under specified purchase conditions. The region ID is required in the purchase condition.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    dds:DescribeAvailabilityZones

    list

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah instans. Anda dapat memanggil operasi DescribeRegions untuk mengkueri wilayah terbaru yang tersedia.

    cn-hangzhou
    ZoneId

    string

    No

    ID zona instans. Anda dapat memanggil operasi DescribeRegions untuk mengkueri zona yang tersedia.

    cn-hangzhou-b
    InstanceChargeType

    string

    No

    Metode penagihan produk. Nilai valid:

    • PrePaid: langganan

    • PostPaid: pay-as-you-go.

    PrePaid
    DbType

    string

    No

    Arsitektur instans. Nilai valid:

    • normal: instans replica set

    • sharding: instans kluster sharded.

    normal
    ResourceGroupId

    string

    No

    ID kelompok sumber daya. Untuk informasi lebih lanjut, lihat Tampilan informasi dasar kelompok sumber daya.

    rg-acfmx2m4rqu7pry
    AcceptLanguage

    string

    No

    Bahasa nilai parameter RegionName dan ZoneName yang dikembalikan. Nilai valid:

    • zh (default): Mandarin

    • en: Inggris.

    zh
    StorageSupport

    string

    No

    Tipe penyimpanan. Nilai valid:

    • cloud: hanya menampilkan zona yang tersedia untuk instans yang menggunakan cloud disk.

    • local: hanya menampilkan zona yang tersedia untuk instans yang menggunakan disk lokal.

    • default atau tidak ditentukan: menampilkan zona yang tersedia untuk instans yang menggunakan cloud disk maupun disk lokal.

    local
    MongoType

    string

    No

    Edisi instans. High-Available Edition dan Tampilan Edition (dbfs) didukung.

    dbfs
    StorageType

    string

    No

    Tipe penyimpanan. Nilai valid:

    • cloud_essd1: PL1 Enterprise SSDs (ESSDs)

    • cloud_essd2: PL2 ESSDs

    • cloud_essd3: PL3 ESSDs

    • local_ssd: SSD lokal

    Catatan

    • Instans yang menjalankan MongoDB 4.4 atau lebih baru hanya menggunakan cloud disk untuk menyimpan data. Jika Anda tidak menentukan parameter ini, nilai cloud_essd1 digunakan secara default.

    • Instans yang menjalankan MongoDB 4.2 atau lebih lama hanya menggunakan disk lokal untuk menyimpan data. Jika Anda tidak menentukan parameter ini, nilai local_ssd digunakan secara default.

    local_ssd
    ExcludeZoneId

    string

    No

    ID zona yang dikecualikan dari hasil kueri.

    cn-shanghai-g
    ExcludeSecondaryZoneId

    string

    No

    ID zona sekunder yang dikecualikan dari hasil kueri. Anda dapat mengonfigurasi parameter ExcludeZoneId dan ExcludeSecondaryZoneId untuk menentukan ID beberapa zona yang dikecualikan dari hasil kueri.

    cn-shanghai-b
    DBInstanceClass

    string

    No

    Tipe instans dari instans tersebut.

    dds.mongo.standard
    EngineVersion

    string

    No

    Versi mesin database instans.

    5.0
    ReplicationFactor

    string

    No

    Jumlah node dalam instans.

    Catatan

    Parameter ini hanya tersedia untuk instans replica set.

    Nilai valid:

    • 1

    • 3

    • 5

    Valid values:

    • 1 :

      1

    • 3 :

      3

    • 5 :

      5

    • 7 :

      7

    3
    InstanceType

    string

    No

    Arsitektur instans. Nilai valid:

    • sharding: instans kluster sharded

    • replicate: instans replica set atau Instans mandiri.

    replicate

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The ID of the request.

    19A13A33-0FAD-5120-8AE1-B1636F74DD80
    AvailableZones

    array<object>

    The details of the zones in which you can create ApsaraDB for MongoDB instances.

    object

    ZoneId

    string

    The ID of the zone.

    cn-beijing-f
    ZoneName

    string

    The name of the zone.

    The return value of the ZoneName parameter is in the language that is specified by the AcceptLanguage parameter. For example, if the value of the ZoneId parameter in the response is cn-hangzhou-h, the following values are returned for the ZoneName parameter:

    • If the value of the AcceptLanguage parameter is zh, H is returned for the ZoneName parameter.

    • If the value of the AcceptLanguage parameter is en, Hangzhou Zone H is returned for the ZoneName parameter.

    杭州 可用区H
    RegionId

    string

    The ID of the region. You can call the DescribeRegions operation to query the latest available regions.

    cn-beijing

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "19A13A33-0FAD-5120-8AE1-B1636F74DD80",
  "AvailableZones": [
    {
      "ZoneId": "cn-beijing-f",
      "ZoneName": "杭州 可用区H",
      "RegionId": "cn-beijing"
    }
  ]
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.