DeleteRouteEntry - Virtual Private Cloud - Alibaba Cloud Documentation Center

Memanggil operasi DeleteRouteEntry untuk 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 jika 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 dihapus, lalu panggil operasi ini untuk menghapus entri rute.
Operasi DeleteRouteEntry bersifat asinkron. Setelah Anda mengirim permintaan, sistem akan 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

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. Konfigurasi 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. Konfigurasi parameter NextHopId atau NextHopList sesuai kebutuhan.	47.100.XX.XX/16
NextHopId	string	No	ID instans lompatan berikutnya. Untuk menghapus entri rute non-ECMP, tentukan NextHopId. Jangan tentukan NextHopList. Untuk menghapus entri 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 Pasangan Kunci Akses, otorisasi Pengguna RAM (Resource Access Management), dan parameter yang diperlukan. Jika pemeriksaan gagal, kesalahan yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan `DryRunOperation` akan dikembalikan. false (default): mengirim permintaan normal. Setelah pemeriksaan berhasil, kode status HTTP 2xx akan dikembalikan dan entri rute dihapus.

Elemen respons

Element	Type	Description	Example
	object	Parameter 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	Parameter wajib tidak diisi.
400	IncorrcetRouteEntryStatus	Status entri rute tertentu memblokir operasi ini.
400	InvalidCidrBlock.Malformed	Blok CIDR yang ditentukan tidak valid.
400	OperationDenied	Operasi yang ditentukan ditolak karena jenis entri rute adalah system.
400	InvalidRouteEntry.NotFound	Entri rute tidak ada.
400	InvalidVRouter.NotFound	vRouter tidak ada.
400	IncorrectRouteEntryStatus	Status entri rute tertentu memblokir operasi ini.
400	Forbbiden	RouteEntry yang ditentukan tidak diizinkan untuk dihapus melalui openApi.
400	InvalidNextHop	Nexthop dan nexthop list yang ditentukan tidak boleh keduanya null.
400	InvalidRouteEntry	RouteEntry yang ditentukan tidak ada.
400	Forbidden.VRouterNotFound	Virtual switch yang ditentukan tidak ditemukan selama autentikasi akses.
400	TaskConflict	Operasi terlalu sering dilakukan, TaskConflict.	Operasi terlalu sering dilakukan. Silakan coba lagi nanti.
400	InvalidRouteEntryId.NotFound	RouteEntryId yang ditentukan tidak ada.	Entri rute yang ditentukan tidak ditemukan.
400	IncorrectVpcStatus	Status VPC saat ini tidak mendukung operasi ini.
400	InvalidVpnInstanceId.NotFound	%s
400	ParamExclusive.RouteEntryIdAndRouteTableIdOrDestCidrBlock	%s
400	InvalidNextHopList.Size	Ukuran nexthop list harus antara 2 dan 16
400	ParamExclusive.NextHopIdAndList	NextHopId dan NextHopList tidak boleh keduanya bernilai tidak null.
400	OperationFailed.DeleteMultiScopeEntry	Scope multi atau ecmp harus dihapus dengan opsi force.
400	OperationFailed.DistibuteLock	Distribute lock gagal.	Operasi dikunci oleh permintaan lain.
400	OperationDenied.DeleteManagedRouteEntry	Operasi tidak diizinkan karena entri rute dikelola.	Rute yang dikelola oleh layanan cloud tidak dapat dihapus.
400	OperationDenied.RouteTableTypeNotPermitted	Operasi tidak diizinkan karena jenis tabel rute tidak diizinkan.	Jenis tabel rute yang ditentukan tidak mengizinkan pembuatan entri rute.
400	IncorrectStatus.VpcRouteEntry	Status routeEntry yang ditentukan tidak valid.	Status entri rute VPC tidak benar.
400	OperationDenied.NextHopNotChanged	Operasi tidak diizinkan karena NextHopNotChanged.	Operasi yang ditentukan ditolak karena hop berikutnya tidak berubah.
400	OperationDenied.DeleteGatewayEndpointRoute	Operasi tidak diizinkan untuk menghapus entri rute yang menunjuk ke gateway endpoint..	Rute yang menunjuk ke GatewayEndpoint tidak dapat dihapus secara manual.
400	IncorrectStatus.PrefixList	Status prefixList tidak benar.	PrefixList berada dalam kondisi peralihan dan tidak dapat dioperasikan.
400	InvalidCidrBlock	Blok CIDR yang ditentukan tidak valid.	Kemungkinan penyebab: 1. Anda tidak berada dalam whitelist blok CIDR rute 10.0.0.0/8 dan tidak dapat menggunakan blok CIDR ini. 2. Blok CIDR tujuan dari rute kustom yang ditambahkan tidak boleh termasuk dalam blok CIDR vSwitch mana pun di dalam VPC yang sama. 3. Karena 100.64.0.0/10 adalah alamat layanan cloud, Anda tidak dapat menambahkan blok CIDR ini yang menunjuk ke IDC on-premises. 4. Selain 100.64.0.0/10, blok CIDR rute spesifik seperti 100.64.0.0/11 dan 100.96.0.0/11 tidak dapat digunakan untuk menunjuk ke IDC on-premises.
400	OperationDenied.VbrAttachEcrInMiddleStatus	Operasi tidak diizinkan karena VBR sedang dalam status menengah saat melampirkan atau melepaskan ECR.	Operasi saat ini tidak dapat dilakukan karena border router sedang dalam proses melampirkan atau melepaskan Express Connect Router. Silakan coba lagi nanti.
400	UnsupportedFeature.NextHopType	Operasi tidak diizinkan karena NextHopType dari RouteEntry yang ditentukan diubah dari tipe Local.	Operasi tidak diizinkan karena jenis hop berikutnya dari rute diubah dari tipe Local.
400	ResourceNotFound.PrefixList	Sumber daya prefixList yang ditentukan tidak ditemukan.	PrefixList yang ditentukan tidak ada.
500	Vpc.Error	kode kesalahan 500,Kesalahan server internal.
500	Internal.Error	Pemrosesan permintaan gagal karena beberapa kesalahan, pengecualian, atau kegagalan yang tidak diketahui.
500	InternalError	Pemrosesan permintaan gagal karena beberapa kesalahan, pengecualian, atau kegagalan yang tidak diketahui.	Kesalahan internal.
404	InvalidRouteTableId.NotFound	Tabel rute yang ditentukan tidak ada.
404	InvalidVpcId.NotFound	Nilai VpcId yang ditentukan tidak ditemukan dalam catatan kami.	VPC yang ditentukan tidak ada. Silakan periksa apakah VPC yang dimasukkan sudah benar.
404	ResourceNotFound.GatewayLoadBalancerEndpoint	Instance GatewayLoadBalancerEndpoint tidak ditemukan.	Instance GatewayLoadBalancerEndpoint tidak ditemukan.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.