调用DescribeCenRouteMaps接口查询路由策略信息。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeCenRouteMaps

要执行的操作。取值:DescribeCenRouteMaps

CenId String cen-wx12mmlt17ld82****

云企业网实例ID。

CenRegionId String cn-hangzhou

路由策略应用的地域ID。

您可以通过调用DescribeChildInstanceRegions接口获取地域ID。

RouteMapId String cenrmap-y40mxdvf7joc12****

路由策略ID。

TransmitDirection String RegionOut

路由策略的应用方向。取值:

  • RegionIn:入地域网关方向,表示路由传入云企业网地域网关的方向。

    例如:路由从本地域的网络实例发布到本地域网关,或其他地域的路由发布到本地域网关。

  • RegionOut:出地域网关方向,表示路由传出云企业网地域网关的方向。

    例如:路由从本地域网关发布到本地域下的网络实例,或发布到其他地域的地域网关。

PageNumber Integer 1

查询页码。默认值为1

PageSize Integer 10

分页查询时每页显示的条目数。默认值为10

返回数据

名称 类型 示例值 描述
RouteMaps Array of RouteMap

路由策略的信息。

RouteMap
AsPathMatchMode String Include

AS Path列表的匹配模式。

  • Include:模糊匹配,匹配条件中的AS Path与被匹配路由的AS Path有重叠即判定为匹配成功。
  • Complete:精确匹配,匹配条件中的AS Path必须与被匹配路由的AS Path一致,才判定为匹配成功。
CenId String cen-wx12mmlt17ld82****

云企业网实例ID。

CenRegionId String cn-hangzhou

路由策略应用的地域ID。

CidrMatchMode String Include

前缀列表的匹配模式。取值:

  • Include:模糊匹配。匹配条件中的路由前缀包含被匹配路由的路由前缀即判定为匹配成功。

    例如:定义10.10.0.0/16的策略可以模糊匹配到10.10.1.0/24的路由。

  • Complete:精确匹配。匹配条件中的路由前缀必须与被匹配路由的路由前缀一致,才判定为匹配成功。

    例如:定义10.10.0.0/16的策略仅可以精确匹配到10.10.0.0/16的路由。

CommunityMatchMode String Include

Community的匹配模式。

  • Include:模糊匹配,匹配条件中的Community与被匹配路由的Community有重叠即判定为匹配成功。
  • Complete:精确匹配,匹配条件中的Community必须与被匹配路由的Community一致,才判定为匹配成功。
CommunityOperateMode String Additive

Community的执行模式。

  • Additive:添加,表示为路由添加Community。
  • Replace:替换,表示替换路由原有的Community。

本参数表示路由通过匹配条件后,要执行的操作。

Description String desctest

路由策略的描述信息。

DestinationChildInstanceTypes List VPC

路由需匹配的目的实例类型列表。

  • VPC:专有网络实例。
  • VBR:边界路由器实例。
  • CCN:云连接网实例。
说明 仅路由策略的应用方向为出地域网关方向,且目的实例类型为本地域下的实例类型时,目的实例类型列表才会生效。
DestinationCidrBlocks List 10.10.10.0/24

路由需匹配的前缀列表。

DestinationInstanceIds List vpc-afrfs434465fdf****

路由需匹配的目的实例ID列表。

说明 仅路由策略的应用方向为出地域网关方向,且目的实例ID为本地域下的实例ID时,目的实例ID列表才会生效。
DestinationInstanceIdsReverseMatch Boolean false

是否使用了目的实例ID列表的排除匹配模式。

  • false(默认值):否,即路由传递的目的实例ID在DestinationInstanceIds.N中时,匹配通过。
  • true:是,即路由传递的目的实例ID不在DestinationInstanceIds.N中时,匹配通过。
DestinationRouteTableIds List vtb-adefrgtr144vf****

路由需匹配的目的路由表ID列表。最多支持输入32个路由表ID。

说明 仅路由策略的应用方向为出地域网关方向,且目的路由表ID为本地域下网络实例的路由表ID时,目的路由表ID列表才会生效。
MapResult String Deny

所有匹配条件都通过后的策略行为。

  • Permit:允许被匹配的路由通过。
  • Deny:拒绝被匹配的路由通过。
MatchAsns List 65501

路由需匹配的AS Path列表。

MatchCommunitySet List 65501:1

路由需匹配的Community集合。

NextPriority Integer 33

