All Products
Search

This Product

    ApsaraDB for MongoDB:ModifyDBInstanceSpec

    Document Center

    ApsaraDB for MongoDB:ModifyDBInstanceSpec

    Last Updated:Jun 10, 2026

    Mengubah tipe instans atau ruang penyimpanan untuk instans mandiri, replica set, atau arsitektur tanpa server Database Apsara for MongoDB. Instans arsitektur tanpa server eksklusif untuk situs Alibaba Cloud China.

    Deskripsi operasi

    Before calling this operation, make sure you understand the billing method and pricing of ApsaraDB for MongoDB.

    This operation applies only to ApsaraDB for MongoDBstandalone instances and replica set instances. To change the configuration of a sharded cluster instance, call the ModifyNodeSpec, CreateNode, DeleteNode, or ModifyNodeSpecBatch operations.

    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:ModifyDBInstanceSpec

    update

    *Instance

    acs:dds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    DBInstanceId

    string

    Yes

    ID instans.

    dds-bp1ea17b41ab****
    DBInstanceClass

    string

    No

    Tipe instans. Untuk informasi selengkapnya, lihat Tipe instans. Anda juga dapat memanggil operasi DescribeAvailableResource untuk mengkueri tipe instans.

    • Untuk Instans mandiri atau instans replica set, parameter ini menentukan tipe instans. Untuk informasi selengkapnya, lihat Tipe instans. Anda juga dapat memanggil operasi DescribeAvailableResource untuk mengkueri tipe instans dari instans mandiri dan replica set.

    • Untuk instans arsitektur tanpa server, parameter ini menentukan kapasitas komputasi instans. Nilai valid: 100 hingga 8000.

    Catatan

    Anda harus mengonfigurasi salah satu dari parameter DBInstanceStorage dan DBInstanceClass.

    dds.sn4.xlarge.1
    DBInstanceStorage

    string

    No

    Kapasitas penyimpanan instans. Nilai harus berupa bilangan bulat yang lebih besar dari atau sama dengan 10. Nilai meningkat dengan kelipatan 10. Unit: GB. Nilai yang dapat ditentukan untuk parameter ini bergantung pada tipe instans. Untuk informasi selengkapnya, lihat Tipe instans.

    Catatan

    • Anda harus mengonfigurasi salah satu dari parameter DBInstanceClass dan DBInstanceStorage.

    • Anda tidak dapat mengurangi kapasitas penyimpanan instans.

    50
    OrderType

    string

    No

    Tipe perubahan spesifikasi. Nilai valid:

    • UPGRADE: Peningkatan spesifikasi. Ini adalah nilai default.

    • DOWNGRADE: menurunkan spesifikasi.

    Catatan

    Parameter ini hanya tersedia untuk instans langganan.

    UPGRADE
    AutoPay

    boolean

    No

    Apakah akan mengaktifkan pembayaran otomatis untuk instans. Nilai valid:

    • true: Mengaktifkan pembayaran otomatis. Pastikan akun Anda memiliki saldo yang cukup. Ini adalah nilai default.

    • false: Menonaktifkan pembayaran otomatis. Anda dapat log on ke Konsol Database Apsara for MongoDB untuk membayar instans. Di sudut kanan atas halaman, pilih Manajemen Penagihan > Manajemen Penagihan. Di panel navigasi sisi kiri, klik Pesanan. Pada halaman Pesanan Produk, cari pesanan lalu selesaikan pembayaran..

    true
    BusinessInfo

    string

    No

    Informasi bisnis.

    {“ActivityId":"000000000"}
    ReplicationFactor

    string

    No

    Jumlah node dalam instans. Nilai default: 3.

    • Nilai valid untuk instans replica set: 3, 5, dan 7.

    • Nilai untuk Instans mandiri ditetapkan pada 1.

    • Nilai untuk instans replica set dengan penyimpanan bersama (hanya tersedia di situs China) ditetapkan pada 2.

    Catatan

    Parameter ini tidak diperlukan untuk instans arsitektur tanpa server (hanya tersedia di situs China).

    3
    ReadonlyReplicas

    string

    No

    Jumlah node hanya-baca. Nilai valid: 0 hingga 5.

    Jika jenis jaringan instans diatur hanya ke jaringan klasik dan VPC, Anda perlu mengaktifkan akses publik atau merilis titik akhir jaringan klasik sebelum dapat mengubah jumlah node hanya-baca.

    Catatan

    Anda dapat log on ke Konsol Database Apsara for MongoDB lalu membuka halaman Koneksi Database untuk Tampilan jenis jaringan yang telah diaktifkan.

    1
    CouponNo

    string

    No

    Apakah akan menggunakan kupon. Nilai valid:

    • default atau null (default): Kupon digunakan.

    • youhuiquan_promotion_option_id_for_blank: Tidak ada kupon yang digunakan.

    default
    EffectiveTime

    string

    No

    Pengatur waktu efektif perubahan konfigurasi. Nilai valid:

    • Immediately: Perubahan konfigurasi segera berlaku. Ini adalah nilai default.

    • MaintainTime: Perubahan konfigurasi berlaku selama Jendela pemeliharaan instans.

    Immediately
    ExtraParam

    string

    No

    Parameter tambahan. Nilai valid:

    • async: Hasil dikembalikan setelah pesanan perubahan spesifikasi dibuat.

    • sync: Hasil dikembalikan setelah perubahan spesifikasi instans dikirimkan.

    Valid values:

    • async :

      async.

    • sync :

      sync.

    async
    TargetZoneId

    string

    No

    Zona tujuan tempat Anda ingin memigrasikan instans saat Anda mengubah spesifikasi dan memigrasikan instans antar zona.

    Penting Parameter ini hanya berlaku untuk instans cloud disk.
    Penting Nilai parameter ini tidak boleh sama dengan nilai parameter TargetSecondaryZoneId atau TargetHiddenZoneId.

    Catatan

    • Anda harus menentukan parameter ini hanya saat Anda mengubah spesifikasi dan memigrasikan instans antar zona.

    • Zona tujuan dan zona saat ini harus berada di Wilayah yang sama.

    • Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID zona.

    cn-hangzhou-j
    TargetSecondaryZoneId

    string

    No

    Zona sekunder tujuan untuk node sekunder saat Anda mengubah spesifikasi dan memigrasikan instans antar zona.

    Penting Parameter ini hanya berlaku untuk instans cloud disk.
    Penting Nilai parameter ini tidak boleh sama dengan nilai parameter TargetZoneId atau TargetHiddenZoneId.

    Catatan

    • Anda harus menentukan parameter ini hanya saat Anda mengubah spesifikasi dan memigrasikan instans antar zona.

    • Parameter ini hanya tersedia untuk migrasi multi-zona.

    • Zona tujuan dan zona saat ini harus berada di Wilayah yang sama.

    • Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID zona.

    cn-hangzhou-h
    TargetHiddenZoneId

    string

    No

    Zona tujuan untuk node tersembunyi saat Anda mengubah spesifikasi dan memigrasikan instans antar zona.

    Penting Parameter ini hanya berlaku untuk instans cloud disk.
    Penting Nilai parameter ini tidak boleh sama dengan nilai parameter TargetZoneId atau TargetSecondaryZoneId.

    Catatan

    • Anda harus menentukan parameter ini hanya saat Anda mengubah spesifikasi dan memigrasikan instans antar zona.

    • Parameter ini hanya tersedia untuk migrasi multi-zona.

    • Zona tujuan dan zona saat ini harus berada di Wilayah yang sama.

    • Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID zona.

    cn-hangzhou-i
    TargetVswitchId

    string

    No

    ID vSwitch tujuan saat Anda mengubah spesifikasi dan memigrasikan instans antar zona.

    Penting Parameter ini hanya berlaku untuk instans cloud disk.

    Catatan

    • Anda harus menentukan parameter ini hanya saat Anda mengubah spesifikasi dan memigrasikan instans antar zona.

    vsw-bp1buy0h9myt5i9e7****

    SearchNodeClass

    string

    No

    Spesifikasi node Search yang akan diubah.

    mdb.shard.2x.xlarge.d
    SearchNodeStorage

    integer

    No

    Kapasitas node Search yang akan diubah.

    20
    SearchNodeCount

    integer

    No

    Jumlah node Search yang akan diubah.

    2

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID.

    1E9F1104-19E7-59F0-AB7F-F4EBFDEA****
    OrderId

    string

    The order ID.

    21012408824****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "1E9F1104-19E7-59F0-AB7F-F4EBFDEA****",
  "OrderId": "21012408824****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 MissingParameter The input parameters DBInstanceClass and DBInstanceStorage all blank or no change.
    400 InvalidDBInstanceClass.ValueNotSupported The specified parameter DBInstanceClass is not valid.
    400 InvalidDBInstanceStorage.ValueNotSupported The specified parameter DBInstanceStorage is not valid.
    400 LX_REQUEST_TOKEN_CONFLICT The request token is conflict.
    400 TradeConfirmPayError BIZ_ERROR - degrade refund error
    400 PRICE.ORIGIN_PRICE_ERROR Origin lingxiao price request error.
    400 ErrorInsufficientResource There is not enough resource for your operation, requestId: %s.
    403 OperationDenied The resource is out of usage.
    403 InvaildDBInstanceClassInRegion.NotAvailable The DBInstanceClass in the Region is not available.
    404 InvalidDBInstanceId.NotFound The DBInstanceId provided does not exist in our records.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.