Ubah titik akhir dan nomor port - - Alibaba Cloud Documentation Center

Anda dapat memanggil operasi ModifyDBInstanceConnectionString untuk mengubah titik akhir dan nomor port instans ApsaraDB RDS.

ApsaraDB RDS menyediakan titik akhir internal dan publik, serta mendukung akses hybrid melalui titik akhir Virtual Private Cloud (VPC) dan titik akhir jaringan klasik.

Catatan

Anda hanya dapat mengubah awalan titik akhir.
Titik akhir pemisahan baca/tulis tidak dapat diubah.

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 untuk berbagai SDK.

Parameter permintaan

Parameter	Tipe	Wajib	Contoh	Deskripsi
Action	String	Ya	ModifyDBInstanceConnectionString	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyDBInstanceConnectionString.
DBInstanceId	String	Ya	rm-uf6wjk5****	ID instans.
CurrentConnectionString	String	Ya	rm-uf6wjk5x****.mysql.rds.aliyuncs.com	Titik akhir instans. Nilai ini dapat berupa titik akhir internal, titik akhir publik, atau titik akhir jaringan klasik dalam mode akses hybrid. Catatan Titik akhir pemisahan baca/tulis tidak dapat diubah.
ConnectionStringPrefix	String	Ya	rm-****	Awalan titik akhir setelah perubahan. Hanya awalan dari nilai parameter CurrentConnectionString yang dapat diubah. Catatan Nilai harus terdiri dari 8 hingga 64 karakter dan dapat berisi huruf, angka, serta tanda hubung (-). Nilai tidak boleh mengandung karakter berikut: ~ ! # % ^ & * = + \ \| {} ; : ' " , <> / ?
Port	String	Ya	3306	Nomor port setelah perubahan.
BabelfishPort	String	Tidak	1433	Port TDS instans yang telah diaktifkan Babelfish. Catatan Parameter ini hanya berlaku untuk instans ApsaraDB RDS for PostgreSQL. Untuk informasi selengkapnya tentang Babelfish untuk ApsaraDB RDS for PostgreSQL, lihat Introduction to Babelfish.
GeneralGroupName	String	Tidak	rgc-bp1tkv8****	Nama klaster khusus tempat instans tersebut berada. Parameter ini hanya berlaku jika instans menjalankan MySQL pada RDS Standard Edition dan dibuat dalam klaster khusus.

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
RequestId	String	65BDA532-28AF-4122-AA39-B382721EEE64	ID permintaan.

Contoh

Permintaan contoh

http(s)://[Endpoint]/?Action=ModifyDBInstanceConnectionString
&DBInstanceId=rm-uf6wjk5****
&CurrentConnectionString=rm-uf6wjk5x****.mysql.rds.aliyuncs.com
&ConnectionStringPrefix=rm-****
&Port=3306
&GeneralGroupName=rgc-bp1tkv8****
&<Common request parameters>

Respons sukses contoh

XML format

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

<ModifyDBInstanceConnectionStringResponse>
       <RequestId>65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>
</ModifyDBInstanceConnectionStringResponse>

JSON format

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

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

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	DnsConflict	Dns is conflict with other custins.	Pesan kesalahan yang dikembalikan karena Server DNS bertentangan dengan klien lain.
400	InvalidConnectionString.Malformed	The specified parameter "ConnectionStringPrefix" is not valid.	Pesan kesalahan yang dikembalikan karena format titik akhir tidak valid. Anda perlu menentukan nilai yang valid. Nilai harus terdiri dari 8 hingga 64 karakter dan dapat berisi huruf, angka, serta tanda hubung (-). Nilai tidak boleh mengandung karakter berikut: ~ ! # % ^ & * = + \ \| {} ; : ' " , <> / ?
400	OperationDenied.DBInstanceStatus	The operation is not permitted due to status of instance.	Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat instans berada dalam status saat ini.
400	InvalidConnectionString.NotFound	The specified connection string or network type is not found.	Pesan kesalahan yang dikembalikan karena titik akhir yang Anda tentukan tidak ditemukan. Anda perlu memeriksa apakah titik akhir yang ditentukan valid.
400	InvalidConnectionString.Duplicate	The specified connection string needs to be same as current network type.	Pesan kesalahan yang dikembalikan karena titik akhir atau port harus sama dengan yang digunakan oleh instans pada jenis jaringan saat ini.
400	MissingConnectionString	The request is missing a ConnectionString parameter.	Pesan kesalahan yang dikembalikan karena permintaan tidak berisi titik akhir jaringan klasik yang masa berlakunya ingin Anda perpanjang.
400	OtherEndpoint.Exist	Other endpoint exist.	Pesan kesalahan yang dikembalikan karena awalan titik akhir publik yang ditentukan sudah ada.

Daftar lengkap kode kesalahan tersedia di API Error Center.