Memanggil DeleteRouteEntries untuk menghapus entri rute kustom secara batch.
Deskripsi operasi
Saat Anda 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 melakukan operasi seperti membuat atau menghapus vSwitch atau entri rute.
-
Operasi DeleteRouteEntries bersifat asinkron. Setelah Anda mengirim permintaan, sistem akan mengembalikan ID permintaan. Namun, entri rute belum dihapus dan tugas penghapusan masih 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 DeleteRouteEntries tidak mendukung penghapusan batch entri rute secara bersamaan dari tabel rute dalam VPC yang sama.
Coba sekarang
Test
RAM authorization
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
ID wilayah tempat tabel rute berada. Anda dapat memanggil operasi DescribeRegions untuk mendapatkan ID wilayah. |
cn-hangzhou |
| RegionId |
string |
Yes |
路由表所属地域的 ID。 您可以通过调用 DescribeRegions 接口获取地域 ID。 |
cn-hangzhou |
| RouteEntries |
array<object> |
No |
Informasi mengenai entri rute yang akan dihapus. |
|
|
object |
No |
Informasi mengenai entri rute yang akan dihapus. |
||
| RouteTableId |
string |
Yes |
ID tabel rute yang berisi entri rute yang akan dihapus. Anda dapat menentukan hingga 50 ID tabel rute. |
vtb-2ze3jgygk9bmsj23s**** |
| RouteEntryId |
string |
No |
ID entri rute yang akan dihapus. Anda dapat menentukan hingga 50 ID entri rute. Catatan
Jika parameter RouteEntryId tidak ditentukan, parameter DstCidrBlock dan NextHop wajib diisi. |
rte-bp1mnnr2al0naomnpv**** |
| DstCidrBlock |
string |
No |
Blok CIDR tujuan entri rute yang akan dihapus. Blok CIDR IPv4, blok CIDR IPv6, dan blok CIDR daftar awalan didukung. Anda dapat menentukan hingga 50 blok CIDR tujuan. Catatan
Jika parameter RouteEntryId tidak ditentukan, parameter DstCidrBlock dan NextHop wajib diisi. |
47.100.XX.XX/24 |
| NextHop |
string |
No |
ID instans lompatan berikutnya yang akan dihapus. Anda dapat menentukan hingga 50 ID instans. Catatan
Jika parameter RouteEntryId tidak ditentukan, parameter DstCidrBlock dan NextHop wajib diisi. |
i-j6c2fp57q8rr4jlu**** |
| 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 Resource Access Management (RAM), dan parameter yang diperlukan. Jika pemeriksaan gagal, kode kesalahan yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan false (default): mengirim permintaan normal. Setelah permintaan lulus pemeriksaan, 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 |
| SuccessCount |
integer |
Jumlah entri rute yang berhasil dihapus. |
2 |
| FailedCount |
integer |
Jumlah entri rute yang gagal dihapus. |
2 |
| FailedRouteEntries |
array<object> |
Informasi mengenai entri rute yang gagal dihapus. |
|
|
object |
Informasi mengenai entri rute yang gagal dihapus. |
||
| RouteEntryId |
string |
ID entri rute yang gagal dihapus. |
rte-bp1mnnr2al0naomnpv**** |
| DstCidrBlock |
string |
Blok CIDR tujuan entri rute yang gagal dihapus. Blok CIDR IPv4, blok CIDR IPv6, dan blok CIDR daftar awalan didukung. |
47.100.XX.XX/24 |
| NextHop |
string |
ID instans lompatan berikutnya yang gagal dihapus. |
i-j6c2fp57q8rr4jlu**** |
| FailedCode |
string |
Kode kesalahan yang dikembalikan untuk kegagalan tersebut. |
VPC_ROUTER_ENTRY_NOT_EXIST |
| FailedMessage |
string |
Paket kesalahan yang dikembalikan untuk kegagalan tersebut. |
vRouterEntry not exists |
Contoh
Respons sukses
JSONformat
{
"RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
"SuccessCount": 2,
"FailedCount": 2,
"FailedRouteEntries": [
{
"RouteEntryId": "rte-bp1mnnr2al0naomnpv****",
"DstCidrBlock": "47.100.XX.XX/24",
"NextHop": "i-j6c2fp57q8rr4jlu****",
"FailedCode": "VPC_ROUTER_ENTRY_NOT_EXIST",
"FailedMessage": "vRouterEntry not exists"
}
]
}
Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | DryRunOperation | Request validation has been passed with DryRun flag set. | |
| 400 | TaskConflict | The operation is too frequent. Please wait a moment and try again. |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.