All Products
Search

This Product

    ApsaraDB for MongoDB:ModifyDBInstanceSpec

    Document Center

    ApsaraDB for MongoDB:ModifyDBInstanceSpec

    Last Updated:Dec 16, 2025

    Mengubah tipe instans atau kapasitas penyimpanan instans mandiri, instans set replika, atau instans Serverless ApsaraDB for MongoDB. Instans Serverless hanya tersedia di Alibaba Cloud China Website (www.aliyun.com).

    Deskripsi operasi

    Sebelum memanggil operasi ini, pastikan Anda memahami metode penagihan dan pricing ApsaraDB for MongoDB.

    Operasi ini hanya berlaku untuk instans mandiri dan instans set replika ApsaraDB for MongoDB. Untuk mengubah konfigurasi instans kluster sharded, panggil operasi ModifyNodeSpec, CreateNode, DeleteNode, atau ModifyNodeSpecBatch.

    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 Instance types. Anda juga dapat memanggil operasi DescribeAvailableResource untuk menanyakan tipe instans.

    • Untuk instans mandiri dan instans set replika, parameter ini menentukan tipe instans. Untuk informasi selengkapnya, lihat Instance types. Anda juga dapat memanggil operasi DescribeAvailableResource untuk menanyakan tipe instans mandiri dan set replika.

    • Untuk instans Serverless, parameter ini menentukan kapasitas komputasi. Nilai yang valid: 100 hingga 8000.

    Catatan

    Tentukan minimal salah satu dari parameter ini dan parameter DBInstanceStorage.

    dds.sn4.xlarge.1
    DBInstanceStorage

    string

    No

    Kapasitas penyimpanan instans. Nilainya harus dalam rentang 10 GB hingga 3.000 GB. Ukuran langkahnya adalah 10 GB. Nilai spesifik dibatasi oleh tipe instans. Untuk informasi selengkapnya, lihat Instance types.

    Catatan

    • Tentukan minimal salah satu dari parameter ini dan parameter DBInstanceClass.

    • Anda tidak dapat mengurangi storage space.

    50
    OrderType

    string

    No

    Jenis perubahan konfigurasi. Nilai yang valid:

    • UPGRADE: Meningkatkan konfigurasi instans. Ini adalah nilai default.

    • DOWNGRADE: Menurunkan konfigurasi instans.

    Catatan

    Parameter ini hanya tersedia untuk instansi subscription.

    UPGRADE
    AutoPay

    boolean

    No

    Menentukan apakah auto-payment diaktifkan untuk instans. Nilai yang valid:

    • true: Auto-payment diaktifkan. Ini adalah nilai default. Pastikan saldo akun Anda mencukupi.

    • false: Diperlukan pembayaran manual. Untuk membayar pesanan, login ke konsol ApsaraDB for MongoDB. Di pojok kanan atas halaman, pilih Expenses > Expenses and Costs. Di panel navigasi sebelah kiri, klik Order Management. Di halaman Product Orders, temukan pesanan tersebut dan selesaikan pembayaran.

    true
    BusinessInfo

    string

    No

    Informasi bisnis.

    {“ActivityId":"000000000"}
    ReplicationFactor

    string

    No

    Jumlah node dalam instans. Nilai default adalah 3.

    • Untuk instans set replika, nilai yang valid adalah 3, 5, dan 7.

    • Untuk instans mandiri, nilainya tetap 1.

    • Untuk instans set replika yang menggunakan shared storage (hanya tersedia di website Alibaba Cloud China (www.aliyun.com)), nilainya tetap 2.

    Catatan

    Jangan konfigurasikan parameter ini untuk instans Serverless. Instans Serverless hanya tersedia di Alibaba Cloud China Website (www.aliyun.com).

    3
    ReadonlyReplicas

    string

    No

    Jumlah node read-only. Nilai yang valid: 0 hingga 5.

    Jika instans hanya terhubung melalui jaringan klasik dan virtual private cloud (VPC), aktifkan endpoint internet atau release endpoint jaringan klasik sebelum mengubah jumlah node read-only.

    Catatan

    Login ke konsol ApsaraDB for MongoDB dan lihat jenis jaringan yang diaktifkan di halaman Database Connection.

    1
    CouponNo

    string

    No

    Menentukan apakah akan menggunakan kupon. Nilai yang valid:

    • default atau null: Menggunakan kupon. Ini adalah nilai default.

    • youhuiquan_promotion_option_id_for_blank: Tidak menggunakan kupon.

    default
    EffectiveTime

    string

    No

    Waktu saat perubahan konfigurasi berlaku. Nilai yang valid:

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

    • MaintainTime: Perubahan berlaku selama jendela O&M instans.

    Immediately
    ExtraParam

    string

    No

    Parameter tambahan. Nilai yang valid:

    • async: Hasil dikembalikan setelah pesanan perubahan spesifikasi dibuat.

    • sync: Hasil dikembalikan setelah spesifikasi instans diubah.

    Valid values:

    • async :

      async

    • sync :

      sync

    async
    TargetZoneId

    string

    No

    Zona tujuan tempat Anda ingin memigrasikan instans. Tentukan parameter ini saat Anda mengubah spesifikasi instans dan memigrasikan instans lintas zona.

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

    Catatan

    • Parameter ini wajib ditentukan hanya saat Anda mengubah spesifikasi instans dan memigrasikan instans lintas zona.

    • Zona tujuan harus berada di wilayah yang sama dengan zona saat ini dari instans.

    • Panggil operasi DescribeRegions untuk menanyakan ID zona.

    cn-hangzhou-j
    TargetSecondaryZoneId

    string

    No

    Zona tujuan node secondary. Tentukan parameter ini saat Anda mengubah spesifikasi instans dan memigrasikan instans lintas zona.

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

    Catatan

    • Parameter ini wajib ditentukan hanya saat Anda mengubah spesifikasi instans dan memigrasikan instans lintas zona.

    • Parameter ini hanya tersedia untuk migrasi multi-zona.

    • Zona tujuan harus berada di wilayah yang sama dengan zona saat ini dari instans.

    • Panggil operasi DescribeRegions untuk menanyakan ID zona.

    cn-hangzhou-h
    TargetHiddenZoneId

    string

    No

    Zona tujuan node hidden. Tentukan parameter ini saat Anda mengubah spesifikasi instans dan memigrasikan instans lintas zona.

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

    Catatan

    • Parameter ini wajib ditentukan hanya saat Anda mengubah spesifikasi instans dan memigrasikan instans lintas zona.

    • Parameter ini hanya tersedia untuk migrasi multi-zona.

    • Zona tujuan harus berada di wilayah yang sama dengan zona saat ini dari instans.

    • Panggil operasi DescribeRegions untuk menanyakan ID zona.

    cn-hangzhou-i
    TargetVswitchId

    string

    No

    ID vSwitch tujuan. Tentukan parameter ini saat Anda mengubah spesifikasi instans dan memigrasikan instans lintas zona.

    Penting Parameter ini hanya berlaku untuk instans cloud disk.

    Catatan

    • Parameter ini wajib ditentukan hanya saat Anda mengubah spesifikasi instans dan memigrasikan instans lintas zona.

    vsw-bp1buy0h9myt5i9e7****

    SearchNodeClass

    string

    No

    Spesifikasi node Search.

    mdb.shard.2x.xlarge.d
    SearchNodeStorage

    integer

    No

    Kapasitas penyimpanan node Search.

    20
    SearchNodeCount

    integer

    No

    Jumlah node Search.

    2

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

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

    string

    ID pesanan.

    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.