All Products
Search
Document Center

:Tingkatkan versi mesin utama instans ApsaraDB RDS for MySQL

Last Updated:May 27, 2026

Anda dapat memanggil operasi UpgradeDBInstanceEngineVersion untuk meningkatkan versi mesin utama instans ApsaraDB RDS for MySQL.

Catatan Biaya setelah peningkatan bervariasi tergantung pada tipe instans dan tipe penyimpanan instans asli serta instans baru.

Jika instans tersebut merupakan instans primary yang memiliki instans hanya baca atau instans disaster recovery yang terhubung, Anda harus meningkatkan versi mesin utama instans hanya baca atau instans disaster recovery tersebut sebelum meningkatkan versi mesin utama instans primary.

Sebelum memanggil operasi ini, pastikan persyaratan berikut terpenuhi:

  • Instans asli berada dalam status Running.
  • Instans menjalankan salah satu versi database berikut:
    • MySQL 5.7
    • MySQL 5.6
    • MySQL 5.5

Anda dapat memanggil operasi UpgradeDBInstanceMajorVersion untuk meningkatkan versi mesin utama instans ApsaraDB RDS for PostgreSQL.

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.

Parameter permintaan

Parameter Type Required Contoh Deskripsi
Action String Yes UpgradeDBInstanceEngineVersion

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke UpgradeDBInstanceEngineVersion.

ClientToken String No ETnLKlblzczshOTUbOCzxxxxxxxxxx

Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menghasilkan nilai ini dari sisi client, tetapi harus memastikan bahwa token yang dihasilkan unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh lebih dari 64 karakter.

DBInstanceId String Yes rm-uf6wjk5xxxxxxx

ID instans.

EngineVersion String Yes 5.7

Versi mesin utama yang dijalankan oleh instans baru. Nilai yang valid:

  • 8.0
  • 5.7
  • 5.6
EffectiveTime String No Immediate

Waktu penerapan perubahan. Nilai yang valid:

  • Immediate: Perubahan langsung diterapkan.
  • MaintainTime: Perubahan diterapkan selama jendela maintenance yang ditentukan. Untuk informasi selengkapnya, lihat ModifyDBInstanceMaintainTime.

Nilai default: Immediate.

Parameter respons

Parameter Type Contoh Deskripsi
TaskId String 10254125

ID task.

RequestId String 65BDA532-28AF-4122-AA39-B382721EEE64

ID request.

Contoh

Contoh permintaan

http(s)://rds.aliyuncs.com/?Action=UpgradeDBInstanceEngineVersion
&DBInstanceId=rm-uf6wjk5xxxxxxx
&EngineVersion=5.7
&<Common request parameters>

Contoh respons sukses

XML format

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

<?xml version="1.0" encoding="UTF-8" ?>
<UpgradeDBInstanceEngineVersionResponse>
	<RequestId> 65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>
	<TaskId>10254125</TaskId></UpgradeDBInstanceEngineVersionResponse>

JSON format

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

{
  "RequestId" : " 65BDA532-28AF-4122-AA39-B382721EEE64",
  "TaskId" : "10254125"
}

Kode kesalahan

Kode status HTTP Kode kesalahan Pesan kesalahan Deskripsi
400 InvalidOrderTask.NotSupport The Current InstanceId exist Order Task in RDS. Pesan kesalahan yang dikembalikan karena instans memiliki pesanan yang belum selesai. Coba lagi nanti.
400 InvalidSSLstatus Current DB instance has SSL enabled, this operation is not supported. Pesan kesalahan yang dikembalikan karena enkripsi SSL diaktifkan untuk instans tersebut.
400 InvalidDBInstanceConnType.Format Specified DB instance conn type is not valid. Pesan kesalahan yang dikembalikan karena jenis jaringan instans tidak mendukung operasi ini.
403 IncorrectDBInstanceState Current DB instance state does not support this operation. Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat instans berada dalam status saat ini.
403 IncorrectEngineVersion The engine version does not support the operation. Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung untuk versi mesin database yang dijalankan oleh instans.
403 IncorrectEngineTypeMyisam Current DB instance has MyISAM table, and it does not support this operation. Pesan kesalahan yang dikembalikan karena terdapat tabel MyISAM dalam instans.
403 InvalidInstanceLevel.Malformed Current DB instance level does not support this operation. Pesan kesalahan yang dikembalikan karena instans tidak mendukung operasi ini.
403 IncorrectDBInstanceLockMode Current DB instance lock mode does not support this operation. Pesan kesalahan yang dikembalikan karena instans terkunci.
404 InvalidDBInstance.NotFound The specified instance does not exist or is not supported. Pesan kesalahan yang dikembalikan karena instans yang ditentukan tidak ditemukan. Anda harus memeriksa ID instans tersebut.

Untuk daftar kode kesalahan, kunjungi Error Center.