All Products
Search

This Product

    :Mengubah spesifikasi instans

    Document Center

    :Mengubah spesifikasi instans

    Last Updated:May 26, 2026

    Anda dapat memanggil operasi ModifyDBInstanceSpec untuk mengubah tipe instans atau kapasitas penyimpanan suatu instans. Operasi ini didukung untuk instans primary dan instans read-only, tetapi tidak didukung untuk instans disaster recovery maupun instans temporary.

    Sebelum memanggil operasi ini, pastikan persyaratan berikut terpenuhi:

    • Instans berada dalam status Running.
    • Instans tidak memiliki tugas backup yang sedang berjalan.
    • Setidaknya salah satu parameter DBInstanceClass atau DBInstanceStorage ditentukan dalam permintaan.
    • Jika Anda ingin mengurangi kapasitas penyimpanan, kapasitas penyimpanan baru yang Anda tentukan harus lebih besar dari atau sama dengan 1,1 kali kapasitas penyimpanan yang telah digunakan.
    • Instans merupakan instans primary atau read-only.
    Catatan Untuk melakukan upgrade edisi RDS instans, cukup pilih tipe instans yang mendukung edisi RDS yang diinginkan. Misalnya, jika Anda ingin meng-upgrade edisi RDS instans dari RDS Basic Edition ke RDS High-availability Edition, pilih saja tipe instans yang mendukung RDS High-availability Edition.

    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 ini untuk berbagai SDK.

    Parameter permintaan

    Parameter Tipe Wajib Contoh Deskripsi
    Action String Yes ModifyDBInstanceSpec

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyDBInstanceSpec.

    DBInstanceId String Yes rm-uf6wjk5*******

    ID instans.

    DBInstanceClass String No rds.mys2.small

    Tipe instans baru untuk instans tersebut. Untuk informasi selengkapnya, lihat Tipe instans ApsaraDB RDS primary. Anda dapat memanggil operasi DescribeAvailableClasses untuk menanyakan tipe instans yang tersedia di suatu wilayah.

    Catatan
    • Anda harus menentukan setidaknya salah satu parameter DBInstanceClass atau DBInstanceStorage.
    • Anda dapat memanggil operasi DescribeDBInstanceAttribute untuk menanyakan tipe instans yang sedang digunakan oleh instans tersebut.
    DBInstanceStorage Integer No 20

    Kapasitas penyimpanan baru untuk instans tersebut. Satuan: GB. Anda dapat menambah kapasitas penyimpanan dengan ukuran langkah 5 GB. Untuk informasi selengkapnya, lihat Tipe instans ApsaraDB RDS primary. Anda dapat memanggil operasi DescribeAvailableClasses untuk menanyakan rentang kapasitas penyimpanan yang didukung oleh suatu tipe instans.

    Catatan
    • Anda harus menentukan setidaknya salah satu parameter DBInstanceStorage atau DBInstanceClass.
    • Jika instans menjalankan MySQL pada RDS High-availability Edition dan menggunakan local SSD, Anda dapat mengurangi kapasitas penyimpanan dengan ukuran langkah 5 GB.
    • Anda dapat memanggil operasi DescribeDBInstanceAttribute untuk menanyakan kapasitas penyimpanan saat ini dari instans tersebut.
    PayType String Yes Postpaid

    Metode penagihan instans. Nilai yang valid:

    • Postpaid: pay-as-you-go
    • Prepaid: subscription
    EffectiveTime String No MaintainTime

    Waktu penerapan perubahan. Nilai yang valid:

    • Immediate: Perubahan langsung diterapkan.
    • MaintainTime: Perubahan diterapkan selama jendela maintenance yang ditentukan. Untuk informasi selengkapnya, lihat ModifyDBInstanceMaintainTime.
    Catatan Nilai default: Immediate.
    EngineVersion String No 5.6

    Versi mesin database instans.

    • Nilai yang valid ketika Anda menetapkan parameter Engine ke MySQL: 5.5, 5.6, 5.7, dan 8.0
    • Nilai yang valid ketika Anda menetapkan parameter Engine ke SQLServer: 2008r2, 08r2_ent_ha, 2012, 2012_ent_ha, 2012_std_ha, 2012_web, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_std_ha, 2017_ent, 2019_std_ha, dan 2019_ent
    • Nilai yang valid ketika Anda menetapkan parameter Engine ke PostgreSQL: 10.0, 11.0, 12.0, 13.0, 14.0, dan 15.0
    • Nilai yang valid ketika Anda menetapkan parameter Engine ke MariaDB: 10.3
    DBInstanceStorageType String No local_ssd

    Tipe penyimpanan instans. Nilai yang valid:

    • local_ssd: local SSD.
    • cloud_ssd: standard SSD. Tipe penyimpanan ini tidak direkomendasikan dan tidak tersedia di beberapa wilayah Alibaba Cloud.
    • cloud_essd: enhanced SSD (ESSD) tingkat kinerja 1 (PL1).
    • cloud_essd2: ESSD PL2.
    • cloud_essd3: ESSD PL3.

    Untuk mengubah tipe penyimpanan, perhatikan hal-hal berikut:

    • Jika instans menjalankan PostgreSQL, Anda dapat melakukan upgrade tipe penyimpanan instans dari standard SSD ke ESSD. Namun, Anda tidak dapat menurunkan tipe penyimpanan instans dari ESSD ke standard SSD. ESSD menyediakan tingkat kinerja (PL) berikut: ESSD PL1, ESSD PL2, dan ESSD PL3. Anda dapat melakukan upgrade atau downgrade tipe penyimpanan antara ESSD PL1, ESSD PL2, dan ESSD PL3. Untuk informasi selengkapnya, lihat Item konfigurasi.
    Direction String No Up

    Jenis perubahan yang ingin Anda lakukan pada instans. Nilai yang valid:

    • Up: melakukan upgrade pada instans subscription, atau melakukan upgrade atau downgrade pada instans pay-as-you-go.
    • Down: menurunkan spesifikasi instans subscription.
    • TempUpgrade: melakukan perubahan spesifikasi elastis pada instans subscription. Nilai ini wajib ditentukan untuk perubahan spesifikasi elastis.
    Catatan
    • Nilai default: Up.
    • Jika Anda hanya menentukan parameter DBInstanceStorageType, Anda dapat mengosongkan parameter Direction. Misalnya, jika Anda hanya ingin mengubah tipe penyimpanan instans dari standard SSD ke ESSD, Anda tidak perlu menentukan parameter Direction.
    SourceBiz String No N/A

    Parameter yang sudah tidak digunakan lagi.

    DedicatedHostGroupId String No dhg-7a9********

    ID klaster khusus tempat instans tersebut berada.

    ZoneId String No cn-hangzhou-b

    ID zona instans.

    SwitchTime String No 2019-07-10T13:15:12Z

    Waktu saat Anda ingin mengubah spesifikasi. Kami menyarankan agar Anda mengubah spesifikasi selama jam sepi. Tentukan waktu sesuai standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

    Catatan
    • Anda harus menentukan titik waktu yang lebih lambat dari waktu saat ini—yaitu waktu saat operasi ini dipanggil. Jika tidak, task perubahan spesifikasi akan gagal. Jika task tersebut gagal, Anda harus menunggu hingga Pesanan dibatalkan secara otomatis, lalu memanggil kembali operasi ini.
    • Jika Anda ingin menambah kapasitas penyimpanan atau mengubah tipe penyimpanan ESSD antar PL yang berbeda, perubahan spesifikasi akan langsung berlaku dan tidak memengaruhi beban kerja Anda. Dalam hal ini, Anda tidak perlu mengonfigurasi parameter ini.
    ResourceGroupId String No rg-acfmy**********

    ID kelompok sumber daya tempat instans tersebut berada.

    UsedTime Long No 3

    Periode validitas perubahan spesifikasi pada instans ApsaraDB RDS for SQL Server. Satuan: hari.

    MaxCapacity double No 8

    Jumlah maksimum RDS Capacity Units (RCUs).

    MinCapacity double No 0.5

    Jumlah minimum RCUs.

    AutoPause Boolean No true

    Menentukan apakah fitur suspensi otomatis diaktifkan.

    SwitchForce Boolean No false

    Menentukan apakah fitur scaling paksa diaktifkan untuk instans serverless. Nilai yang valid:

    • true: mengaktifkan fitur.
    • false: menonaktifkan fitur. Ini adalah nilai default.
    Category String No HighAvailability

    Edisi RDS instans. Nilai yang valid:

    • Basic: RDS Basic Edition.
    • HighAvailability: RDS High-availability Edition.

    • AlwaysOn: RDS Cluster Edition untuk SQL Server

    • Finance: RDS Enterprise Edition. Edisi ini hanya tersedia di situs China (aliyun.com).
    Catatan Jika Anda menetapkan parameter EngineVersion ke versi SQL Server, Anda juga harus menentukan parameter ini.

    Parameter respons

    Parameter Tipe Contoh Deskripsi
    DBInstanceId String rm-uf6wjk5*******

    ID instans.

    RequestId String 3C5CFDEE-F774-4DED-89A2-1D76EC63C575

    ID permintaan.

    OrderId Long 20793850608****

    ID pesanan.

    Contoh

    Permintaan contoh

    http(s)://rds.aliyuncs.com/?Action=ModifyDBInstanceSpec
