All Products
Search
Document Center

:Ubah jenis jaringan instans ApsaraDB RDS

Last Updated:May 26, 2026

Anda dapat memanggil operasi ModifyDBInstanceNetworkType untuk mengubah jenis jaringan instans ApsaraDB RDS dari jaringan klasik ke virtual private cloud (VPC).

Prasyarat

Jenis jaringan instans harus berupa 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 untuk berbagai SDK.

Parameter permintaan

Parameter Type Wajib Contoh Deskripsi
Action String Yes ModifyDBInstanceNetworkType

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyDBInstanceNetworkType.

DBInstanceId String Yes rm-uf6wjk5xxxxxxx

ID instans.

RetainClassic String No True

Menentukan apakah endpoint jaringan klasik dipertahankan. Nilai yang valid:

  • True: mempertahankan endpoint jaringan klasik.
  • False: tidak mempertahankan endpoint jaringan klasik.

Nilai default: False.

ClassicExpiredDays String No 7

Jumlah hari untuk mempertahankan endpoint jaringan klasik. Nilai yang valid: 1 hingga 120. Nilai default: 7.

Catatan Jika Anda menetapkan RetainClassic ke True, Anda juga harus menentukan parameter ini.
InstanceNetworkType String Yes VPC

Jenis jaringan setelah modifikasi. Nilainya tetap VPC.

ReadWriteSplittingClassicExpiredDays Integer No 7

Jumlah hari untuk mempertahankan endpoint Pemisahan baca/tulis jenis jaringan klasik. Nilai yang valid: 1 hingga 120. Nilai default: 7.

Catatan Parameter ini hanya berlaku jika terdapat endpoint Pemisahan baca/tulis jenis jaringan klasik dan RetainClassic ditetapkan ke True.
VPCId String No vpc-uf6f7l4fg90xxxxxx

ID VPC.

VSwitchId String No vsw-uf6adz52c2pxxxxx

ID vSwitch. Parameter ini wajib jika parameter VPCId ditentukan.

PrivateIpAddress String No 172.10.40.25

Alamat IP internal instans. Alamat IP internal harus berada dalam Blok CIDR yang didukung oleh vSwitch yang ditentukan. ApsaraDB RDS secara otomatis menetapkan alamat IP internal ke instans berdasarkan nilai parameter VPCId dan VSwitchId.

ReadWriteSplittingPrivateIpAddress String No 192.168.0.22

Alamat IP internal yang sesuai dengan endpoint Pemisahan baca/tulis instans. Alamat IP internal harus berada dalam Blok CIDR yang didukung oleh vSwitch yang ditentukan. ApsaraDB RDS secara otomatis menetapkan alamat IP internal ke instans berdasarkan nilai parameter VPCId dan VSwitchId.

Catatan Parameter ini berlaku jika terdapat endpoint Pemisahan baca/tulis jenis jaringan klasik.

Parameter respons

Parameter Type Contoh Deskripsi
RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

ID permintaan.

TaskId String 1025486523574

ID task.

ConnectionString String rm-bp1*****************.mysql.rds.aliyuncs.com

Titik akhir yang digunakan untuk menghubungkan ke instans.

Contoh

Contoh permintaan

http(s)://rds.aliyuncs.com/?Action=ModifyDBInstanceNetworkType
&DBInstanceId=rm-bp1*****************.mysql.rds.aliyuncs.com
&InstanceNetworkType=VPC
&<Common request parameters>

Contoh respons sukses

XML format

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

<ModifyDBInstanceNetworkTypeResponse>
    <RequestId>9F0F1B7B-ED7A-5767-ADA5-46F31121E1D4</RequestId>
    <ConnectionString>rm-bp1*****************.mysql.rds.aliyuncs.com</ConnectionString>
</ModifyDBInstanceNetworkTypeResponse>

JSON format

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

{
  "RequestId" : "9F0F1B7B-ED7A-5767-ADA5-46F31121E1D4",
  "ConnectionString" : "rm-bp1*****************.mysql.rds.aliyuncs.com"
}

Kode kesalahan

Kode status HTTP Kode kesalahan Pesan kesalahan Deskripsi
400 NetTypeExists Specified network type already exists. Pesan kesalahan yang dikembalikan karena jenis jaringan yang ditentukan sama dengan jenis jaringan asli instans.
400 VswitchIpExhausted Vswitch IP exhausted. Pesan kesalahan yang dikembalikan karena alamat IP vSwitch telah habis.
400 OperationDenied.Switch The specified instance must not be switched to VPC. Pesan kesalahan yang dikembalikan karena instans tidak mendukung operasi ini.
400 OperationDenied.DBInstanceNetType Operation is denied by the network type of current database instance. Pesan kesalahan yang dikembalikan karena jenis jaringan instans utama tidak mendukung operasi ini.
400 OperationDenied.DBInstanceStatus Operation is denied by the current database instance status. Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat instans berada dalam status saat ini.
403 OperationDenied.DBInstanceConnType The current DB instance connection type does not support this operation. Pesan kesalahan yang dikembalikan karena jenis koneksi jaringan saat ini tidak mendukung operasi ini.

Untuk daftar kode kesalahan, kunjungi API Error Center.