Kueri konfigurasi kebijakan perutean menggunakan DescribeCenRouteMaps - Cloud Enterprise Network - Alibaba Cloud - Cloud Enterprise Network

Mengkueri konfigurasi kebijakan perutean.

Deskripsi operasi

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

get

*CenInstance

acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
PageNumber	integer	No	Nomor halaman. Nilai default: 1.	1
PageSize	integer	No	Jumlah entri per halaman. Nilai default: 10.	10
CenId	string	Yes	ID instans Cloud Enterprise Network (CEN).	cen-wx12mmlt17ld82****
RouteMapId	string	No	ID kebijakan perutean.	cenrmap-y40mxdvf7joc12****
CenRegionId	string	No	ID wilayah tempat kebijakan perutean diterapkan. Anda dapat memanggil operasi DescribeChildInstanceRegions untuk mengkueri ID wilayah.	cn-hangzhou
TransmitDirection	string	No	Arah penerapan kebijakan perutean. Nilai valid: RegionIn: Arah masuk. Kebijakan perutean diterapkan pada entri rute yang diiklankan ke gerbang suatu wilayah. Misalnya, entri rute diiklankan dari instans jaringan di wilayah saat ini ke gerbang wilayah saat ini, atau entri rute dari wilayah lain diiklankan ke gerbang wilayah saat ini. RegionOut: Arah keluar. Kebijakan perutean diterapkan pada entri rute yang diiklankan dari gerbang suatu wilayah. Misalnya, entri rute diiklankan dari gerbang wilayah saat ini ke instans jaringan di wilayah saat ini, atau ke gerbang di wilayah lain.	RegionOut
TransitRouterRouteTableId	string	No	ID tabel rute router transit yang terkait dengan kebijakan perutean.	vtb-gw8nx3515m1mbd1z1****

Elemen respons

Element	Type	Description	Example
	object	The response.
PageSize	integer	The number of entries returned per page.	10
RequestId	string	The request ID.	24CE1987-D1D1-5324-9BAD-2750B60E6ABB
PageNumber	integer	The page number.	1
TotalCount	integer	The total number of entries returned.	1
RouteMaps	object
RouteMap	array<object>	A list of routing policies.
	array<object>	The information about the routing policy.
RouteMapId	string	The ID of the routing policy.	cenrmap-y40mxdvf7joc12****
Status	string	The status of the routing policy. Creating: The routing policy is being created. Active: The routing policy is available. Deleting: The routing policy is being deleted.	Active
TransmitDirection	string	The direction in which the routing policy is applied.	RegionOut
SourceInstanceIdsReverseMatch	boolean	Indicates whether the source instance IDs are excluded. false: The match is successful if the source instance ID of the route is in the SourceInstanceIds.N list. true: The match is successful if the source instance ID of the route is not in the SourceInstanceIds.N list.	false
CenRegionId	string	The ID of the region where the routing policy is applied.	cn-hangzhou
CenId	string	The ID of the CEN instance.	cen-wx12mmlt17ld82****
Priority	integer	The priority of the routing policy. A smaller value indicates a higher priority.	5000
TransitRouterRouteTableId	string	The ID of the route table of the transit router that is associated with the routing policy.	vtb-gw8nx3515m1mbd1z1****
CommunityOperateMode	string	The action to be performed on the community. Additive: adds the community to the route. Replace: replaces the original community of the route. This parameter specifies the action to be performed after a route meets the match conditions.	Additive
MapResult	string	The action that is performed after all match conditions are met. Permit: allows the matched route. Deny: denies the matched route.	Deny
CommunityMatchMode	string	The match mode for the community. Include: fuzzy match. The match is successful if the community of the route overlaps with the community in the match condition. Complete: exact match. The match is successful only if the community of the route is the same as the community in the match condition.	Include
Description	string	The description of the routing policy.	desctest
AsPathMatchMode	string	The match mode for the AS-path. Include: fuzzy match. The match is successful if the AS-path of the route overlaps with the AS-path in the match condition. Complete: exact match. The match is successful only if the AS-path of the route is the same as the AS-path in the match condition.	Include
Preference	integer	The new priority of the route. A smaller value indicates a higher priority. This parameter specifies the action to be performed after a route meets the match conditions.	20
DestinationInstanceIdsReverseMatch	boolean	Indicates whether the destination instance IDs are excluded. false: The match is successful if the destination instance ID of the route is in the DestinationInstanceIds.N list. true: The match is successful if the destination instance ID of the route is not in the DestinationInstanceIds.N list.	false
CidrMatchMode	string	The match mode for the prefix list. Valid values: Include: fuzzy match. The match is successful if the route prefix in the match condition includes the route prefix of the route. For example, a policy with the 10.10.0.0/16 route prefix matches the 10.10.1.0/24 route. Complete: exact match. The match is successful only if the route prefix in the match condition is the same as the route prefix of the route. For example, a policy with the 10.10.0.0/16 route prefix matches only the 10.10.0.0/16 route.	Include
NextPriority	integer	The priority of the next routing policy that is associated with the current routing policy.	33
MatchAddressType	string	The IP address family of the route. IPv4: matches only IPv4 routes. IPv6: matches only IPv6 routes. If this parameter is not returned, both IPv4 and IPv6 routes are matched.	IPv4
SourceRegionIds	object
SourceRegionId	array	A list of source region IDs to be matched.
	string	A list of source region IDs to be matched.	cn-hangzhou
