Ubah allowlist alamat IP - - Alibaba Cloud Documentation Center

Anda dapat memanggil operasi ModifySecurityIps untuk mengubah allowlist alamat IP instans ApsaraDB RDS.

Allowlist alamat IP berisi alamat IP dan Blok CIDR yang diberi akses ke instans tersebut. Untuk informasi selengkapnya tentang cara mengonfigurasi allowlist alamat IP, lihat Konfigurasikan allowlist alamat IP untuk instans ApsaraDB RDS.

Catatan Sebelum memanggil operasi ini, pastikan instans berada dalam status Running.

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

Parameter permintaan

Parameter	Type	Wajib	Contoh	Deskripsi
Action	String	Yes	ModifySecurityIps	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifySecurityIps.
DBInstanceId	String	Yes	pgm-bp18n0c8zt45****	ID instans.
SecurityIps	String	Yes	10.23.XX.XX	Alamat IP dan Blok CIDR yang ingin Anda masukkan ke dalam allowlist alamat IP. Jika allowlist alamat IP berisi lebih dari satu alamat IP atau Blok CIDR, pisahkan alamat IP dan Blok CIDR tersebut dengan koma (,). Setiap alamat IP atau Blok CIDR dalam allowlist alamat IP harus unik. Untuk informasi selengkapnya, lihat Konfigurasikan allowlist alamat IP untuk instans ApsaraDB RDS. Entri dalam allowlist alamat IP harus dalam salah satu format berikut: Alamat IP, seperti 10.23.XX.XX. Blok CIDR, seperti 10.23.XX.XX/24. Dalam contoh ini, 24 menunjukkan bahwa awalan setiap alamat IP dalam allowlist alamat IP memiliki panjang 24 bit. Anda dapat mengganti 24 dengan nilai dalam rentang 1 hingga 32. Catatan Maksimal 1.000 alamat IP dan Blok CIDR dapat dikonfigurasi untuk setiap instans. Jika Anda ingin menambahkan banyak alamat IP, kami menyarankan agar Anda menggabungkannya menjadi Blok CIDR, seperti 10.23.XX.XX/24.
DBInstanceIPArrayName	String	No	test	Nama allowlist alamat IP yang ingin Anda ubah. Nilai default: Default. Catatan Maksimal 200 allowlist alamat IP dapat dikonfigurasi untuk setiap instans.
DBInstanceIPArrayAttribute	String	No	hidden	Atribut allowlist alamat IP. Secara default, parameter ini kosong. Catatan Allowlist alamat IP yang memiliki atribut hidden tidak ditampilkan di Konsol ApsaraDB RDS. Allowlist alamat IP ini digunakan untuk mengakses Layanan Alibaba Cloud, seperti Data Transmission Service (DTS).
SecurityIPType	String	No	IPv4	Jenis alamat IP dalam allowlist alamat IP. Nilainya tetap IPv4.
WhitelistNetworkType	String	No	Classic	Jenis jaringan allowlist alamat IP. Nilai yang valid: Classic: jaringan klasik dalam mode allowlist ditingkatkan VPC: jenis jaringan virtual private cloud (VPC) dalam mode allowlist ditingkatkan. MIX: mode allowlist standar. Nilai default: MIX. Catatan Dalam mode allowlist standar, alamat IP dan Blok CIDR hanya ditambahkan ke allowlist alamat IP default. Dalam mode allowlist ditingkatkan, alamat IP dan Blok CIDR ditambahkan ke allowlist alamat IP jenis jaringan klasik dan jenis jaringan VPC.
ModifyMode	String	No	Cover	Metode yang digunakan untuk mengubah allowlist alamat IP. Nilai yang valid: Cover: Gunakan alamat IP dan Blok CIDR yang ditentukan dalam parameter SecurityIps untuk menimpa alamat IP dan Blok CIDR yang sudah ada dalam allowlist alamat IP. Append: Tambahkan alamat IP dan Blok CIDR yang ditentukan dalam parameter SecurityIps ke allowlist alamat IP. Delete: Hapus alamat IP dan Blok CIDR yang ditentukan dalam parameter SecurityIps dari allowlist alamat IP. Anda harus menyisakan setidaknya satu alamat IP atau Blok CIDR. Nilai default: Cover.
FreshWhiteListReadins	String	No	pgr-bp17yuz4dn3d**,pgr-bp1vn2ph54u1**	Instansi hanya baca yang ingin Anda sinkronkan allowlist alamat IP-nya. Parameter ini hanya berlaku untuk instans ApsaraDB RDS for PostgreSQL. Jika instans dilengkapi instansi hanya baca, Anda dapat menggunakan parameter ini untuk menyinkronkan allowlist alamat IP ke instansi hanya baca tersebut. Jika instans dilengkapi beberapa instansi hanya baca, instansi hanya baca tersebut harus dipisahkan dengan koma (,). Jika instans tidak dilengkapi instansi hanya baca, parameter ini kosong.

Parameter respons

Parameter	Type	Contoh	Deskripsi
TaskId	String	115855279	ID task.
RequestId	String	1AD222E9-E606-4A42-BF6D-8A4442913CEF	ID permintaan.

Contoh

Permintaan contoh

http(s)://rds.aliyuncs.com/?Action=ModifySecurityIps
&DBInstanceId=pgm-bp18n0c8zt45****
&SecurityIps=10.23.12.24
&<Common request parameters>

Respons sukses contoh

XML format

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

<ModifySecurityIpsResponse>
	<RequestId> 1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>
	<TaskId>115855279</TaskId>
</ModifySecurityIpsResponse>

JSON format

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

{
  "RequestId" : " 1AD222E9-E606-4A42-BF6D-8A4442913CEF",
  "TaskId" : 115855279
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	InvalidWhitelistNetType.Malformed	Specified WhitelistNetType is not valid.	Pesan kesalahan yang dikembalikan karena nilai parameter WhitelistNetworkType tidak valid. Masukkan nilai yang valid.
400	InvalidIPArrayAttribute.Format	The format of the IP attribute is invalid.	Pesan kesalahan yang dikembalikan karena nilai parameter DBInstanceIPArrayAttribute memiliki format yang tidak valid. Masukkan nilai dengan format yang valid dan coba lagi. Jika allowlist alamat IP berisi beberapa alamat IP atau Blok CIDR, pastikan alamat IP dan Blok CIDR tersebut unik dan dipisahkan oleh koma (,). Entri dalam allowlist alamat IP harus dalam salah satu format berikut: Alamat IP, seperti 10.23.12.24. Blok CIDR, seperti 10.23.12.0/24. Dalam hal ini, 24 menunjukkan bahwa awalan setiap alamat IP memiliki panjang 24 bit. Anda dapat mengganti 24 dengan nilai dalam rentang 1 hingga 32.
400	InvalidSecurityIPList.Duplicate	Specified security IP list is not valid: Duplicate IP address in the list.	Pesan kesalahan yang dikembalikan karena alamat IP atau Blok CIDR yang ditentukan tidak valid. Alamat IP atau Blok CIDR yang ditentukan merupakan duplikat.
400	SecurityIPList.Format	Specified SecurityIPList is not valid.	Pesan kesalahan yang dikembalikan karena alamat IP atau Blok CIDR yang ditentukan tidak valid.

Untuk daftar kode kesalahan, kunjungi API Error Center.