DescribeRouteTables - Virtual Private Cloud - Alibaba Cloud Documentation Center

Mengkueri tabel rute.

Catatan

API ini telah ditinggalkan. Kami merekomendasikan migrasi ke Vpc(2016-04-28) - DescribeRouteTableList guna memperoleh fungsionalitas yang lebih baik dan dukungan berkelanjutan. Meskipun API yang telah ditinggalkan ini masih dapat diakses sementara, tidak akan ada pembaruan atau perbaikan bug lebih lanjut.

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

list

*RouteTable

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

vpc:VBR
vpc:VRouter

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah VPC tempat tabel rute berada. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.	ap-southeast-6
VRouterId	string	No	ID vRouter yang akan dikueri. Catatan Anda harus menentukan setidaknya satu dari parameter berikut: VRouterId, RouteTableId, RouterId, dan RouteTableName. Anda tidak dapat menentukan VRouterId dan RouterId secara bersamaan.	vrt-bp1lhl0taikrteen****
RouteTableId	string	No	ID tabel rute yang akan dikueri. Catatan Anda harus menentukan setidaknya satu dari parameter berikut: VRouterId, RouteTableId, RouterId, dan RouteTableName. Anda tidak dapat menentukan VRouterId dan RouterId secara bersamaan.	vtb-bp145q7glnuzdvzu2****
RouterType	string	No	Tipe router tempat tabel rute berada. Nilai valid: VRouter (default): vRouter. VBR: Virtual Border Router.	VRouter
RouterId	string	No	ID router tempat tabel rute berada. Catatan Anda harus menentukan setidaknya satu dari parameter berikut: VRouterId, RouteTableId, RouterId, dan RouteTableName. Anda tidak dapat menentukan VRouterId dan RouterId secara bersamaan.	vrt-bp1lhl0taikrteen8****
Type	string	No	Tipe entri rute yang akan dikueri. Nilai valid: Custom: rute kustom. System: Rute sistem. BGP: rute BGP. CEN: rute Cloud Enterprise Network (CEN). ECR: rute Express Connect Router (ECR).	Custom
RouteTableName	string	No	Nama tabel rute yang akan dikueri. Panjang nama harus 2 hingga 128 karakter dan harus dimulai dengan huruf atau karakter Tionghoa. Nama dapat berisi angka, titik (.), garis bawah (_), dan tanda hubung (-). Catatan Anda harus menentukan setidaknya satu dari parameter berikut: VRouterId, RouteTableId, RouterId, dan RouteTableName. Anda tidak dapat menentukan VRouterId dan RouterId secara bersamaan.	doctest
ResourceGroupId	string	No	ID kelompok sumber daya tempat tabel rute berada.	rg-acfmxazb4ph****
PageNumber	integer	No	Nomor halaman. Nilai default: 1.	1
PageSize	integer	No	Jumlah entri per halaman untuk paging. Nilai maksimum: 50. Nilai default: 10.	10

Elemen respons

Element	Type	Description	Example
	object	Jumlah entri per halaman.
PageSize	integer	Jumlah entri per halaman.	10
RequestId	string	ID permintaan.	DC668356-BCB4-42FD-9BC3-FA2B2E04B634
PageNumber	integer	Nomor halaman saat ini.	1
TotalCount	integer	Jumlah total entri yang dikembalikan.	1
RouteTables	object
RouteTable	array<object>	Detail tabel rute.
	array<object>	Waktu pembuatan tabel rute.
CreationTime	string	Waktu pembuatan tabel rute. Waktu ditampilkan dalam UTC dengan format `YYYY-MM-DDThh:mm:ssZ`.	2022-08-22T10:40:25Z
Status	string	Status tabel rute. Nilai valid: Pending: sedang dikonfigurasi. Available: aktif.	Available
VRouterId	string	ID vRouter.	vrt-bp1lhl0taikrteen****
RouteTableType	string	Jenis tabel rute. Nilai valid: Custom: tabel rute kustom. System: tabel rute sistem.	Custom
ResourceGroupId	string	ID kelompok sumber daya tempat tabel rute berada.	rg-acfmxazb4ph****
RouteTableId	string	ID tabel rute.	vtb-bp145q7glnuzdvzu2****
RouteEntrys	object
RouteEntry	array<object>	Informasi entri rute.
	array<object>	Informasi entri rute.
