Aktifkan atau nonaktifkan fitur database proxy - - Alibaba Cloud Documentation Center

Anda dapat memanggil operasi ModifyDBProxy untuk mengaktifkan atau menonaktifkan fitur database proxy pada suatu instans.

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

Sebelum memanggil operasi ini, pastikan persyaratan berikut terpenuhi:

Jika instans menjalankan MySQL, instans tersebut harus menggunakan salah satu versi dan edisi RDS MySQL berikut:

MySQL 8.0 dengan versi mesin minor 20191204 atau lebih baru pada RDS Enterprise Edition
MySQL 8.0 dengan versi mesin minor 20190915 atau lebih baru pada RDS High-availability Edition
MySQL 5.7 dengan versi mesin minor 20191128 atau lebih baru pada RDS Enterprise Edition
MySQL 5.7 dengan versi mesin minor 20190925 atau lebih baru pada RDS High-availability Edition
MySQL 5.6 dengan versi mesin minor 20200229 atau lebih baru pada RDS High-availability Edition

Jika instans menjalankan PostgreSQL, instans tersebut harus memenuhi persyaratan berikut:

Instans menjalankan PostgreSQL 10, PostgreSQL 11, PostgreSQL 12, PostgreSQL 13, PostgreSQL 14, atau PostgreSQL 15.
Instans menggunakan SSD standar atau enhanced SSD (ESSD).
Instans menjalankan RDS High-availability Edition.
Instans merupakan primary instance.

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	Ya	ModifyDBProxy	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyDBProxy.
DBInstanceId	String	Ya	rm-uf6wjk5xxxxxxx	ID instans. Anda dapat memanggil operasi DescribeDBInstances untuk menanyakan ID instans tersebut.
ConfigDBProxyService	String	Ya	Startup	Menentukan apakah akan mengaktifkan atau menonaktifkan fitur database proxy. Nilai yang valid: Startup: mengaktifkan fitur database proxy. Shutdown: menonaktifkan fitur database proxy.
DBProxyInstanceNum	String	Tidak	1	Jumlah instans proxy yang diaktifkan. Nilai yang valid: 1 hingga 60. Nilai default: 1. Catatan Kemampuan database proxy dalam memproses permintaan meningkat seiring bertambahnya jumlah instans proxy yang diaktifkan. Anda dapat memantau beban pada instans dan menentukan jumlah instans proxy yang sesuai berdasarkan data pemantauan beban tersebut.
RegionId	String	Tidak	cn-hangzhou	ID wilayah instans. Anda dapat memanggil operasi DescribeRegions untuk menanyakan daftar wilayah terbaru.
InstanceNetworkType	String	Tidak	VPC	Jenis jaringan instans. Tetapkan nilainya ke VPC. Catatan Parameter ini wajib ditentukan saat Anda mengaktifkan fitur database proxy untuk instans RDS yang menjalankan MySQL dengan SSD standar atau ESSD serta instans RDS yang menjalankan PostgreSQL.
VPCId	String	Tidak	vpc-xxxxxxxxxxxx	ID virtual private cloud (VPC) tempat instans berada. Anda dapat memanggil operasi DescribeDBInstanceAttribute untuk menanyakan ID VPC instans tersebut. Catatan Parameter ini wajib ditentukan saat Anda mengaktifkan fitur database proxy untuk instans RDS yang menjalankan MySQL dengan SSD standar atau ESSD serta instans RDS yang menjalankan PostgreSQL.
VSwitchId	String	Tidak	vsw-xxxxxxxxxxxx	ID vSwitch instans. Anda dapat memanggil operasi DescribeDBInstanceAttribute untuk menanyakan ID vSwitch instans tersebut. Catatan Parameter ini wajib ditentukan saat Anda mengaktifkan fitur database proxy untuk instans RDS yang menjalankan MySQL dengan SSD standar atau ESSD serta instans RDS yang menjalankan PostgreSQL.
DBProxyEngineType	String	Tidak	normal	Parameter internal. Anda tidak perlu menentukan parameter ini.
ResourceGroupId	String	Tidak	rg-acfmy*****	ID kelompok sumber daya.

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
RequestId	String	FC452BB1-EED8-4278-95C7-0324B3710DF1	ID permintaan.

Contoh

Contoh permintaan

http(s)://rds.aliyuncs.com/?Action=ModifyDBProxy
&DBInstanceId=rm-uf6wjk5xxxxxxx
&ConfigDBProxyService=Startup
&<Common request parameters>

Contoh respons sukses

XML format

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

<ModifyDBProxyResponse>
  <RequestId>FC452BB1-EED8-4278-95C7-0324B3710DF1</RequestId>
</ModifyDBProxyResponse>

JSON format

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

{
  "RequestId" : "FC452BB1-EED8-4278-95C7-0324B3710DF1"
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	MaxscaleAlreadyExist	The Maxscale is already existed.	Pesan kesalahan yang dikembalikan karena MaxScale sudah ada.
400	MaxscaleNotSupport	Maxscale not supported	Pesan kesalahan yang dikembalikan karena instans tidak mendukung fitur dedicated proxy. Anda harus memeriksa konfigurasi dedicated proxy yang telah Anda tentukan.
400	NetWork.NotFound	NetWork.NotFound	Pesan kesalahan yang dikembalikan karena jaringan tidak tersedia.
400	InvalidVpcParameter	Either VPC ID or vSwitch ID is incorrect. Please check again.	Pesan kesalahan yang dikembalikan karena ID VPC yang Anda tentukan tidak valid.
400	MaxscaleInternalError	Database proxy status is CLASS_CHANGING.	Pesan kesalahan yang dikembalikan karena spesifikasi database proxy sedang dalam proses perubahan. Coba lagi nanti.
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.
404	Maxscale.NotFound	The relative maxscale instance is not found.	Pesan kesalahan yang dikembalikan karena instans MaxScale terkait tidak ditemukan.
404	InvalidVSwitchId.NotFound	The specified VSwitch is invalid.	Pesan kesalahan yang dikembalikan karena ID vSwitch yang Anda tentukan tidak valid.

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.