ModifyPrefixList - Elastic Compute Service - Alibaba Cloud Documentation Center

Memodifikasi nama, deskripsi, atau entri dalam daftar prefiks. Anda dapat menambahkan, memodifikasi, dan menghapus entri pada daftar prefiks.

Deskripsi operasi

Interface Description

Blok CIDR yang ditentukan harus dalam bentuk standar. Contohnya, 10.0.0.0/8 merupakan bentuk blok CIDR yang benar, sedangkan 10.0.0.1/8 tidak valid. Untuk informasi lebih lanjut, lihat Apa itu CIDR.
Tidak boleh menentukan blok CIDR duplikat saat menambahkan atau menghapus entri. Contohnya:
- Untuk blok CIDR IPv4: tidak boleh menentukan dua entri dengan blok CIDR masing-masing 10.0.0.0/8; demikian pula, tidak boleh menentukan dua entri dengan blok CIDR 10.0.0.1/32 dan 10.0.0.1 karena keduanya merepresentasikan alamat yang sama.
- Untuk blok CIDR IPv6: tidak boleh menentukan dua entri dengan blok CIDR masing-masing 2001:fd01:0:0:0:0:0:0/32 dan 2001:fd01::/32 karena keduanya merupakan representasi yang sama.
Blok CIDR dari entri yang ditambahkan tidak boleh sama dengan blok CIDR dari entri yang dihapus. Misalnya, jika Anda menambahkan entri dengan blok CIDR 10.0.0.0/8, Anda tidak boleh menyertakan blok CIDR tersebut dalam daftar entri yang akan dihapus.
Jika Anda ingin memodifikasi deskripsi suatu entri, Anda harus menentukan blok CIDR entri tersebut (AddEntry.N.Cidr) beserta deskripsi baru (AddEntry.N.Description).

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

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ecs:ModifyPrefixList

update

*PrefixList

acs:ecs:{#regionId}:{#accountId}:prefixlist/{#PrefixListId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah dari daftar prefiks. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.	cn-chengdu
RegionId	string	Yes	ID wilayah dari daftar prefiks. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.	cn-chengdu
PrefixListId	string	Yes	ID dari daftar prefiks.	pl-x1j1k5ykzqlixdcy****
PrefixListName	string	No	Nama daftar prefiks. Nama harus terdiri dari 2 hingga 128 karakter. Nama harus dimulai dengan huruf dan tidak boleh diawali dengan `http://`, `https://`, `com.aliyun`, atau `com.alibabacloud`. Nama dapat berisi huruf, angka, titik dua (:), garis bawah (_), titik (.), dan tanda hubung (-).	PrefixListNameSample
Description	string	No	Deskripsi daftar prefiks. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh diawali dengan `http://` atau `https://`.	This is description.
AddEntry	array<object>	No	Entri yang akan ditambahkan ke daftar prefiks.
	object	No
Description	string	No	Deskripsi pada entri N. Deskripsi harus terdiri dari 2 hingga 32 karakter dan tidak boleh diawali dengan `http://` atau `https://`. Nilai valid untuk N: 0 hingga 200.	Description Sample 01
Cidr	string	Yes	Blok CIDR pada entri N yang akan ditambahkan ke daftar prefiks. Nilai valid untuk N: 0 hingga 200. Perhatikan hal-hal berikut saat menambahkan entri: Jumlah total entri dalam daftar prefiks tidak boleh melebihi jumlah maksimum entri yang telah Anda tentukan untuk daftar prefiks tersebut. Anda dapat memanggil operasi DescribePrefixListAttributes untuk mengambil jumlah maksimum entri yang dapat dimuat oleh daftar prefiks. Anda tidak boleh menentukan blok CIDR duplikat. Blok CIDR tidak boleh sama dengan nilai `RemoveEntry.N.Cidr`.	192.168.2.0/24
RemoveEntry	array<object>	No	Entri yang akan dihapus dari daftar prefiks.
	object	No
Cidr	string	Yes	Blok CIDR pada entri N yang akan dihapus dari daftar prefiks. Nilai valid untuk N: 0 hingga 200. Perhatikan hal-hal berikut saat menghapus entri: Anda tidak boleh menentukan blok CIDR duplikat. Blok CIDR tidak boleh sama dengan nilai `AddEntry.N.Cidr`.	192.168.1.0/24

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	38793DB8-A4B2-4AEC-BFD3-111234E9188D

Contoh

Respons sukses

JSONformat

{
  "RequestId": "38793DB8-A4B2-4AEC-BFD3-111234E9188D"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	MissingParameter	%s
400	InvalidParameter.PrefixListName	The parameter PrefixListName is not valid.
400	InvalidDescription.Malformed	The specified Description is wrongly formed.
400	InvalidParameter.CidrDuplicated	%s
400	InvalidParameter.CidrMalformed	%s
400	LimitExceed.MaxEntries	The number of entries exceeds the MaxEntries of the specified prefix list.
400	LimitExceed.Entry	The number of entries added or removed exceeds the limit.
400	TaskConflict	The operation is too frequent, please wait a moment and try again.
404	InvalidPrefixListId.NotFound	The specified prefix list was not found.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.