All Products
Search

This Product

    Virtual Private Cloud:ModifyVpcPrefixList

    Document Center

    Virtual Private Cloud:ModifyVpcPrefixList

    Last Updated:Jul 16, 2026

    Mengubah konfigurasi daftar awalan.

    Deskripsi operasi

    • ModifyVpcPrefixList adalah operasi asinkron. Setelah permintaan dikirim, sistem mengembalikan ID permintaan. Namun, konfigurasi instans daftar awalan tidak segera diubah karena node modifikasi masih berjalan di latar belakang. Anda dapat memanggil ListPrefixLists untuk mengkueri status instans daftar awalan.

      • Jika instans daftar awalan berada dalam status Modifying, konfigurasi instans daftar awalan sedang diubah.

      • Jika instans daftar awalan berada dalam status Created, konfigurasi instans daftar awalan telah diubah.

      • Setelah konfigurasi instans daftar awalan diubah, Anda dapat memanggil GetVpcPrefixListAssociations untuk mengkueri asosiasi daftar awalan guna memeriksa apakah resource yang terasosiasi menggunakan Blok CIDR yang telah dimodifikasi. Jika parameter Status dari asosiasi daftar awalan adalah Created, resource yang terasosiasi menggunakan Blok CIDR yang telah dimodifikasi.

    • ModifyVpcPrefixList tidak mendukung modifikasi konkuren pada daftar awalan yang sama.

    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

    vpc:ModifyVpcPrefixList

    update

    *PrefixList

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    PrefixListId

    string

    Yes

    ID instans daftar awalan yang ingin Anda ubah.

    pl-0b7hwu67****
    PrefixListName

    string

    No

    Nama baru daftar awalan.

    Panjang nama harus 1 hingga 128 karakter dan tidak boleh dimulai dengan http:// atau https://.

    newname
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token unik di antara berbagai permintaan. Token hanya dapat berisi karakter ASCII.

    Catatan

    Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.

    123e4567-e89b-12d3-a456-426655440000
    DryRun

    boolean

    No

    Apakah akan menjalankan dry run. Nilai valid:

    • true: Menjalankan dry run. Sistem memeriksa parameter wajib, sintaksis permintaan, dan batasan bisnis. Jika pemeriksaan gagal, kode kesalahan yang sesuai dikembalikan. Jika pemeriksaan berhasil, kode kesalahan DryRunOperation dikembalikan.

    • false (default): Menjalankan dry run lalu mengirim permintaan. Setelah permintaan lulus dry run, konfigurasi daftar awalan diubah dan kode status HTTP 2xx dikembalikan.

    false
    AddPrefixListEntry

    array<object>

    No

    Daftar Blok Classless Inter-Domain Routing (CIDR) yang akan ditambahkan ke instans daftar awalan.

    object

    No

    Blok Classless Inter-Domain Routing (CIDR) yang akan ditambahkan ke instans daftar awalan.

    Cidr

    string

    No

    Blok Classless Inter-Domain Routing (CIDR) yang akan ditambahkan ke instans daftar awalan.

    Catatan

    Jika Blok CIDR sudah ada dalam daftar awalan, hanya nilai AddPrefixListEntry.N.Description yang diubah, yang berarti hanya deskripsi Blok CIDR yang diubah.

    172.16.0.0/12
    Description

    string

    No

    Deskripsi Blok Classless Inter-Domain Routing (CIDR) yang akan ditambahkan ke instans daftar awalan.

    Panjang deskripsi harus 1 hingga 128 karakter dan tidak boleh dimulai dengan http:// atau https://.

    newcidr
    RemovePrefixListEntry

    array<object>

    No

    Daftar Blok Classless Inter-Domain Routing (CIDR) yang akan dihapus dari instans daftar awalan.

    object

    No

    Daftar Blok Classless Inter-Domain Routing (CIDR) yang akan dihapus dari instans daftar awalan.

    Cidr

    string

    No

    Blok Classless Inter-Domain Routing (CIDR) yang akan dihapus dari instans daftar awalan.

    192.168.0.0/16
    Description

    string

    No

    Deskripsi Blok Classless Inter-Domain Routing (CIDR) yang akan dihapus dari daftar awalan.

    cidr
    RegionId

    string

    Yes

    ID Wilayah daftar awalan yang ingin Anda ubah.

    cn-hangzhou
    PrefixListDescription

    string

    No

    Deskripsi baru daftar awalan.

    Panjang deskripsi harus 1 hingga 256 karakter dan tidak boleh dimulai dengan http:// atau https://.

    newdescription
    MaxEntries

    integer

    No

    Jumlah maksimum entri Blok Classless Inter-Domain Routing (CIDR) baru dalam instans daftar awalan.

    20

    Elemen respons

    Element

    Type

    Description

    Example

    object

    PrefixListId

    string

    ID instans daftar awalan.

    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

    Description
    400 ResourceNotFound.PrefixList The specified resource of prefixList is not found. Daftar awalan yang ditentukan tidak ada.
    400 OperationFailed.CidrCountExceedMaxCount The operation is failed because of cidrCountExceedMaxCount. Jumlah blok CIDR yang ditentukan melebihi nilai maksimum yang diizinkan dari cidrMaxCount.
    400 OperationDenied.RemoveCountExceedExistCount The operation is not allowed because of remove-count exceed exist-count. Jumlah blok CIDR yang akan dihapus melebihi jumlah yang dimiliki oleh daftar awalan.
    400 DuplicatedParam.CidrBlock The param of cidrBlock is duplicated. cidrBlock duplikat telah ditentukan.
    400 IllegalParam.CidrBlock The param of cidrBlock is illegal. Parameter CidrBlock tidak valid.
    400 IllegalParam.CidrName The param of cidrName is illegal. cidrName yang ditentukan tidak valid.
    400 OperationDenied.SystemPrefixList This is not allowed to operate system prefixList.
    400 OperationFailed.OperateShareResource This is not allowed to operate shared prefixList. Anda tidak dapat beroperasi pada daftar awalan bersama.
    400 IncorrectStatus.PrefixList The status of prefixList is incorrect. Daftar awalan berada dalam status sementara dan laju operasinya tidak dapat diubah.
    400 QuotaExceeded.PrefixListCidrCount The quota of prefixList entry maxEntry count is exceeded. Jumlah maksimum entri rute yang diizinkan untuk daftar awalan melebihi batas.
    400 QuotaExceeded Route entry quota exceeded in associated route table. Jumlah antarmuka router koneksi peering VPC yang dibuat oleh pengguna saat ini telah mencapai batas atas.
    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. Jika jumlah maksimum entri dalam daftar awalan ditingkatkan, akan melebihi kuota entri maksimum dari instans ACL jaringan yang terkait.
    400 ServiceUnavailable The request has failed due to a temporary failure of the server. Permintaan gagal karena kegagalan server sementara.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.