All Products
Search
Document Center

Virtual Private Cloud:DeleteRouteEntry

Last Updated:Sep 07, 2026

Menghapus entri rute dari tabel rute vRouter atau Virtual Border Router (VBR).

Deskripsi operasi

Saat memanggil operasi ini untuk menghapus entri rute, perhatikan hal-hal berikut:

  • Hanya entri rute dalam status Available yang dapat dihapus.

  • Entri rute tidak dapat dihapus saat VPC yang berisi tabel rute sedang membuat atau menghapus vSwitch atau entri rute.

  • Untuk menghapus entri rute dari tabel rute VBR, panggil operasi DescribeRouteEntryList untuk mengkueri NextHopId entri rute yang ingin Anda hapus, lalu panggil operasi ini untuk menghapus entri rute tersebut.

  • Operasi DeleteRouteEntry bersifat asinkron. Setelah Anda mengirim permintaan, sistem mengembalikan ID permintaan, tetapi entri rute belum dihapus. Tugas penghapusan berjalan di latar belakang. Anda dapat memanggil DescribeRouteEntryList untuk mengkueri status penghapusan entri rute:

    • Jika entri rute berada dalam status Deleting, entri rute sedang dihapus.

    • Jika entri rute yang ditentukan tidak dapat ditemukan, entri rute telah dihapus.

  • Operasi DeleteRouteEntry tidak mendukung penghapusan entri rute secara bersamaan dari tabel rute dalam VPC atau VBR 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:DeleteRouteEntry

delete

*RouteTable.

