All Products
Search

This Product

    :Ubah pengaturan proksi database

    Document Center

    :Ubah pengaturan proksi database

    Last Updated:May 29, 2026

    Anda dapat memanggil operasi ModifyDBProxyInstance untuk mengubah pengaturan proksi database pada instans ApsaraDB RDS.

    Sebelum memanggil operasi ModifyDBProxyInstance, pastikan Anda telah memanggil operasi ModifyDBProxy untuk mengaktifkan fitur proksi database pada instans tersebut.

    • Fitur dedicated proxy dari ApsaraDB RDS for MySQL menyediakan kemampuan seperti pemisahan baca/tulis dan optimasi koneksi singkat. Untuk informasi selengkapnya, lihat Apa itu proksi database?
    • Fitur proksi database dari ApsaraDB RDS for PostgreSQL mendukung pemisahan baca/tulis. Untuk informasi selengkapnya, lihat Apa itu proksi database?

    Debugging

    OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk memudahkan 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 Ya ModifyDBProxyInstance

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyDBProxyInstance.

    DBInstanceId String Ya rm-t4n3a****

    ID instans. Anda dapat memanggil operasi DescribeDBInstances untuk menanyakan ID instans tersebut.

    DBProxyInstanceType String Ya DedicatedProxy

    Tipe proksi database yang diaktifkan untuk instans. Tetapkan nilainya ke DedicatedProxy.

    DBProxyInstanceNum String Ya 2

    Jumlah instans proksi yang diaktifkan. Jika nilai parameter ini adalah 0, fitur proksi database akan dinonaktifkan untuk instans tersebut. Nilai yang valid: 1 hingga 60.

    Catatan Kemampuan proksi database dalam memproses permintaan meningkat seiring dengan jumlah instans proksi yang diaktifkan. Anda dapat memantau beban pada instans dan menentukan jumlah instans proksi yang sesuai berdasarkan data pemantauan beban tersebut.
    EffectiveTime String Tidak MaintainTime

    Waktu penerapan pengaturan proksi database baru. Nilai yang valid:

    • Immediate: ApsaraDB RDS langsung menerapkan pengaturan baru.
    • MaintainTime: ApsaraDB RDS menerapkan pengaturan baru selama jendela maintenance yang telah Anda tentukan. Untuk informasi selengkapnya, lihat Ubah jendela maintenance.
    • SpecificTime: ApsaraDB RDS menerapkan pengaturan baru pada waktu tertentu.

    Nilai default: MaintainTime.

    EffectiveSpecificTime String Tidak 2019-07-10T13:15:12Z

    Waktu spesifik saat Anda ingin menerapkan pengaturan proksi database baru. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

    Catatan Jika Anda menetapkan parameter EffectiveTime ke SpecificTime, Anda harus menentukan parameter EffectiveSpecificTime.
    RegionId String Tidak cn-hangzhou

    ID wilayah tempat instans berada. Anda dapat memanggil operasi DescribeRegions untuk menanyakan daftar wilayah terbaru.

    DBProxyEngineType String Tidak normal

    Parameter internal. Anda tidak perlu menentukan parameter ini.

    Parameter respons

    Parameter Type Contoh Deskripsi
    RequestId String 65C55572-530E-4A53-BE03-1D08CAF0F046

    ID permintaan.

    Contoh

    Contoh permintaan

    http(s)://rds.aliyuncs.com/?Action=ModifyDBProxyInstance
&DBInstanceId=rm-t4n3a****
&DBProxyInstanceType=DedicatedProxy
&DBProxyInstanceNum=2
&EffectiveTime=Immediate
&<Common request parameters>

    Contoh respons sukses

    XML format

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

<ModifyDBProxyInstanceResponse>
  <RequestId>65C55572-530E-4A53-BE03-1D08CAF0F046</RequestId>
</ModifyDBProxyInstanceResponse>

    JSON format

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

{
  "RequestId" : "65C55572-530E-4A53-BE03-1D08CAF0F046"
}

    Kode kesalahan

    Kode status HTTP Kode kesalahan Pesan kesalahan Deskripsi
    400 InvalidDBInstanceName Specified parameter DBInstanceName is not valid. Pesan kesalahan yang dikembalikan karena nilai parameter DBInstanceName tidak valid. Periksa apakah nilainya null atau string kosong.
    403 DBInstanceStatusNotActive Current DB instance status should be active. Pesan kesalahan yang dikembalikan karena status instans tidak mendukung operasi ini.
    403 InvalidInstanceLevel.Malformed The specified class code does not support the endpoint number. Please check the shard number and the current endpoint number. Pesan kesalahan yang dikembalikan karena tipe instans tidak mendukung jumlah terminal proksi yang Anda tentukan. Periksa jumlah instans proksi dan jumlah terminal proksi.

    Untuk daftar kode kesalahan, kunjungi API Error Center.