DescribeCenRouteMaps - 查询路由策略 - 云企业网

查询路由策略信息。

接口说明

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
cen:DescribeCenRouteMaps	READ	CEN acs:cen::{#accountId}:ceninstance/ CEN acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}	无	无

请求参数

名称	类型	必填	描述	示例值
PageNumber	integer	否	列表的页码。默认值：1。	1
PageSize	integer	否	分页查询时每页显示的条目数。默认值：10。	10
CenId	string	是	云企业网实例ID。	cen-wx12mmlt17ld82****
RouteMapId	string	否	路由策略ID。	cenrmap-y40mxdvf7joc12****
CenRegionId	string	否	路由策略应用的地域ID。您可以通过调用DescribeChildInstanceRegions接口获取地域ID。	cn-hangzhou
TransmitDirection	string	否	路由策略的应用方向。取值： RegionIn：入地域网关方向，表示路由传入云企业网地域网关的方向。例如：路由从本地域的网络实例发布到本地域网关，或其他地域的路由发布到本地域网关。 RegionOut：出地域网关方向，表示路由传出云企业网地域网关的方向。例如：路由从本地域网关发布到本地域下的网络实例，或发布到其他地域的地域网关。	RegionOut
TransitRouterRouteTableId	string	否	路由策略关联的转发路由器路由表ID。	vtb-gw8nx3515m1mbd1z1****

返回参数

名称	类型	描述	示例值
	object	返回结果。
PageSize	integer	分页查询时每页显示的条目数。	10
RequestId	string	请求ID。	24CE1987-D1D1-5324-9BAD-2750B60E6ABB
PageNumber	integer	列表的页码。	1
TotalCount	integer	列表条目数。	1
RouteMaps	array	路由策略信息列表。
	object	路由策略的信息。
RouteMapId	string	路由策略ID。	cenrmap-y40mxdvf7joc12****
Status	string	路由策略的状态。 Creating：创建中。 Active：可用。 Deleting：删除中。	Active
TransmitDirection	string	路由策略的应用方向。	RegionOut
SourceInstanceIdsReverseMatch	boolean	是否使用了源实例ID列表的排除匹配模式。 false：否，即路由传递的源实例ID在SourceInstanceIds.N中时，匹配通过。 true：是，即路由传递的源实例ID不在SourceInstanceIds.N中时，匹配通过。	false
CenRegionId	string	路由策略应用的地域ID。	cn-hangzhou
CenId	string	云企业网实例ID。	cen-wx12mmlt17ld82****
Priority	integer	路由策略的优先级。优先级数字越小，代表优先级越高。	5000
TransitRouterRouteTableId	string	路由策略关联的转发路由器路由表ID。	vtb-gw8nx3515m1mbd1z1****
CommunityOperateMode	string	Community的执行模式。 Additive：添加，表示为路由添加Community。 Replace：替换，表示替换路由原有的Community。本参数表示路由通过匹配条件后，要执行的操作。	Additive
MapResult	string	所有匹配条件都通过后的策略行为。 Permit：允许被匹配的路由通过。 Deny：拒绝被匹配的路由通过。	Deny
CommunityMatchMode	string	Community的匹配模式。 Include：模糊匹配，匹配条件中的Community与被匹配路由的Community有重叠即判定为匹配成功。 Complete：精确匹配，匹配条件中的Community必须与被匹配路由的Community一致，才判定为匹配成功。	Include
Description	string	路由策略的描述信息。	desctest
AsPathMatchMode	string	AS Path列表的匹配模式。 Include：模糊匹配，匹配条件中的AS Path与被匹配路由的AS Path有重叠即判定为匹配成功。 Complete：精确匹配，匹配条件中的AS Path必须与被匹配路由的AS Path一致，才判定为匹配成功。	Include
Preference	integer	要修改的路由的优先级。优先级数字越小表示优先级越高。本参数表示路由通过匹配条件后，要执行的操作。	20
DestinationInstanceIdsReverseMatch	boolean	是否使用了目的实例ID列表的排除匹配模式。 false：否，即路由传递的目的实例ID在DestinationInstanceIds.N中时，匹配通过。 true：是，即路由传递的目的实例ID不在DestinationInstanceIds.N中时，匹配通过。	false
CidrMatchMode	string	前缀列表的匹配模式。取值： Include：模糊匹配。匹配条件中的路由前缀包含被匹配路由的路由前缀即判定为匹配成功。例如：定义10.10.0.0/16的策略可以模糊匹配到10.10.1.0/24的路由。 Complete：精确匹配。匹配条件中的路由前缀必须与被匹配路由的路由前缀一致，才判定为匹配成功。例如：定义10.10.0.0/16的策略仅可以精确匹配到10.10.0.0/16的路由。	Include
NextPriority	integer	关联的下一条路由策略的优先级。	33
MatchAddressType	string	路由需匹配的IP地址类型。 IPv4：表示只匹配IPv4路由。 IPv6：表示只匹配IPv6路由。如果系统未返回该值，则表示同时匹配IPv4和IPv6的路由。	IPv4
SourceRegionIds	array	路由需匹配的源地域ID列表。
	string	路由需匹配的源地域ID列表。	cn-hangzhou
SourceChildInstanceTypes	array	路由需匹配的源实例类型列表。 VPC：专有网络实例。 VBR：边界路由器实例。 CCN：云连接网实例。 VPN：IPsec连接。
	string	路由需匹配的源实例类型列表。 VPC：专有网络实例。 VBR：边界路由器实例。 CCN：云连接网实例。 VPN：IPsec连接。	VPC
DestinationRouteTableIds	array	路由需匹配的目的路由表ID列表。最多支持输入32个路由表ID。说明仅路由策略的应用方向为出地域网关方向，且目的路由表ID为本地域下网络实例的路由表ID时，目的路由表ID列表才会生效。
	string	路由需匹配的目的路由表ID列表。最多支持输入32个路由表ID。说明仅路由策略的应用方向为出地域网关方向，且目的路由表ID为本地域下网络实例的路由表ID时，目的路由表ID列表才会生效。	vtb-adefrgtr144vf****
SourceInstanceIds	array	路由需匹配的源实例ID列表。
	string	路由需匹配的源实例ID列表。	vpc-adeg3544fdf34vf****
DestinationCidrBlocks	array	路由需匹配的前缀列表。
	string	路由需匹配的前缀列表。	10.10.10.0/24
SourceRouteTableIds	array	路由需匹配的源路由表ID列表。
	string	路由需匹配的源路由表ID列表。	vtb-adfr233vf34rvd4****
MatchCommunitySet	array	路由需匹配的Community集合。
	string	路由需匹配的Community集合。	65501:1
PrependAsPath	array	地域网关接收或发布路由时附加的AS Path。本参数表示路由通过匹配条件后，要执行的操作。
	string	地域网关接收或发布路由时附加的AS Path。本参数表示路由通过匹配条件后，要执行的操作。	65501
RouteTypes	array	路由需匹配的路由类型列表。 System：系统路由，由系统自动生成的路由。 Custom：自定义路由，由用户手动添加的路由。 BGP：BGP路由，通过BGP路由协议传播的路由。
	string	路由需匹配的路由类型列表。 System：系统路由，由系统自动生成的路由。 Custom：自定义路由，由用户手动添加的路由。 BGP：BGP路由，通过BGP路由协议传播的路由。	System
DestinationChildInstanceTypes	array	路由需匹配的目的实例类型列表。 VPC：专有网络实例。 VBR：边界路由器实例。 CCN：云连接网实例。 VPN：IPsec连接。说明仅路由策略的应用方向为出地域网关方向，且目的实例类型为本地域下的实例类型时，目的实例类型列表才会生效。
	string	路由需匹配的目的实例类型列表。 VPC：专有网络实例。 VBR：边界路由器实例。 CCN：云连接网实例。 VPN：IPsec连接。说明仅路由策略的应用方向为出地域网关方向，且目的实例类型为本地域下的实例类型时，目的实例类型列表才会生效。	VPC
DestinationInstanceIds	array	路由需匹配的目的实例ID列表。说明仅路由策略的应用方向为出地域网关方向，且目的实例ID为本地域下的实例ID时，目的实例ID列表才会生效。
	string	路由需匹配的目的实例ID列表。说明仅路由策略的应用方向为出地域网关方向，且目的实例ID为本地域下的实例ID时，目的实例ID列表才会生效。	vpc-afrfs434465fdf****
MatchAsns	array	路由需匹配的AS Path列表。
	string	路由需匹配的AS Path列表。	65501
OperateCommunitySet	array	要执行的Community集合。
	string	要执行的Community集合。	65501:1

示例

正常返回示例

JSON格式

{
  "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"
          ]
        },
        "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"
          ]
        }
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameter	Invalid parameter.	参数不合法。
400	Unauthorized	The AccessKeyId is unauthorized.	账号无权限操作。

访问错误中心查看更多错误码。