调用DescribePublishedRouteEntries接口查询云企业网下网络实例路由条目的发布信息。

调试

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

请求参数

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

要执行的操作。取值：DescribePublishedRouteEntries。

CenId String 是 cen-7qthudw0ll6jm****

云企业网实例ID。
ChildInstanceId String 是 vpc-bp18sth14qii3pnv****

网络实例ID。
ChildInstanceRegionId String 是 cn-hangzhou

网络实例所属地域ID。

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

ChildInstanceType String 是 VPC

网络实例类型。取值：

  • VPC：专有网络。
  • VBR：边界路由器。
  • CCN：云连接网。
PageNumber Integer 否 1

查询页码。默认值为1。

PageSize Integer 否 10

分页查询时每页显示的条目数。默认值为10，取值范围：1~50。

ChildInstanceRouteTableId String 否 vtb-bp174d1gje79u1g4****

网络实例的路由表ID。
DestinationCidrBlock String 否 172.16.0.0/16

要查询的路由条目的目标网段。

返回数据

名称 类型 示例值 描述
PageNumber Integer 1

查询页码。
PageSize Integer 10

分页查询时每页显示的条目数。
PublishedRouteEntries Array of PublishedRouteEntry

路由条目信息列表。
PublishedRouteEntry
ChildInstanceRouteTableId String vtb-il7qut3mjgtlcbpk2****

网络实例的路由表ID。
Conflicts Array of Conflict

产生冲突的路由条目信息列表。
Conflict
DestinationCidrBlock String 192.168.20.0/24

产生冲突的路由条目的目标网段。
InstanceId String ccn-0q3b7oviikmm9h****

产生路由冲突的对端的网络实例ID。
InstanceType String CCN

产生路由条目冲突的对端的网络实例类型。

  • VPC：专有网络。
  • VBR：边界路由器。
  • CCN：云连接网。
RegionId String ccn-cn-shanghai

产生路由条目冲突的对端的网络实例所属地域ID。
Status String conflict

路由条目产生冲突的原因。

  • conflict：路由条目的目标网段相同造成的冲突。
  • overflow：其他网络实例路由表的路由条目数量超出限制造成的冲突。
DestinationCidrBlock String 172.16.0.0/16

路由条目的目标网段。
NextHopId String ecs-bp18sth14qii3pn****

路由条目下一跳关联的实例ID。
NextHopType String Instance

路由条目下一跳关联的实例类型。

  • Instance：ECS实例。
  • HaVip：高可用虚拟IP。
  • RouterInterface：路由器接口。
  • NetworkInterface：弹性网卡。
  • VpnGateway：VPN网关。
  • IPv6Gateway：IPv6网关。
  • NatGateway：NAT网关。
  • Attachment：网络实例连接。
  • service：云服务。
  • VBR：边界路由器。
  • CCN：云连接网。
  • VPC：专有网络。
  • local：表示当前路由条目为网络实例的系统路由，没有下一跳。
  • TR：转发路由器。
  • BlackHole ：表示当前路由条目为黑洞路由，没有下一跳。
  • EcRouterInterface ：高速通道路由器接口。
  • HealthCheck：健康检查。
  • AS：云连接网接入网关。
  • classicLink：经典网络实例。
  • GatewayEndpoint：网关终端节点。
  • CPE：边界路由器连接的本地数据中心。
OperationalMode Boolean true

是否允许发布或撤销该路由到云企业网。

  • true：允许发布或撤销。
  • false：不允许发布或撤销。
PublishStatus String Published

在云企业网中的发布状态：

  • Published：已发布。
  • NonPublished：未发布。
RouteType String System

路由条目的类型。

  • CEN：表示通过云企业网传递的路由。
  • System：表示系统路由。
  • Custom：表示自定义路由。
RequestId String FF1A7B2A-677F-4F71-96EA-6002B329F437

请求ID。
TotalCount Integer 2

总条目数。

示例

请求示例

1
2
3
4
5
6
http(s)://[Endpoint]/?Action=DescribePublishedRouteEntries
&CenId=cen-7qthudw0ll6jm****
&ChildInstanceId=vpc-bp18sth14qii3pnv****
&ChildInstanceRegionId=cn-hangzhou
&ChildInstanceType=VPC
&<公共请求参数>

正常返回示例

XML格式

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
<DescribeRouteConflictResponse>
      <TotalCount>2</TotalCount>
      <PublishRouteEntries>
            <PublishRouteEntries>
                  <DestinationCidrBlock>100.64.0.0/10</DestinationCidrBlock>
                  <NextHopId></NextHopId>
                  <NextHopType>service</NextHopType>
                  <ChildInstanceRouteTableId>vtb-il7qut3mjgtlcbpk2****</ChildInstanceRouteTableId>
                  <PublishStatus>NonPublished</PublishStatus>
                  <RouteConflicts></RouteConflicts>
                  <RouteType>System</RouteType>
            </PublishRouteEntries>
            <PublishRouteEntries>
                  <DestinationCidrBlock>192.168.10.0/24</DestinationCidrBlock>
                  <NextHopId></NextHopId>
                  <NextHopType>local</NextHopType>
                  <ChildInstanceRouteTableId>vtb-il7qut3mjgtlcbpk2****</ChildInstanceRouteTableId>
                  <PublishStatus>Published</PublishStatus>
                  <RouteConflicts></RouteConflicts>
                  <RouteType>System</RouteType>
            </PublishRouteEntries>
      </PublishRouteEntries>
      <PageNumber>1</PageNumber>
      <RequestId>FF1A7B2A-677F-4F71-96EA-6002B329F437</RequestId>
      <PageSize>10</PageSize>
</DescribeRouteConflictResponse>

JSON格式

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
{
    "TotalCount": 2,
    "PublishRouteEntries": {
        "PublishRouteEntries": [
            {
                "DestinationCidrBlock": "100.64.0.0/10",
                "NextHopId": "",
                "NextHopType": "service",
                "ChildInstanceRouteTableId": "vtb-il7qut3mjgtlcbpk2****",
                "PublishStatus": "NonPublished",
                "RouteConflicts": {
                    "RouteConflicts": []
                },
                "RouteType": "System"
            },
            {
                "DestinationCidrBlock": "192.168.10.0/24",
                "NextHopId": "",
                "NextHopType": "local",
                "ChildInstanceRouteTableId": "vtb-il7qut3mjgtlcbpk2****",
                "PublishStatus": "Published",
                "RouteConflicts": {
                    "RouteConflicts": []
                },
                "RouteType": "System"
            }
        ]
    },
    "PageNumber": 1,
    "RequestId": "FF1A7B2A-677F-4F71-96EA-6002B329F437",
    "PageSize": 10
}

错误码

HttpCode 错误码 错误信息 描述
400 ParameterIllegal.CenInstanceId The parameter of CEN instance id is illegal. 云企业网ID不正确。
400 ParameterIllegal.ChildInstanceRegionId The parameter of child instance region id is illegal. 网络实例所属地域信息不正确。
409 InvalidOperation.ChildInstanceStatus The child-instance is not in a valid state for the operation. 网络子实例正在处理状态，请稍后再操作。
409 InvalidOperation.CenInstanceStatus The CEN instance is not in a valid state for the operation. CEN实例正在处理状态，请稍后再操作。
400 ParameterIllegal.ChildInstanceType The parameter of child instance type is illegal. 网络子实例类型不正确。
500 InternalError Internal error. 内部报错。

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