DescribeRouteEntryList - Virtual Private Cloud - Alibaba Cloud Documentation Center

Mengkueri daftar entri rute.

Deskripsi operasi

Sebelum Anda memanggil DeleteRouteEntry untuk menghapus entri rute, Anda dapat memanggil operasi ini untuk mengkueri informasi lompatan berikutnya dari entri rute yang ingin dihapus.

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

get

*RouteTable.

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah tabel rute tempat entri rute berada. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
RouteTableId	string	Yes	ID tabel rute yang ingin dikueri.	vtb-bp1r9pvl4xen8s9ju****
RouteEntryId	string	No	ID entri rute yang ingin dikueri.	rte-bp1mnnr2al0naomnp****
DestinationCidrBlock	string	No	Blok CIDR tujuan entri rute. Blok CIDR IPv4 dan IPv6 didukung.	192.168.2.0/24
RouteEntryName	string	No	Nama entri rute. Panjang nama harus 1 hingga 128 karakter dan tidak boleh diawali dengan `http://` atau `https://`.	abc
IpVersion	string	No	Versi protokol IP. Nilai valid: ipv4: IPv4. ipv6: IPv6.	ipv4
RouteEntryType	string	No	Tipe entri rute. Nilai valid: Custom: rute kustom. System: Rute sistem. BGP: rute BGP. CEN: rute Cloud Enterprise Network (CEN). ECR: rute Express Connect Router (ECR).	System
NextHopId	string	No	ID instans lompatan berikutnya.	vpn-bp10zyaph5cc8b7c7****
NextHopType	string	No	Tipe lompatan berikutnya. Nilai valid: Instance (default): Instance ECS. HaVip: alamat IP virtual ketersediaan tinggi. VpnGateway: Gateway VPN. NatGateway: Gateway NAT. NetworkInterface: pengontrol antarmuka jaringan elastis sekunder (NIC). RouterInterface: antarmuka vRouter. IPv6Gateway: gateway IPv6. Attachment: Router transit. Ipv4Gateway: gateway IPv4. GatewayEndpoint: titik akhir gerbang. Ecr: Express Connect Router (ECR).	Instance
MaxResult	integer	No	Jumlah entri per halaman untuk kueri berhalaman. Nilai valid: 1 hingga 100. Nilai default: 10.	10
NextToken	string	No	Token paginasi yang digunakan di permintaan berikutnya untuk mengambil halaman hasil baru. Nilai valid: Anda tidak perlu menentukan parameter ini untuk permintaan pertama atau jika tidak ada permintaan berikutnya. Jika ada permintaan berikutnya, tetapkan nilai ke nilai NextToken yang dikembalikan dari pemanggilan terakhir.	FFmyTO70tTpLG6I3FmYAXGKPd****
ServiceType	string	No	Tipe hosting entri rute. Jika bidang ini kosong, entri rute tidak dihosting. Nilai valid: TR, yang menunjukkan bahwa tipe hosting adalah Router transit.	TR
DestCidrBlockList	array	No	Daftar Blok CIDR tujuan entri rute.
	string	No	Daftar Blok CIDR tujuan entri rute. Anda dapat menentukan hingga 20 Blok CIDR tujuan.	192.168.0.0/24

Elemen respons

Element	Type	Description	Example
	object	Informasi detail tentang rute.
NextToken	string	Token paginasi yang digunakan di permintaan berikutnya untuk mengambil halaman hasil baru. Nilai valid: Jika NextToken kosong, tidak ada permintaan berikutnya. Jika NextToken dikembalikan, nilai tersebut menunjukkan token untuk kueri berikutnya.	FFmyTO70tTpLG6I3FmYAXGKPd****
RequestId	string	ID permintaan.	14A07460-EBE7-47CA-9757-12CC4761D47A
TotalCount	integer
RouteEntrys	object
RouteEntry	array<object>	Informasi rute.
	array<object>	Informasi rute.
Status	string	Status entri rute. Nilai valid: Pending: Sedang dikonfigurasi. Available: Tersedia. Modifying: Sedang dimodifikasi. Deleting: Sedang dihapus.	Available
Type	string	Tipe entri rute. Nilai valid: Custom: rute kustom. System: Rute sistem. BGP: rute BGP. CEN: rute Cloud Enterprise Network (CEN). ECR: rute Express Connect Router (ECR).	System
IpVersion	string	Versi protokol IP. Nilai valid: ipv4: IPv4. ipv6: IPv6.	ipv4
Description	string	Deskripsi entri rute.	RouteEntryDescription
RouteEntryName	string	Nama entri rute.	aaa
DestinationCidrBlock	string	Blok CIDR tujuan entri rute.	192.168.2.0/24
RouteEntryId	string	ID entri rute.	rte-bp1mnnr2al0naomnp****
RouteTableId	string	ID tabel rute.	vtb-bp15w5q90d2rk3bww****
GmtModified	string	Waktu entri rute terakhir dimodifikasi. Waktu ditampilkan dalam UTC dalam format `YYYY-MM-DDThh:mm:ssZ`.	2022-05-09T03:00:07Z
NextHops	object
NextHop	array<object>	Informasi lompatan berikutnya.
	array<object>	Informasi lompatan berikutnya.