Type	string	Jenis tujuan 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).	Custom
Status	string	Status entri rute. Nilai valid: Pending: sedang dikonfigurasi. Available: aktif. Modifying: sedang dimodifikasi.	Available
NextHopType	string	Jenis 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: gerbang IPv6. Attachment: Router transit. Ipv4Gateway: gerbang IPv4. GatewayEndpoint: Titik akhir gerbang. CenBasic: CEN yang tidak mendukung Router transit. Ecr: Express Connect Router (ECR).	Instance
RouteEntryName	string	Nama entri rute. Panjang nama harus 2 hingga 128 karakter dan harus diawali dengan huruf atau karakter Tionghoa. Nama dapat berisi angka, titik (.), garis bawah (_), dan tanda hubung (-).	name
RouteEntryId	string	ID entri rute.	rte-bp1mnnr2al0naomnp****
InstanceId	string	ID instans yang terkait dengan lompatan berikutnya.	vpc-bp1t36rn9l53iwbsf****
RouteTableId	string	ID tabel rute.	vtb-bp15w5q90d2rk3bww****
Description	string	Deskripsi entri rute. Panjang deskripsi harus 2 hingga 256 karakter dan harus diawali dengan huruf atau karakter Tionghoa. Deskripsi tidak dapat diawali dengan `http://` atau `https://`.	RouteEntryDescription
DestinationCidrBlock	string	Blok CIDR tujuan entri rute. Blok CIDR tujuan IPv4 dan IPv6 didukung. Persyaratan berikut harus dipenuhi: Blok CIDR tujuan tidak dapat mengarah ke atau berada dalam 100.64.0.0/10. Blok CIDR tujuan dari entri rute yang berbeda dalam tabel rute yang sama harus unik.	192.168.2.0/24
NextHops	object
NextHop	array<object>	Informasi lompatan berikutnya.
	object	Informasi lompatan berikutnya.
NextHopId	string	ID instans lompatan berikutnya.	vpn-bp10zyaph5cc8b7c7****
Weight	integer	Bobot entri rute.	100
NextHopType	string	Jenis 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: gerbang IPv6. Attachment: Router transit. Ipv4Gateway: gerbang IPv4. GatewayEndpoint: Titik akhir gerbang. CenBasic: CEN yang tidak mendukung Router transit. Ecr: Express Connect Router (ECR).	Instance
Enabled	integer	Apakah entri rute tersedia. Nilai valid: 0: tidak tersedia. 1: tersedia.	1
VSwitchIds	object
VSwitchId	array	ID vSwitch.
	string	ID vSwitch.	vsw-bp12mw1f8k3jgygk9****

Contoh

Respons sukses

JSONformat

{
  "PageSize": 10,
  "RequestId": "DC668356-BCB4-42FD-9BC3-FA2B2E04B634",
  "PageNumber": 1,
  "TotalCount": 1,
  "RouteTables": {
    "RouteTable": [
      {
        "CreationTime": "2022-08-22T10:40:25Z",
        "Status": "Available",
        "VRouterId": "vrt-bp1lhl0taikrteen****",
        "RouteTableType": "Custom",
        "ResourceGroupId": "rg-acfmxazb4ph****",
        "RouteTableId": "vtb-bp145q7glnuzdvzu2****",
        "RouteEntrys": {
          "RouteEntry": [
            {
              "Type": "Custom",
              "Status": "Available",
              "NextHopType": "Instance",
              "RouteEntryName": "name",
              "RouteEntryId": "rte-bp1mnnr2al0naomnp****",
              "InstanceId": "vpc-bp1t36rn9l53iwbsf****",
              "RouteTableId": "vtb-bp15w5q90d2rk3bww****",
              "Description": "RouteEntryDescription",
              "DestinationCidrBlock": "192.168.2.0/24",
              "NextHops": {
                "NextHop": [
                  {
                    "NextHopId": "vpn-bp10zyaph5cc8b7c7****",
                    "Weight": 100,
                    "NextHopType": "Instance",
                    "Enabled": 1
                  }
                ]
              }
            }
          ]
        },
        "VSwitchIds": {
          "VSwitchId": [
            "vsw-bp12mw1f8k3jgygk9****"
          ]
        }
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidVRouterId.NotFound	Specified virtual router does not exist.
400	OperationFailed.DescribeCenRoute	An error occurred while querying the CEN route entry.	Terjadi kesalahan saat mengkueri entri rute CEN.
400	OperationFailed.VRouterNotExist	Operation failed because the VRouter does not exist.	Operasi gagal karena vRouter tidak ada.
400	IllegalParam.Type	The parameter of Type is illegal.	Parameter Type tidak valid.
400	OperationFailed.InvalidRouterType	The operation is failed because of %s.	Jenis router tidak valid.
400	InvalidParam.RouterInstanceOrRouterId	The parameters routerInstanceId and routerId are mutually exclusive. Please use either routerInstanceId alone, or routerType with routerId.	Permintaan berisi parameter yang saling bertentangan. Anda harus menyediakan hanya routerInstanceId, atau menyediakan kedua routerType dan routerId. Hapus kombinasi parameter yang saling bertentangan dari permintaan.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.