关联的下一条路由策略的优先级。

OperateCommunitySet List 65501:1

要执行的Community集合。

Preference Integer 20

要修改的路由的优先级。

优先级数字越小表示优先级越高。

本参数表示路由通过匹配条件后,要执行的操作。

PrependAsPath List 65501

地域网关接收或发布路由时附加的AS Path。

本参数表示路由通过匹配条件后,要执行的操作。

Priority Integer 5000

路由策略的优先级。优先级数字越小,代表优先级越高。

RouteMapId String cenrmap-y40mxdvf7joc12****

路由策略ID。

RouteTypes List System

路由需匹配的路由类型列表。

  • System:系统路由,由系统自动生成的路由。
  • Custom:自定义路由,由用户手动添加的路由。
  • BGP:BGP路由,通过BGP路由协议传播的路由。
SourceChildInstanceTypes List VPC

路由需匹配的源实例类型列表。

  • VPC:专有网络实例。
  • VBR:边界路由器实例。
  • CCN:云连接网实例。
SourceInstanceIds List vpc-adeg3544fdf34vf****

路由需匹配的源实例ID列表。

SourceInstanceIdsReverseMatch Boolean false

是否使用了源实例ID列表的排除匹配模式。

  • false(默认值):否,即路由传递的源实例ID在SourceInstanceIds.N中时,匹配通过。
  • true:是,即路由传递的源实例ID不在SourceInstanceIds.N中时,匹配通过。
SourceRegionIds List cn-hangzhou

路由需匹配的源地域ID列表。

SourceRouteTableIds List vtb-adfr233vf34rvd4****

路由需匹配的源路由表ID列表。

Status String Active

路由策略的状态。

  • Creating:创建中。
  • Active:可用。
  • Deleting:删除中。
TransmitDirection String RegionOut

路由策略的应用方向。

PageSize Integer 10

分页查询时每页显示的条目数。

PageNumber Integer 1

查询页码。

TotalCount Integer 1

总条目数。

RequestId String 24CE1987-D1D1-5324-9BAD-2750B60E6ABB

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeCenRouteMaps
&CenId=cen-7qthudw0ll6jmc****
&<公共请求参数>

正常返回示例

XML格式

<DescribeCenRouteMapsResponse>
  <TotalCount>1</TotalCount>
  <RequestId>24CE1987-D1D1-5324-9BAD-2750B60E6ABB</RequestId>
  <PageSize>10</PageSize>
  <PageNumber>1</PageNumber>
  <RouteMaps>
        <RouteMap>
              <Status>Active</Status>
              <Priority>5000</Priority>
              <SourceChildInstanceTypes>
                    <SourceChildInstanceType>VBR</SourceChildInstanceType>
                    <SourceChildInstanceType>CCN</SourceChildInstanceType>
              </SourceChildInstanceTypes>
              <CenId>cen-wx12mmlt17ld82****</CenId>
              <TransmitDirection>RegionOut</TransmitDirection>
              <CenRegionId>cn-hangzhou</CenRegionId>
              <RouteMapId>cenrmap-y40mxdvf7joc12****</RouteMapId>
              <MapResult>Deny</MapResult>
              <DestinationChildInstanceTypes>
                    <DestinationChildInstanceType>VBR</DestinationChildInstanceType>
                    <DestinationChildInstanceType>CCN</DestinationChildInstanceType>
              </DestinationChildInstanceTypes>
        </RouteMap>
  </RouteMaps>
</DescribeCenRouteMapsResponse>

JSON格式

{
    "TotalCount": 1,
    "RequestId": "24CE1987-D1D1-5324-9BAD-2750B60E6ABB",
    "PageSize": 10,
    "PageNumber": 1,
    "RouteMaps": {
        "RouteMap": [
            {
                "Status": "Active",
                "Priority": 5000,
                "SourceChildInstanceTypes": {
                    "SourceChildInstanceType": [
                        "VBR",
                        "CCN"
                    ]
                },
                "CenId": "cen-wx12mmlt17ld82****",
                "TransmitDirection": "RegionOut",
                "CenRegionId": "cn-hangzhou",
                "RouteMapId": "cenrmap-y40mxdvf7joc12****",
                "MapResult": "Deny",
                "DestinationChildInstanceTypes": {
                    "DestinationChildInstanceType": [
                        "VBR",
                        "CCN"
                    ]
                }
            }
        ]
    }
}

错误码

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