Kueri detail rute dalam tabel rute dari transit router edisi enterprise - Cloud Enterprise Network - Alibaba Cloud - Cloud Enterprise Network

Mengkueri detail tentang entri rute dalam tabel rute Router transit Edisi Perusahaan.

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

cen:ListTransitRouterRouteEntries

get

TransitRouterRouteEntry

acs:cen:*:{#accountId}:centransitrouterroutentry/{#centransitrouterroutentryId}

TransitRouterRouteTable

acs:cen:*:{#accountId}:centransitrouterroutetable/{#centransitrouterroutetableId}

TransitRouterRouteEntry

acs:cen:*:{#accountId}:centransitrouterroutentry/*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
MaxResults	integer	No	Jumlah entri per halaman. Nilai valid: 1 hingga 100. Nilai default: 20.	20
TransitRouterRouteEntryDestinationCidrBlock `deprecated`	string	No	Blok CIDR tujuan entri rute. Parameter ini akan dihentikan. Kami menyarankan Anda menggunakan parameter RouteFilter.	192.168.0.0/24
TransitRouterRouteEntryStatus	string	No	Status entri rute. Nilai valid: All Active (default) Rejected Prohibited Standby Candidate Jika Anda tidak menentukan nilai, entri rute dalam status aktif akan dikueri.	Active
TransitRouterRouteTableId	string	Yes	ID tabel rute Router transit Edisi Perusahaan.	vtb-bp1dudbh2d5na6b50****
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. Anda harus menentukan token yang diperoleh dari kueri sebelumnya sebagai nilai NextToken.	fce19****
TransitRouterRouteEntryNames	array	No	Nama entri rute.	testname
	string	No	The route name. The name is optional. If you enter a name, it must be 1 to 128 characters in length, and cannot start with http:// or https://. Catatan You can use this parameter to query only static routes in the specified route table. This parameter conflicts with other query conditions except for TransitRouterRouteEntryIds.	testname
TransitRouterRouteEntryIds	array	No	ID entri rute.	rte-oklkgwmj97z6dn****
	string	No	The route ID. Catatan You can use this parameter to query only static routes in the specified route table. This parameter conflicts with other query conditions except for TransitRouterRouteEntryNames.	rte-oklkgwmj97z6dn****
TransitRouterRouteEntryType	string	No	Tipe entri rute. Nilai valid: Propagated: dipelajari secara otomatis oleh tabel rute. Static: entri rute statis.	Propagated
TransitRouterRouteEntryNextHopType	string	No	Tipe lompatan berikutnya. Nilai valid: BlackHole: mengarahkan lalu lintas jaringan ke black hole. Attachment: mengarahkan lalu lintas jaringan ke koneksi instans jaringan.	Attachment
TransitRouterRouteEntryNextHopId	string	No	ID koneksi instans jaringan yang ingin Anda tetapkan sebagai lompatan berikutnya.	tr-attach-nls9fzkfat8934****
TransitRouterRouteEntryNextHopResourceId	string	No	ID lompatan berikutnya.	vpc-m5ent6du8deaq5*****
TransitRouterRouteEntryNextHopResourceType	string	No	Tipe lompatan berikutnya. Nilai valid: VPC VBR TR VPN.	VPC
TransitRouterRouteEntryOriginResourceId	string	No	ID instans sumber.	vpc-m5ent6du8deaq5*****
TransitRouterRouteEntryOriginResourceType	string	No	Tipe instans sumber. Nilai valid: VPC VBR TR VPN.	VPC
PrefixListId	string	No	ID daftar awalan.	pl-6ehtn5kqxgeyy08fi****
RouteFilter	array<object>	No	Kondisi filter.
	object	No	The filter conditions.
Key	string	No	The match pattern for filtering CIDR blocks. Valid values: PrefixExactMatchCidrs: exact matching. LongestPrefixMatchCidrs: longest prefix matching. You can specify IP addresses and CIDR blocks. SubnetOfMatchCidrs: subnet matching. The subnets of the specified CIDR blocks, including the CIDR block, are matches against the match conditions. SupernetOfMatchCidrs: supernet matching. The supernets of the CIDR block, including the CIDR block, are matched against the match conditions. By default, the logical operator among filter conditions is AND. Information about a route entry is returned only if the route entry matches all filter conditions. Filter conditions must be unique.	PrefixExactMatchCidrs
Value	array	No	The filter value.
	string	No	Specify a filter value based on the Key. You can specify multiple values for a key. The logical operator among values is OR, which indicates that a route entry is a match if the request matches one of the values. You can specify at most 500 values for each match condition. IPv4 addresses and CIDR blocks and IPv6 addresses and CIDR blocks are supported.	192.168.1.0/24

Elemen respons

Element	Type	Description	Example
	object	The response parameters.
NextToken	string	A pagination token. It can be used in the next request to retrieve a new page of results. Valid values: If NextToken is empty, no next page exists. If a value is returned for NextToken, the value is the token that determines the start point of the next query.	fce19****
RequestId	string	The request ID.	C3835E5E-1504-4344-B1BB-98A4110F1079
TotalCount	integer	The total number of entries returned.	6
MaxResults	integer	The number of entries per page.	20
TransitRouterRouteEntries	array<object>	A list of route entries.
	array<object>	The information about the route.
TransitRouterRouteEntryId	string	The route ID. Catatan This parameter is returned only for static routes.	rte-oklkgwmj97z6dn****
TransitRouterRouteEntryDestinationCidrBlock	string	The destination CIDR block of the route entry. An IPv4 or IPv6 CIDR block is returned.	192.168.0.0/24
TransitRouterRouteEntryType	string	The type of the route. Valid values: Static: static routes. Propagated: automatically learned by the route table.	Static
CreateTime	string	The time when the route entry was created. The time follows the ISO8601 standard in the YYYY-MM-DDThh:mmZ format. The time is displayed in UTC. Catatan This parameter is returned only for static routes.	2021-06-15T07:01Z
TransitRouterRouteEntryName	string	The route name. Catatan This parameter is returned only for static routes.	testname
TransitRouterRouteEntryStatus	string	The route status. Valid values: Active Rejected Prohibited Standby Candidate Creating Deleting	Active
TransitRouterRouteEntryNextHopType	string	The next hop type. Valid values: BlackHole: a blackhole route. Packets destined for the destination CIDR block of the route are dropped. Attachment: a network instance connection. Packets destined for the destination CIDR block of the route are forwarded to the specified network instance connection.	BlackHole
TransitRouterRouteEntryNextHopId	string	The next hop ID. This parameter is not returned if the route is a blackhole route.	tr-attach-vx6iwhjr1x1j78****
TransitRouterRouteEntryDescription	string	The route description. Catatan This parameter is returned only for static routes.	CidrRoute
OperationalMode	boolean	Indicates whether the route can be managed. Valid values: true: The route can be managed. You can delete the route. false: The route cannot be managed because it is automatically generated by the system.	false
Tag	string	The route tag. Only PermitVbr may be returned, which indicates that the route is advertised only to the route tables of the virtual border routers (VBRs) that are connected to the transit router. Catatan This parameter is returned only for routes whose CIDR blocks are automatically generated by the system.	PermitVbr
TransitRouterRouteEntryNextHopResourceId	string	The next hop ID.	vpc-m5ent6du8deaq5*****
TransitRouterRouteEntryNextHopResourceType	string	The next hop type. Valid values: VPC VBR TR VPN	VPC
TransitRouterRouteEntryOriginResourceType	string	The source instance type. Valid values: VPC VBR TR VPN	VPC
TransitRouterRouteEntryOriginResourceId	string	The source instance ID.	vpc-m5ent6du8deaq5*****
PrefixListId	string	The prefix list ID.	pl-k1ainl66z3527773d****
PathAttributes	object	The route attributes.
Communities	array	The route community.
	string	The community attributes of the routes.	65501:1
AsPaths	array	The route AS path.
	string	The AS path of the route.	65501
OriginInstanceId	string	The source instance ID.	vbr-m5ent6du8deaq5*****
OriginInstanceType	string	The source instance type. Valid values: VPC VBR TR VPN CCN	VBR
OriginRouteType	string	The route type. Valid values: System Custom static BGP BlackHole	BGP
Preference	integer	The route priority. A smaller value indicates a higher priority.	50

Contoh

Respons sukses

JSONformat

{
  "NextToken": "fce19****",
  "RequestId": "C3835E5E-1504-4344-B1BB-98A4110F1079",
  "TotalCount": 6,
  "MaxResults": 20,
  "TransitRouterRouteEntries": [
    {
      "TransitRouterRouteEntryId": "rte-oklkgwmj97z6dn****",
      "TransitRouterRouteEntryDestinationCidrBlock": "192.168.0.0/24",
      "TransitRouterRouteEntryType": "Static",
      "CreateTime": "2021-06-15T07:01Z",
      "TransitRouterRouteEntryName": "testname",
      "TransitRouterRouteEntryStatus": "Active",
      "TransitRouterRouteEntryNextHopType": "BlackHole",
      "TransitRouterRouteEntryNextHopId": "tr-attach-vx6iwhjr1x1j78****",
      "TransitRouterRouteEntryDescription": "CidrRoute",
      "OperationalMode": false,
      "Tag": "PermitVbr",
      "TransitRouterRouteEntryNextHopResourceId": "vpc-m5ent6du8deaq5*****",
      "TransitRouterRouteEntryNextHopResourceType": "VPC",
      "TransitRouterRouteEntryOriginResourceType": "VPC",
      "TransitRouterRouteEntryOriginResourceId": "vpc-m5ent6du8deaq5*****",
      "PrefixListId": "pl-k1ainl66z3527773d****",
      "PathAttributes": {
        "Communities": [
          "65501:1"
        ],
        "AsPaths": [
          "65501"
        ],
        "OriginInstanceId": "vbr-m5ent6du8deaq5*****\n",
        "OriginInstanceType": "VBR",
        "OriginRouteType": "BGP",
        "Preference": 50
      }
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	IllegalParam.TransitRouterRouteTableId	TransitRouterRouteTableId is illegal.	The error message returned because the route table ID of the transit router (TransitRouterRouteTableId) is invalid.
400	IllegalParam.TransitRouterRouteEntryStatus	TransitRouterRouteEntryStatus is illegal.	The error message returned because the status of the route on the transit router (TransitRouterRouteEntryStatus) is invalid.
400	IllegalParam.NextToken	NextToken is illegal.	The error message returned because the NextToken parameter is set to an invalid value.
400	ParamExclusive.RouteEntryIdsAndStatus	TransitRouterRouteEntryIds and TransitRouterRouteEntryStatus is mutually exclusive.	The error message returned because the TransitRouterRouteEntryIds and TransitRouterRouteEntryStatus parameters conflict with each other.
400	InvalidTransitRouterRouteTableId.NotFound	TransitRouterRouteTableId is not found.	The error message returned because the specified route table ID of the transit router does not exist.
400	FilterKeyDuplicated.RouteFilter	The keys in RouteFilter are duplicated.	The error message returned because RouteFilter contains duplicate key values.
400	InvalidFilterKey	The key in filter is invalid.	The key in filter is invalid.
400	IllegalParam.TransitRouterRouteEntryNextHopType	TransitRouterRouteEntryNextHopType is invalid.	The error message returned because the TransitRouterRouteEntryNextHopType parameter is set to an invalid value.
400	IllegalParam.TransitRouterRouteEntryNextHopAttachmentId	TransitRouterRouteEntryNextHopAttachmentId is invalid.	The error message returned because TransitRouterRouteEntryNextHopAttachmentId is set to an invalid value.
400	IllegalParam.TransitRouterRouteEntryNextHopResourceId	TransitRouterRouteEntryNextHopResourceId is invalid.	The error message returned because TransitRouterRouteEntryNextHopResourceId is set to an invalid value.
400	IllegalParam.TransitRouterRouteEntryNextHopResourceType	TransitRouterRouteEntryNextHopResourceType is invalid.	The error message returned because TransitRouterRouteEntryNextHopResourceType is set to an invalid value.
400	IllegalParam.TransitRouterRouteEntryOriginResourceId	TransitRouterRouteEntryOriginResourceId is invalid.	The error message returned because TransitRouterRouteEntryOriginResourceId is set to an invalid value.
400	IllegalParam.TransitRouterRouteEntryOriginResourceType	TransitRouterRouteEntryOriginResourceType is invalid.	The error message returned because TransitRouterRouteEntryOriginResourceType is set to an invalid value.
400	IllegalParam.TransitRouterRouteEntryType	TransitRouterRouteEntryType is invalid.	The error message returned because TransitRouterRouteEntryType is set to an invalid value.
400	IllegalParam.PrefixExactMatchCidr	PrefixExactMatchCidr is invalid.	The error message returned because PrefixExactMatchCidr is set to an invalid value.
400	IllegalParam.LongestPrefixMatchCidr	LongestPrefixMatchCidr is invalid.	The error message returned because LongestPrefixMatchCidr is set to an invalid value.
400	IllegalParam.SubnetOfMatchCidr	SubnetOfMatchCidr is invalid.	The error message returned because SubnetOfMatchCidr is set to an invalid value.
400	IllegalParam.SupernetOfMatchCidr	SupernetOfMatchCidr is invalid.	The error message returned because SupernetOfMatchCidr is set to an invalid value.
400	InvalidName	Name is invalid.	The error message returned because the specified name is invalid.
400	IllegalParam.TextMatchCidr	The TextMatchCidr specified in the parameter is illegal.	The TextMatchCidr specified in the parameter is illegal.
400	ResourceNotFound.PrefixlistAssociation	The prefix list is not associated with this route table.	The error message returned because the specified prefix list is not associated with a route table.
400	InvalidParameter	Invalid parameter.	The error message returned because the parameter is set to an invalid value.
400	Unauthorized	The AccessKeyId is unauthorized.	The error message returned because you do not have the permissions to perform this operation.
404	InvalidRouteTableId.NotFound	The specified RouteTableId is not found.	The specified route table ID does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.