Beralih antara titik akhir internal dan publik - - Alibaba Cloud Documentation Center

Anda dapat memanggil operasi SwitchDBInstanceNetType untuk beralih antara titik akhir internal dan publik instans ApsaraDB RDS.

Untuk menghemat sumber daya titik akhir, Anda dapat memanggil operasi ini guna beralih antara titik akhir internal dan publik suatu instans. Setelah titik akhir yang digunakan untuk menghubungkan ke instans berubah, perbarui informasi titik akhir dalam kode aplikasi Anda dan restart aplikasi tersebut.

Sebelum memanggil operasi ini, pastikan persyaratan berikut terpenuhi:

Instans terhubung menggunakan titik akhir internal atau publik.
Instans berada dalam status Running.
Jumlah kali Anda beralih antara titik akhir internal dan publik instans dalam 24 jam terakhir belum mencapai 20 kali.
Instans berada di jaringan klasik.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan 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	Required	Contoh	Deskripsi
Action	String	Yes	SwitchDBInstanceNetType	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke SwitchDBInstanceNetType.
ClientToken	String	No	ETnLKlblzczshOTUbOCzxxxxxx	Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menghasilkan nilai ini dari client, tetapi harus memastikan nilainya unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter.
DBInstanceId	String	Yes	rm-bp1**************	ID instans.
ConnectionStringPrefix	String	Yes	new**********	Awalan titik akhir kustom. Panjang awalan harus antara 8 hingga 64 karakter dan hanya boleh berisi huruf serta angka. Awalan harus dimulai dengan huruf kecil. Format titik akhir yang valid adalah sebagai berikut: Awalan.Mesin database.rds.aliyuncs.com. Contoh: test1234.mysql.rds.aliyuncs.com.
Port	String	No	3306	Port yang terkait dengan titik akhir. Nilai yang valid: 3001 to 3999.
ConnectionStringType	String	No	Normal	Tipe titik akhir. Nilai yang valid: Normal ReadWriteSplitting Secara default, sistem mengembalikan kedua jenis titik akhir tersebut.

Parameter respons

Parameter	Type	Contoh	Deskripsi
NewConnectionString	String	new**********.mysql.rds.aliyuncs.com	Titik akhir yang digunakan untuk menghubungkan ke instans setelah pergantian titik akhir.
RequestId	String	65BDA532-28AF-4122-AA39-B382721EEE64	ID permintaan.
OldConnectionString	String	rm-bp1**************.mysql.rds.aliyuncs.com	Titik akhir yang digunakan untuk menghubungkan ke instans sebelum pergantian titik akhir.

Contoh

Permintaan contoh

http(s)://rds.aliyuncs.com/?Action=SwitchDBInstanceNetType
&DBInstanceId=rm-uf6wjk5xxxxxxx
&ConnectionStringPrefix=rm-xxxxxx
&<Common request parameters>

Respons sukses contoh

XML format

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

<SwitchDBInstanceNetTypeResponse>
    <RequestId>94D5FC3C-1314-5883-9127-61D2105515AF</RequestId>
    <OldConnectionString>rm-bp1qp11x5**************.rds.aliyuncs.com</OldConnectionString>
    <NewConnectionString>new**********.rds.aliyuncs.com</NewConnectionString>
</SwitchDBInstanceNetTypeResponse>

JSON format

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

{
  "RequestId" : "94D5FC3C-1314-5883-9127-61D2105515AF",
  "OldConnectionString" : "rm-bp1qp11x5**************.rds.aliyuncs.com",
  "NewConnectionString" : "new**********.rds.aliyuncs.com"
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi Error Center.