acs:vpc:{#regionId}:{#accountId}:routetable/{#RouteTableId}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

No

ID wilayah tempat tabel rute berada.

Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.

cn-hangzhou

RouteTableId

string

No

ID tabel rute yang berisi entri rute.

Catatan

Jika parameter RouteEntryId tidak ditentukan, parameter DestinationCidrBlock dan RouteTableId wajib diisi. Konfigurasikan parameter NextHopId atau NextHopList sesuai kebutuhan.

vtb-2ze3jgygk9bmsj23s****

RouteEntryId

string

No

ID entri rute yang ingin dihapus. Parameter ini saling eksklusif dengan parameter DestinationCidrBlock.

Catatan

Jika parameter DestinationCidrBlock tidak ditentukan, parameter RouteEntryId wajib diisi.

rte-bp1mnnr2al0naomnpv****

DestinationCidrBlock

string

No

Blok CIDR tujuan entri rute. Blok CIDR IPv4, Blok CIDR IPv6, Blok CIDR daftar awalan, dan ID instans daftar awalan didukung. Parameter ini saling eksklusif dengan parameter RouteEntryId.

Catatan

Jika parameter RouteEntryId tidak ditentukan, parameter DestinationCidrBlock dan RouteTableId wajib diisi. Konfigurasikan parameter NextHopId atau NextHopList sesuai kebutuhan.

47.100.XX.XX/16

NextHopId

string

No

ID instans lompatan berikutnya.

  • Untuk menghapus rute non-ECMP, tentukan NextHopId. Jangan tentukan NextHopList.

  • Untuk menghapus rute ECMP, tentukan NextHopList. Jangan tentukan NextHopId.

ri-2zeo3xzyf38r4urzd****

NextHopList

array<object>

No

Informasi mengenai instans lompatan berikutnya dari entri rute ECMP. Maksimal 16 instans lompatan berikutnya didukung.

object

No

Informasi mengenai instans lompatan berikutnya dari entri rute ECMP. Maksimal 16 instans lompatan berikutnya didukung.

NextHopId

string

No

ID instans lompatan berikutnya dari entri rute ECMP. Maksimal 16 instans lompatan berikutnya didukung.

ri-2zeo3xzyf38r43cd****

NextHopType

string

No

Tipe lompatan berikutnya dari entri rute ECMP. Atur nilai menjadi RouterInterface (antarmuka router). Maksimal 16 instans lompatan berikutnya didukung.

RouterInterface

DryRun

boolean

No

Apakah akan menjalankan dry run. Nilai valid:

true: menjalankan dry run tanpa menghapus entri rute. Sistem memeriksa AccessKey, otorisasi Pengguna RAM, dan parameter yang diperlukan. Jika pemeriksaan gagal, kode kesalahan yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan DryRunOperation akan dikembalikan.

false (default): mengirim permintaan normal. Jika pemeriksaan berhasil, kode status HTTP 2xx akan dikembalikan dan entri rute dihapus.

Elemen respons

Element

Type

Description

Example

object

Tanggapan.

RequestId

string

ID permintaan.

0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Contoh

Respons sukses

JSONformat

{
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 MissingParameter Miss mandatory parameter.
400 IncorrcetRouteEntryStatus Some route entry status blocked this operation.
400 InvalidCidrBlock.Malformed Specified CIDR block is not valid.
400 OperationDenied Specified operation is denied as route entry type is system.
400 InvalidRouteEntry.NotFound Route entry not exists.
400 InvalidVRouter.NotFound vRouter not exists.
400 IncorrectRouteEntryStatus Some route entry status blocked this operation.
400 Forbbiden Specified RouteEntry cannot allowed delete by openApi.
400 InvalidNextHop Specified nexthop and nexthop list cannot both null.
400 InvalidRouteEntry Specified routeEntry not exist.
400 Forbidden.VRouterNotFound pecified virtual switch is not found during access authentication.
400 TaskConflict The operation is too frequent, TaskConflict. Operasi EIP terlalu sering.
400 InvalidRouteEntryId.NotFound Specified RouteEntryId does not exist. Entri rute yang ditentukan tidak ada.
400 IncorrectVpcStatus Current VPC status does not support this operation.
400 InvalidVpnInstanceId.NotFound %s
400 ParamExclusive.RouteEntryIdAndRouteTableIdOrDestCidrBlock %s
400 InvalidNextHopList.Size Nexthop list size should be between 2 and 16
400 ParamExclusive.NextHopIdAndList NextHopId and NextHopList cannot both be not null.
400 OperationFailed.DeleteMultiScopeEntry Multi or ecmp scope must delete with force.
400 OperationFailed.DistibuteLock Distibute lock fail. Sumber daya terkunci. Operasi tidak diizinkan.
400 OperationDenied.DeleteManagedRouteEntry The operation is not allowed because of route entry is managed. Entri rute yang dikelola oleh layanan cloud tidak dapat dihapus.
400 OperationDenied.RouteTableTypeNotPermitted The operation is not allowed because the type of route table is not permitted. Tipe tabel rute yang ditentukan tidak memungkinkan Anda membuat entri rute.
400 IncorrectStatus.VpcRouteEntry The status of the specified routeEntry is invalid. Status entri rute VPC salah.
400 OperationDenied.NextHopNotChanged The operation is not allowed because of NextHopNotChanged. Operasi tidak diizinkan karena lompatan berikutnya tidak berubah.
400 OperationDenied.DeleteGatewayEndpointRoute The operation is not allowed to delete route entry pointing gateway endpoint.. Entri rute yang mengarah ke Titik akhir gerbang tidak dapat dihapus secara manual.
400 IncorrectStatus.PrefixList The status of prefixList is incorrect. Daftar awalan berada dalam status transisi dan tidak dapat dioperasikan.
400 InvalidCidrBlock Specified CIDR block is not valid. Penyebab yang mungkin: 1. Anda tidak berada dalam daftar putih untuk blok CIDR 10.0.0.0/8 dan tidak dapat menggunakan blok CIDR ini. 2. Blok CIDR tujuan entri rute kustom tidak boleh menjadi subset dari blok CIDR semua vSwitch dalam VPC yang sama. 3. Karena 100.64.0.0/10 adalah alamat layanan cloud, Anda tidak dapat menambahkan blok CIDR ini untuk menunjuk ke pusat data lokal. 4. Selain 100.64.0.0/10, blok CIDR tertentu seperti 100.64.0.0/11 dan 100.96.0.0/11 tidak dapat digunakan untuk pusat data lokal.
400 OperationDenied.VbrAttachEcrInMiddleStatus The operation is not allowed because of VBR attach or detach ECR in middle status. Operasi tidak dapat dieksekusi karena perangkat routing batas sedang dalam proses memuat atau membongkar Express Connect Router (ECR). Coba lagi nanti.
400 UnsupportedFeature.NextHopType The operation is not allowed because the NextHopType of specified RouteEntry is modified from Local type. Entri rute saat ini tidak mendukung pengubahan lompatan berikutnya.
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.
500 Vpc.Error error code 500,Internal server error.
500 Internal.Error The request processing has failed due to some unknown error, exception or failure.
500 InternalError The request processing has failed due to some unknown error, exception or failure. Pemrosesan permintaan gagal karena error yang tidak diketahui.
404 InvalidRouteTableId.NotFound Specified route table does not exist.
404 InvalidVpcId.NotFound Specified value of VpcId is not found in our record. VPC tidak ada. Periksa apakah VPC yang ditentukan sudah benar.
404 ResourceNotFound.GatewayLoadBalancerEndpoint GatewayLoadBalancerEndpoint instance not found. Instans GatewayLoadBalancerEndpoint tidak ditemukan.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.