All Products
Search

This Product

    :Ubah parameter instans

    Document Center

    :Ubah parameter instans

    Last Updated:May 26, 2026

    Anda dapat memanggil operasi ModifyParameter untuk mengubah parameter suatu instans.

    Anda dapat mengubah parameter secara langsung atau menggunakan template parameter. Setelah mengirim permintaan pengubahan parameter, ApsaraDB RDS akan menjalankan tugas untuk menerapkan nilai parameter baru ke instans tersebut. Jika nilai parameter baru hanya berlaku setelah instans direstart, ApsaraDB RDS akan me-restart instans tersebut. Untuk informasi mengenai parameter yang dapat dikonfigurasi, lihat Konfigurasikan parameter instans ApsaraDB RDS for MySQL.

    Catatan Sebelum menjalankan tugas pengubahan parameter, ApsaraDB RDS memeriksa apakah parameter tersebut ada, dapat dikonfigurasi, dan apakah nilai parameter baru valid.

    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 Type Wajib Contoh Deskripsi
    Action String Yes ModifyParameter

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyParameter.

    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.

    Parameters String Yes {"delayed_insert_timeout":"600","max_length_for_sort_data":"2048"}

    String JSON berisi parameter dan nilai-nilainya. Semua nilai parameter bertipe string. Format: {"Nama parameter 1":"Nilai parameter 1","Nama parameter 2":"Nilai parameter 2"...}. Anda dapat memanggil operasi DescribeParameterTemplates untuk menanyakan nama dan nilai parameter.

    Catatan Jika Anda menentukan parameter ini, Anda tidak perlu menentukan parameter ParameterGroupId.
    Forcerestart Boolean No false

    Menentukan apakah instans harus direstart agar nilai parameter baru berlaku. Nilai yang valid:

    • true: Sistem akan memaksa restart instans. Jika nilai parameter baru hanya berlaku setelah instans direstart, Anda harus menetapkan parameter ini ke true. Jika tidak, nilai parameter baru tidak akan berlaku.
    • false: Sistem tidak akan memaksa restart instans.

    Nilai default: false

    ParameterGroupId String No rpg-xxxxxxxxx

    ID template parameter.

    Catatan
    • Jika Anda menentukan parameter ini, Anda tidak perlu menentukan parameter Parameters.
    • Jika template parameter hanya dapat diterapkan setelah instans direstart, Anda harus menentukan parameter Forcerestart.
    SwitchTimeMode String No ScheduleTime

    Waktu penerapan perubahan parameter. Nilai yang valid:

    • Immediately: mengubah parameter segera. Ini adalah nilai default.
    • MaintainTime: mengubah parameter selama jendela maintenance instans. Anda dapat memanggil operasi ModifyDBInstanceMaintainTime untuk mengubah jendela maintenance instans.
    • ScheduleTime: Perubahan berlaku pada waktu yang Anda tentukan. Jika Anda memilih nilai ini, Anda juga harus menentukan parameter SwitchTime.
    SwitchTime String No 2022-05-06T09:24:00Z

    Waktu penerapan perubahan parameter. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

    Catatan Waktu ini harus lebih lambat dari waktu pemanggilan operasi ini.

    Parameter respons

    Parameter Type Contoh Deskripsi
    RequestId String 542BB8D6-4268-45CC-A557-B03EFD7AB30A

    ID permintaan.

    Contoh

    Contoh permintaan

    http(s)://rds.aliyuncs.com/?Action=ModifyParameter
&DBInstanceId=rm-uf6wjk5xxxxxxx
&Parameters={"delayed_insert_timeout":"600","max_length_for_sort_data":"2048"}
&<Common request parameters>

    Contoh respons sukses

    XML format

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

<ModifyParameterResponse>
       <RequestId>542BB8D6-4268-45CC-A557-B03EFD7AB30A</RequestId>
</ModifyParameterResponse>

    JSON format

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

{
  "RequestId" : "542BB8D6-4268-45CC-A557-B03EFD7AB30A"
}

    Kode kesalahan

    Kode status HTTP Kode kesalahan Pesan kesalahan Deskripsi
    400 PendingActionOverdue the action execution time is already overdue Pesan kesalahan yang dikembalikan karena waktu yang Anda tentukan untuk penerapan perubahan telah lewat.
    400 InvalidParameters.Format Specified parameters is not valid. Pesan kesalahan yang dikembalikan karena nilai parameter yang ditentukan tidak valid.
    400 InvalidParameters.Format The format of the specified parameter is invalid. Pesan kesalahan yang dikembalikan karena format parameter yang ditentukan tidak valid.
    400 Invalid.ParamGroupDBCategory ParamGroup category is basic, not standard. Pesan kesalahan yang dikembalikan karena kategori template parameter yang ditentukan adalah basic, bukan standard.
    403 IncorrectDBInstanceType The current database instance type does not support the operation. Pesan kesalahan yang dikembalikan karena konfigurasi instans tidak mendukung operasi ini.
    403 IncorrectDBInstanceState The current database status does not support the operation. Pesan kesalahan yang dikembalikan karena status instans tidak mendukung operasi ini. Pastikan instans berada dalam status Running.
    403 Invalid.Parameter Specified parameters is not valid. Pesan kesalahan yang dikembalikan karena parameter yang ditentukan tidak valid.
    404 InvalidDBInstance.NotFound The specified instance does not exist or is not supported. Pesan kesalahan yang dikembalikan karena instans yang ditentukan tidak ditemukan. Periksa ID instans tersebut.

    Untuk daftar kode kesalahan, kunjungi API Error Center.