All Products
Search
Document Center

Virtual Private Cloud:RetryVpcPrefixListAssociation

Last Updated:Sep 07, 2026

Mendeploy ulang daftar awalan terbaru dengan memanggil operasi RetryVpcPrefixListAssociation.

Deskripsi operasi

  • Setelah Anda memodifikasi informasi instans daftar awalan, jika tabel rute yang terkait dengan instans daftar awalan tidak secara otomatis memperbarui informasi instans daftar awalan, Anda dapat memanggil operasi ini untuk mendeploy ulang instans daftar awalan terbaru ke tabel rute yang terkait.

  • Operasi RetryVpcPrefixListAssociation bersifat asinkron. Setelah Anda mengirim permintaan, sistem akan mengembalikan ID permintaan. Namun, instans daftar awalan terbaru belum dideploy ulang, dan tugas penerapan ulang masih berjalan di latar belakang. Anda dapat memanggil GetVpcPrefixListAssociations untuk mengkueri status penerapan terbaru dari instans daftar awalan:
    • Jika status penerapan instans daftar awalan adalah Modifying, instans daftar awalan terbaru sedang dideploy ulang.

    • Jika status penerapan instans daftar awalan adalah ModifyFailed, instans daftar awalan terbaru gagal dideploy ulang.

    • Jika status penerapan instans daftar awalan adalah Created, instans daftar awalan terbaru telah dideploy ulang.

  • Operasi RetryVpcPrefixListAssociation tidak mendukung percobaan ulang secara bersamaan untuk mendeploy ulang instans daftar awalan terbaru pada daftar awalan yang sama.

Skenario

Saat Anda memodifikasi instans daftar awalan, modifikasi akan berhasil selama blok CIDR valid, tidak ada blok CIDR yang bertabrakan, dan jumlah entri maksimum untuk instans daftar awalan tidak terlampaui. Namun, referensi dapat gagal karena masalah pada sisi yang mereferensikan, seperti batas kuota atau konflik entri rute dengan entri rute yang ada. Setelah Anda menyelesaikan masalah pada sisi yang mereferensikan, panggil operasi RetryVpcPrefixListAssociation untuk mendeploy ulang instans daftar awalan terbaru.

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:RetryVpcPrefixListAssociation

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 akan dideploy ulang.

pl-0b7hwu67****

ResourceType

string

Yes

Tipe sumber daya yang terkait dengan instans daftar awalan. Nilai valid:

  • vpcRouteTable: Tabel rute VPC.

  • trRouteTable: Tabel rute Router transit.

vpcRouteTable

ResourceId

string

Yes

ID instans sumber daya yang terkait.

vtb-bp1drpcfz9srr393h****

ClientToken

string

No

Token klien yang digunakan untuk memastikan idempotensi permintaan.

Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya dapat 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

Apakah akan menjalankan dry run saja, tanpa menjalankan permintaan aktual. Nilai valid:

  • true: Hanya menjalankan dry run. Daftar awalan tidak dikaitkan. Sistem memeriksa permintaan untuk potensi masalah, termasuk parameter wajib yang hilang, format permintaan, dan batas layanan. Jika permintaan gagal dalam dry run, Paket kesalahan akan dikembalikan. Jika permintaan lulus dry run, kode kesalahan DryRunOperation akan dikembalikan.

  • false (default): Menjalankan dry run dan menjalankan permintaan aktual. Jika permintaan lulus dry run, kode status HTTP 2xx akan dikembalikan dan daftar awalan langsung dikaitkan.

false

RegionId

string

Yes

ID wilayah instans daftar awalan yang akan dideploy ulang.

Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.

cn-hangzhou

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

4EC47282-1B74-4534-BD0E-403F3EE64CAF

Contoh

Respons sukses

JSONformat

{
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 UnsupportedRegion The feature of prefixList entry is not supported in this region. Wilayah saat ini tidak mendukung operasi pada entri rute daftar awalan.
400 OperationDenied.SystemPrefixList The operation is not allowed because of SystemPrefixList. Anda tidak dapat mengoperasikan daftar awalan sistem karena dikelola oleh sistem operasi.
400 OperationFailed.OperateShareResource This is not allowed to operate shared prefixList. Anda tidak dapat mengoperasikan daftar awalan yang dibagikan.
400 IncorrectStatus.PrefixList The status of prefixList is incorrect. Daftar awalan berada dalam status transisi dan tidak dapat dioperasikan.
400 OperationFailed.NotExistAssociateRelation The operation is failed because of association not exist. Operasi gagal karena hubungan referensi yang ditentukan tidak ada dalam daftar awalan.
400 ResourceNotFound.PrefixList The specified resource of prefixList is not found. PrefixList yang ditentukan tidak ada.
400 IncorrectStatus.PrefixListRelation The related prefix list relation is in an intermediate state and cannot perform the current operation.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.