SourceChildInstanceTypes	object
SourceChildInstanceType	array	A list of source instance types to be matched. VPC: virtual private cloud (VPC). VBR: virtual border router (VBR). CCN: Cloud Connect Network (CCN). VPN: IPsec connection.
	string	A list of source instance types to be matched. VPC: VPC. VBR: VBR. CCN: CCN. VPN: IPsec connection.	VPC
DestinationRouteTableIds	object
DestinationRouteTableId	array	A list of destination route table IDs to be matched. You can enter up to 32 route table IDs. Catatan This parameter takes effect only when the routing policy is applied to the outbound direction of the regional gateway and the destination route table belongs to a network instance in the current region.
	string	A list of destination route table IDs to be matched. You can enter up to 32 route table IDs. Catatan This parameter takes effect only when the routing policy is applied to the outbound direction of the regional gateway and the destination route table belongs to a network instance in the current region.	vtb-adefrgtr144vf****
SourceInstanceIds	object
SourceInstanceId	array	A list of source instance IDs to be matched.
	string	A list of source instance IDs to be matched.	vpc-adeg3544fdf34vf****
DestinationCidrBlocks	object
DestinationCidrBlock	array	A list of prefixes to be matched. Both IPv4 and IPv6 prefixes are supported.
	string	A list of prefixes to be matched. Both IPv4 and IPv6 prefixes are supported.	10.10.10.0/24
DestinationRegionIds	object
DestinationRegionId	array	A list of destination region IDs.
	string	A list of destination region IDs.	cn-beijing
SourceRouteTableIds	object
SourceRouteTableId	array	A list of source route table IDs to be matched.
	string	A list of source route table IDs to be matched.	vtb-adfr233vf34rvd4****
MatchCommunitySet	object
MatchCommunity	array	The community to be matched.
	string	The community to be matched.	65501:1
PrependAsPath	object
AsPath	array	The AS-path that is prepended when the regional gateway receives or advertises a route. This parameter specifies the action to be performed after a route meets the match conditions.
	string	The AS-path that is prepended when the regional gateway receives or advertises a route. This parameter specifies the action to be performed after a route meets the match conditions.	65501
RouteTypes	object
RouteType	array	A list of route types to be matched. System: system routes that are automatically generated by the system. Custom: custom routes that are manually added. BGP: routes that are advertised through Border Gateway Protocol (BGP).
	string	A list of route types to be matched. System: system routes that are automatically generated by the system. Custom: custom routes that are manually added. BGP: routes that are advertised through BGP.	System
