ModifyVpcPrefixList - Virtual Private Cloud - Alibaba Cloud Documentation Center

Panggil operasi ModifyVpcPrefixList untuk mengubah informasi konfigurasi prefix list.

Deskripsi operasi

ModifyVpcPrefixList adalah operasi asinkron. Setelah permintaan dikirim, sistem mengembalikan ID permintaan dan menjalankan tugas modifikasi di latar belakang. Pada titik ini, konfigurasi prefix list belum diubah. Anda dapat memanggil ListPrefixLists untuk meminta status prefix list.
- Jika prefix list berada dalam status Modifying, konfigurasi prefix list sedang diubah.
- Jika prefix list berada dalam status Created, konfigurasi prefix list telah diubah.
- Setelah konfigurasi prefix list diubah, Anda dapat memanggil GetVpcPrefixListAssociations untuk meminta asosiasi prefix list dan memeriksa apakah sumber daya terkait menggunakan blok CIDR yang telah diubah. Ketika status asosiasi prefix list, yaitu nilai parameter Status, adalah Created, sumber daya terkait menggunakan blok CIDR yang telah diubah.
Operasi ModifyVpcPrefixList tidak mendukung perubahan konfigurasi prefix list yang sama secara bersamaan.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter	Type	Required	Description	Example
PrefixListId	string	Yes	ID instance dari prefix list yang akan diubah.	pl-0b7hwu67****
PrefixListName	string	No	Nama baru dari prefix list. Panjang nama adalah 1 hingga 128 karakter dan tidak boleh diawali dengan `http://` atau `https://`.	newname
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien Anda untuk menghasilkan nilai parameter, tetapi Anda harus memastikan bahwa nilai tersebut unik di antara permintaan yang berbeda. Nilai ClientToken hanya boleh berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId dapat berbeda untuk setiap permintaan API.	123e4567-e89b-12d3-a456-426655440000
DryRun	boolean	No	Menentukan apakah hanya akan melakukan dry run, tanpa menjalankan permintaan yang sebenarnya. Nilai yang valid: true: hanya melakukan dry run. Sistem memeriksa permintaan untuk potensi masalah, termasuk nilai parameter yang hilang, sintaks permintaan yang salah, dan batas layanan. Jika permintaan gagal dalam dry run, pesan kesalahan akan dikembalikan. Jika permintaan lolos dry run, kode kesalahan `DryRunOperation` akan dikembalikan. false (default): melakukan dry run dan menjalankan permintaan yang sebenarnya. Jika permintaan lolos dry run, kode status HTTP 2xx akan dikembalikan dan konfigurasi prefix list akan diubah.	false
AddPrefixListEntry	array<object>	No	Blok CIDR yang akan ditambahkan ke prefix list.
	object	No	Blok CIDR yang akan ditambahkan ke prefix list.
Cidr	string	No	Blok CIDR yang akan ditambahkan ke prefix list. Catatan Jika blok CIDR yang akan ditambahkan sudah ada di prefix list, hanya nilai AddPrefixListEntry.N.Description yang akan diubah. Artinya, hanya deskripsi blok CIDR yang akan diubah.	172.16.0.0/12
Description	string	No	Deskripsi blok CIDR yang akan ditambahkan ke prefix list. Panjang deskripsi adalah 1 hingga 128 karakter dan tidak boleh diawali dengan `http://` atau `https://`.	newcidr
RemovePrefixListEntry	array<object>	No	Blok CIDR yang akan dihapus dari prefix list.
	object	No	Blok CIDR yang akan dihapus dari prefix list.
Cidr	string	No	Blok CIDR yang akan dihapus dari prefix list.	192.168.0.0/16
Description	string	No	Deskripsi blok CIDR yang akan dihapus dari prefix list.	cidr
RegionId	string	Yes	ID region tempat prefix list yang ingin Anda ubah konfigurasinya dideploy.	cn-hangzhou
PrefixListDescription	string	No	Deskripsi baru dari prefix list. Panjang deskripsi adalah 1 hingga 256 karakter dan tidak boleh diawali dengan `http://` atau `https://`.	newdescription
MaxEntries	integer	No	Jumlah maksimum baru entri blok CIDR yang didukung oleh prefix list.	20

Elemen respons

Element	Type	Description	Example
	object
PrefixListId	string	ID prefix list.	pl-0b7hwu67****
RequestId	string	ID permintaan.	54B48E3D-DF70-471B-AA93-08E683A1B45

Contoh

Respons sukses

JSONformat

{
  "PrefixListId": "pl-0b7hwu67****",
  "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	ResourceNotFound.PrefixList	The specified resource of prefixList is not found.
400	OperationFailed.CidrCountExceedMaxCount	The operation is failed because of cidrCountExceedMaxCount.
400	OperationDenied.RemoveCountExceedExistCount	The operation is not allowed because of remove-count exceed exist-count.
400	DuplicatedParam.CidrBlock	The param of cidrBlock is duplicated.
400	IllegalParam.CidrBlock	The param of cidrBlock is illegal.
400	IllegalParam.CidrName	The param of cidrName is illegal.
400	OperationDenied.SystemPrefixList	This is not allowed to operate system prefixList.
400	OperationFailed.OperateShareResource	This is not allowed to operate shared prefixList.
400	IncorrectStatus.PrefixList	The status of prefixList is incorrect.
400	QuotaExceeded.PrefixListCidrCount	The quota of prefixList entry maxEntry count is exceeded.
400	QuotaExceeded	Route entry quota exceeded in associated route table.
400	OperationDenied.QuotaExceededWithNetworkAcl	If the prefix list increases MaxEntries, the quota for the maximum number of entries for the associated network ACL instance %s is exceeded.
400	ServiceUnavailable	The request has failed due to a temporary failure of the server.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.