&DBInstanceId=rm-uf6wjk5*******
&PayType=Postpaid
&DBInstanceClass=rds.mys2.small
&<Common request parameters>

    Respons sukses contoh

    XML format

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

<ModifyDBInstanceSpecResponse>
    <RequestId>3C5CFDEE-F774-4DED-89A2-1D76EC63C575</RequestId>
    <DBInstanceId>rm-uf6wjk5*******</DBInstanceId>
    <OrderId>20793850608****</OrderId>
</ModifyDBInstanceSpecResponse>

    JSON format

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

{
  "RequestId" : "3C5CFDEE-F774-4DED-89A2-1D76EC63C575",
  "DBInstanceId" : "rm-uf6wjk5*******",
  "OrderId" : "20793850608****"
}

    Kode kesalahan

    Kode status HTTP Kode kesalahan Pesan kesalahan Deskripsi
    400 CannotDecreaseEssdPerfLevel cannot decrease cloud essd performance level. Pesan kesalahan yang dikembalikan karena perubahan tipe penyimpanan tidak diizinkan. Tipe penyimpanan instans yang menjalankan SQL Server dengan standard SSD hanya dapat diubah menjadi ESSD. Tipe penyimpanan instans yang menjalankan SQL Server dengan local SSD dapat diubah menjadi standard SSD atau ESSD.
    400 InvalidEssdStorageSize invalid cloud essd storage size. Pesan kesalahan yang dikembalikan karena tipe instans yang ditentukan tidak valid. Anda harus memilih tipe instans yang valid dan mencoba lagi.
    400 NotSupportReduceDiskSize Not support reduce disk size. Pesan kesalahan yang dikembalikan karena kapasitas penyimpanan instans tidak dapat dikurangi.
    400 InvalidDBInstanceClass.NotFound Specified DB instance class is not found. Pesan kesalahan yang dikembalikan karena tipe instans baru tidak ditemukan atau tidak lagi tersedia untuk pembelian. Anda harus memilih tipe instans yang tersedia.
    400 InvalidAvZone.Format Specified AvZone is not valid. Pesan kesalahan yang dikembalikan karena nilai parameter ZoneID tidak valid.
    400 OperationDenied.OrderUnPaid The operation is not permitted due to the wrong Order status (Unpaid). Pesan kesalahan yang dikembalikan karena Anda memiliki pesanan yang belum dibayar. Anda harus membayar pesanan tersebut sebelum memanggil operasi ini.
    400 OperationDenied.InvalidStorageSize The storage size limit is exceeded. Pesan kesalahan yang dikembalikan karena penggunaan penyimpanan melebihi batas atas. Anda harus membersihkan atau memperluas kapasitas penyimpanan.
    400 InsufficientResourceCapacity The instance cluster does not support this operation. Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung di klaster khusus tempat instans tersebut berada.
    400 InvalidUsedTime The parameter usedTime is invalid. Pesan kesalahan yang dikembalikan karena nilai parameter UsedTime tidak valid.
    400 CannotChangeStorageType Temp upgrade does not support changing storage type. Pesan kesalahan yang dikembalikan karena upgrade elastis tidak mendukung perubahan tipe penyimpanan.
    400 TempUpgrade.NotSupport The instance does not support temp upgrade. Pesan kesalahan yang dikembalikan karena instans tidak mendukung upgrade elastis.
    400 EngineNotSupported Engine specified cannot be supported the operation. Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung oleh mesin database yang dijalankan pada instans. Anda harus memperbarui versi minor mesin.
    400 MaxscaleNotSupport Maxscale not supported Pesan kesalahan yang dikembalikan karena instans tidak mendukung fitur database proxy. Periksa konfigurasi database proxy yang Anda tentukan.
    400 ADInstanceNotSupportThisOperation The AD instance is not supported this operation Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk instans yang ditambahkan ke domain Active Directory (AD).
    400 BYOKInstanceNotSupportThisOperation The BYOK instance is not supported this operation Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk instans yang telah mengaktifkan enkripsi disk.
    400 BYOLInstanceNotSupportThisOperation The BYOL instance is not supported this operation Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk instans yang menggunakan Bring Your Own License (BYOL).
    400 SSLInstanceNotSupportThisOperation The instance opened SSL, upgrade is not this operation Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk instans yang telah mengaktifkan fitur enkripsi SSL.
    400 TDEInstanceNotSupportThisOperation The instance opened TDE, this operation is not supported Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk instans yang telah mengaktifkan fitur Transparent Data Encryption (TDE).
    400 InstanceIsSnapshotBackupNotSupportThisOperation The instance backup method is snapshot backup, this operation is not supported Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk instans yang telah mengaktifkan fitur snapshot backup.
    400 InstanceHasReadOnlyInstanceNotSupportThisOperation The instance has read-only instance or is read-only instance, this operation is not supported Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk instans read-only atau instans yang memiliki instans read-only yang terhubung.
    400 BackupReadInstanceModifyNotAllowed Modify Backup Read Instance Is Not Allowed. Pesan kesalahan yang dikembalikan karena Anda tidak diizinkan memodifikasi instans asal backup tersebut.
    400 MinorVersionNotSupport The current database minor version does not support the operation. Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung oleh versi minor mesin database instans saat ini.
    400 LX.ARGUMENT.ILLEGAL The parameters that you specified for the specification change are invalid. Pesan kesalahan yang dikembalikan karena parameter yang Anda tentukan untuk perubahan spesifikasi tidak valid.
    400 ORD.S.QUERY.PROD.ERROR An error occurred while querying the ordering information Pesan kesalahan yang dikembalikan karena pesanan tidak ditemukan.
    403 IncorrectDBInstanceType The database instance type does not support the operation. Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung oleh mesin database yang dijalankan pada instans.
    403 OperationDenied.NotSupportedBackupMethod When the storage is larger than 4000 GB, only snapshot backup is supported. Pesan kesalahan yang dikembalikan karena kapasitas penyimpanan lebih dari 4.000 GB dan hanya backup snapshot yang didukung.
    403 IncorrectReadDBInstanceDisksize Read instance disk size must be equal or higher than primary instance. Pesan kesalahan yang dikembalikan karena kapasitas penyimpanan instans read-only lebih kecil daripada kapasitas penyimpanan instans primary. Pastikan bahwa kapasitas penyimpanan instans read-only lebih besar dari atau sama dengan kapasitas penyimpanan instans primary.
    403 GroupReplicationNotSupport.InvalidEngineVersion Group Replication requires the instance engine version to be 8.0. Pesan kesalahan yang dikembalikan karena versi mesin utama instans bukan MySQL 8.0 sehingga MySQL group replication (MGR) tidak didukung.
    403 GroupReplicationNotSupport.InvalidNodeClassCode Group Replication requires the ClassCode of each node to be consistent. Pesan kesalahan yang dikembalikan karena spesifikasi node-node dalam instans berbeda sehingga MGR tidak didukung.
    403 GroupReplicationNotSupport.InvalidNodeNum Group Replication is not supported, the number of nodes must be an odd number greater than or equal to 3. Pesan kesalahan yang dikembalikan karena jumlah node dalam instans bukan bilangan ganjil yang lebih besar dari atau sama dengan 3 sehingga MGR tidak didukung.
    403 GroupReplicationNotSupport.InvalidXengine Group Replication is not supported because the instance has xengine tables. Pesan kesalahan yang dikembalikan karena tabel X-Engine ada dalam instans sehingga MGR tidak didukung.
    403 GroupReplicationNotSupport.MemoryTooSmall Group Replication is not supported because the memory is too small. Pesan kesalahan yang dikembalikan karena kapasitas memori instans kecil sehingga MGR tidak didukung.
    403 ARMNotSupport ARM arch does not support this operation. Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung oleh arsitektur ARM.
    403 HostTypeNotSupport Host type is inconsistent, please check that the original host type is the same as the target host type. Pesan kesalahan yang dikembalikan karena tipe host sebelum dan sesudah perubahan spesifikasi berbeda.
    403 CloudSSDNotSupport Cloud ssd does not support this operation, please upgrade to essd. Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung oleh tipe penyimpanan standard SSD. Anda harus melakukan upgrade tipe penyimpanan instans ke ESSD.
    403 MaxscaleInstanceNotSupport Instances with maxscale instance do not support this operation. Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung oleh instans yang telah mengaktifkan MaxScale.
    403 ReadInstanceNotSupport Instances with read-only do not support this operation. Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung oleh instans yang memiliki instans read-only yang terhubung.
    404 InvalidClusterKms The current instance does not authorized to access the Key Management Service. Pesan kesalahan yang dikembalikan karena instans tidak memiliki izin untuk mengakses Key Management Service (KMS).

    Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.