DestinationChildInstanceTypes	object
DestinationChildInstanceType	array	A list of destination instance types to be matched. VPC: VPC. VBR: VBR. CCN: CCN. VPN: IPsec connection. Catatan This parameter takes effect only when the routing policy is applied to the outbound direction of the regional gateway and the destination instance is in the current region.
	string	A list of destination instance types to be matched. VPC: VPC. VBR: VBR. CCN: CCN. VPN: IPsec connection. Catatan This parameter takes effect only when the routing policy is applied to the outbound direction of the regional gateway and the destination instance is in the current region.	VPC
DestinationInstanceIds	object
DestinationInstanceId	array	A list of destination instance IDs to be matched. Catatan This parameter takes effect only when the routing policy is applied to the outbound direction of the regional gateway and the destination instance is in the current region.
	string	A list of destination instance IDs to be matched. Catatan This parameter takes effect only when the routing policy is applied to the outbound direction of the regional gateway and the destination instance is in the current region.	vpc-afrfs434465fdf****
MatchAsns	object
MatchAsn	array	A list of AS-paths to be matched.
	string	A list of AS-paths to be matched.	65501
OperateCommunitySet	object
OperateCommunity	array	The community to be operated.
	string	The community to be operated.	65501:1

Contoh

Respons sukses

JSONformat

{
  "PageSize": 10,
  "RequestId": "24CE1987-D1D1-5324-9BAD-2750B60E6ABB",
  "PageNumber": 1,
  "TotalCount": 1,
  "RouteMaps": {
    "RouteMap": [
      {
        "RouteMapId": "cenrmap-y40mxdvf7joc12****",
        "Status": "Active",
        "TransmitDirection": "RegionOut",
        "SourceInstanceIdsReverseMatch": false,
        "CenRegionId": "cn-hangzhou",
        "CenId": "cen-wx12mmlt17ld82****",
        "Priority": 5000,
        "TransitRouterRouteTableId": "vtb-gw8nx3515m1mbd1z1****",
        "CommunityOperateMode": "Additive",
        "MapResult": "Deny",
        "CommunityMatchMode": "Include",
        "Description": "desctest",
        "AsPathMatchMode": "Include",
        "Preference": 20,
        "DestinationInstanceIdsReverseMatch": false,
        "CidrMatchMode": "Include",
        "NextPriority": 33,
        "MatchAddressType": "IPv4",
        "SourceRegionIds": {
          "SourceRegionId": [
            "cn-hangzhou"
          ]
        },
        "SourceChildInstanceTypes": {
          "SourceChildInstanceType": [
            "VPC"
          ]
        },
        "DestinationRouteTableIds": {
          "DestinationRouteTableId": [
            "vtb-adefrgtr144vf****"
          ]
        },
        "SourceInstanceIds": {
          "SourceInstanceId": [
            "vpc-adeg3544fdf34vf****"
          ]
        },
        "DestinationCidrBlocks": {
          "DestinationCidrBlock": [
            "10.10.10.0/24"
          ]
        },
        "DestinationRegionIds": {
          "DestinationRegionId": [
            "cn-beijing"
          ]
        },
        "SourceRouteTableIds": {
          "SourceRouteTableId": [
            "vtb-adfr233vf34rvd4****"
          ]
        },
        "MatchCommunitySet": {
          "MatchCommunity": [
            "65501:1"
          ]
        },
        "PrependAsPath": {
          "AsPath": [
            "65501"
          ]
        },
        "RouteTypes": {
          "RouteType": [
            "System"
          ]
        },
        "DestinationChildInstanceTypes": {
          "DestinationChildInstanceType": [
            "VPC"
          ]
        },
        "DestinationInstanceIds": {
          "DestinationInstanceId": [
            "vpc-afrfs434465fdf****"
          ]
        },
        "MatchAsns": {
          "MatchAsn": [
            "65501"
          ]
        },
        "OperateCommunitySet": {
          "OperateCommunity": [
            "65501:1"
          ]
        }
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
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.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.