NextHopRegionId	string	ID wilayah instans lompatan berikutnya. Catatan Parameter ini hanya dikembalikan ketika tipe lompatan berikutnya adalah RouterInterface.	cn-hangzhou
Weight	integer	Bobot entri rute. Catatan Parameter ini hanya dikembalikan ketika tipe lompatan berikutnya adalah RouterInterface.	100
NextHopId	string	ID instans lompatan berikutnya.	vpn-bp10zyaph5cc8b7c7****
Enabled	integer	Apakah entri rute tersedia. Nilai valid: 0: Tidak tersedia. 1: Tersedia. Catatan Parameter ini hanya dikembalikan ketika tipe lompatan berikutnya adalah RouterInterface.	1
NextHopType	string	Tipe lompatan berikutnya. Nilai valid: Instance: Instance ECS. HaVip: alamat IP virtual ketersediaan tinggi. VpnGateway: Gateway VPN. NatGateway: Gateway NAT. NetworkInterface: pengontrol antarmuka jaringan elastis sekunder (NIC). RouterInterface: antarmuka vRouter. IPv6Gateway: gateway IPv6. Attachment: Router transit. Ipv4Gateway: gateway IPv4. GatewayEndpoint: titik akhir gerbang. Ecr: Express Connect Router (ECR).	Instance
NextHopRelatedInfo	object	Informasi tentang lompatan berikutnya.
InstanceId	string	ID instans yang terkait dengan lompatan berikutnya.	vpc-bp1t36rn9l53iwbsf****
InstanceType	string	Tipe instans yang terkait dengan lompatan berikutnya. Nilai valid: VPC: virtual private cloud (VPC). VBR: Virtual Border Router. PCONN: sirkuit Express Connect.	VPC
RegionId	string	ID wilayah instans yang terkait dengan lompatan berikutnya.	ch-hangzhou
ServiceType	string	Tipe hosting entri rute. Jika bidang ini kosong, entri rute tidak dihosting. Nilai valid: TR, yang menunjukkan bahwa tipe hosting adalah Router transit.	TR
Origin	string	Asal entri rute. Nilai valid: RoutePropagation: Dibuat oleh propagasi otomatis. SystemCreate: Dibuat oleh sistem. CustomCreate: Dibuat oleh pengguna.	RoutePropagation

Contoh

Respons sukses

JSONformat

{
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "14A07460-EBE7-47CA-9757-12CC4761D47A",
  "TotalCount": 0,
  "RouteEntrys": {
    "RouteEntry": [
      {
        "Status": "Available",
        "Type": "System",
        "IpVersion": "ipv4",
        "Description": "RouteEntryDescription",
        "RouteEntryName": "aaa",
        "DestinationCidrBlock": "192.168.2.0/24",
        "RouteEntryId": "rte-bp1mnnr2al0naomnp****",
        "RouteTableId": "vtb-bp15w5q90d2rk3bww****",
        "GmtModified": "2022-05-09T03:00:07Z",
        "NextHops": {
          "NextHop": [
            {
              "NextHopRegionId": "cn-hangzhou",
              "Weight": 100,
              "NextHopId": "vpn-bp10zyaph5cc8b7c7****",
              "Enabled": 1,
              "NextHopType": "Instance",
              "NextHopRelatedInfo": {
                "InstanceId": "vpc-bp1t36rn9l53iwbsf****",
                "InstanceType": "VPC",
                "RegionId": "ch-hangzhou"
              }
            }
          ]
        },
        "ServiceType": "TR",
        "Origin": "RoutePropagation"
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	IllegalParam.NextToken	User nextToken is illegal.
400	InvalidNextHop.NotFound	The specified route entry nexthop does not exist in our records.
400	OperationFailed.QueryCenEntry	Operation is denied because getting CEN route entry has failed.	Kueri gagal karena entri rute Cloud Enterprise Network sementara tidak tersedia.
400	OperationDenied.UseGatewayRouteEntryQueryInterface	Use listGatewayRouteTableEntries to describe gateway route entries.	Untuk mengkueri entri rute dalam tabel rute gerbang, gunakan operasi listGatewayRouteTableEntries.
400	InvalidRouteTable.NotFound	The specified RouteTable was not found.	Instans tabel rute tidak ada.
400	IllegalParam.RouteEntryType	The parameter of RouteEntryType is illegal.	Tipe entri rute yang ditentukan tidak valid.
400	MissingParam.context	The param of context is missing.	Parameter context tidak ada.
400	MissingParam.aliUid	The param of aliUid is missing.
400	MissingParam.bid	The param of bid is missing.	Parameter bid tidak ada.
400	IllegalParam.IpVersion	Param IpVersion illegal.
400	OperationFailed.FilterParamUnderWrongRouteType	Operation failed because only custom type support filter by routeEntryId or routeEntryName	Operasi gagal. Hanya entri rute kustom yang mendukung pemfilteran berdasarkan ID entri rute atau nama entri rute.
400	IllegalParam.NextTokenExpired	The parameter of NextTokenExpired is illegal.	Parameter NextToken tidak valid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.