调用DescribeCenChildInstanceRouteEntries接口查询云企业网中网络实例的路由条目信息。

调试

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

请求参数

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

系统规定参数。取值:DescribeCenChildInstanceRouteEntries

CenId String cen-7qthudw0ll6jmc****

云企业网实例ID。

ChildInstanceId String vpc-bp18sth14qii3pnvo****

网络实例ID。

ChildInstanceType String VPC

网络实例的类型。取值:

  • VPC:专有网络实例。
  • VBR:边界路由器实例。
  • CCN:云连接网实例。
Status String Active

路由条目的状态。取值:

  • Active:可用。
  • Candidate:备份。
  • Rejected:拒绝。
  • Prohibited:禁止。
  • All(默认值):表示查询网络实例下所有状态的路由条目信息。
PageNumber Integer 1

查询页码。默认值为1

PageSize Integer 10

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

ChildInstanceRegionId String cn-hangzhou

网络实例所在的地域ID。

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

返回数据

名称 类型 示例值 描述
PageSize Integer 10

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

RequestId String 17A57456-EF48-419D-9AE6-9B03D9996018

请求ID。

PageNumber Integer 1

查询页码。

TotalCount Integer 4

总条目数。

CenRouteEntries Array of CenRouteEntry

路由条目信息。

CenRouteEntry
Status String Active

路由条目的状态。取值:

  • Active:可用。
  • Candidate:备份。
  • Rejected:拒绝。
  • Prohibited:禁止。
Type String CEN

路由条目的类型。取值:

  • CEN:表示通过云企业网传递的路由。
  • System:表示系统路由。
  • Custom:表示自定义路由。
PublishStatus String Published

路由条目在云企业网中的发布状态。取值:

  • Published:已发布。
  • NonPublished:未发布。
NextHopType String VBR

路由条目下一跳类型。取值:

  • 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:不允许发布或撤销。
NextHopRegionId String cn-hangzhou

路由条目下一跳关联的实例所属的地域ID。

NextHopInstanceId String vbr-bp13gtbhdp0pfqg6s****

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

DestinationCidrBlock String 10.0.0.0/24

路由条目的目标网段。

RouteTableId String vtb-bp1r9pvl4xen8s9ju****

路由表ID。

CenRouteMapRecords Array of CenRouteMapRecord

路由条目匹配到的路由策略信息。

CenRouteMapRecord
RouteMapId String cenrmap-w4yf7toozfol3q****

路由策略ID。

RegionId String cn-hangzhou

路由策略应用的地域ID。

Conflicts Array of Conflict

产生冲突的路由条目信息。

Conflict
Status String conflict

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

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

产生冲突的路由条目的目标网段。

InstanceId String ccn-0q3b7oviikmm9h****

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

InstanceType String CCN

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

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

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

Communities Array of String 65501:1

路由条目的Community属性值。

AsPaths Array of String 65501

路由条目的AS Path属性值。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeCenChildInstanceRouteEntries
&CenId=cen-7qthudw0ll6jmc****
&ChildInstanceId=vpc-bp18sth14qii3pnvo****
&ChildInstanceType=VPC
&Status=Active
&PageNumber=1
&PageSize=10
&ChildInstanceRegionId=cn-hangzhou
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeCenChildInstanceRouteEntriesResponse>
    <PageSize>10</PageSize>
    <RequestId>17A57456-EF48-419D-9AE6-9B03D9996018</RequestId>
    <PageNumber>1</PageNumber>
    <TotalCount>4</TotalCount>
    <CenRouteEntries>
        <Status>Active</Status>
        <Type>CEN</Type>
        <PublishStatus>Published</PublishStatus>
        <NextHopType>VBR</NextHopType>
        <OperationalMode>true</OperationalMode>
        <NextHopRegionId>cn-hangzhou</NextHopRegionId>
        <NextHopInstanceId>vbr-bp13gtbhdp0pfqg6s****</NextHopInstanceId>
        <DestinationCidrBlock>10.0.0.0/24</DestinationCidrBlock>
        <RouteTableId>vtb-bp1r9pvl4xen8s9ju****</RouteTableId>
        <CenRouteMapRecords>
            <RouteMapId>cenrmap-w4yf7toozfol3q****</RouteMapId>
            <RegionId>cn-hangzhou</RegionId>
        </CenRouteMapRecords>
        <Conflicts>
            <Status>conflict</Status>
            <DestinationCidrBlock>192.168.1.0/24</DestinationCidrBlock>
            <InstanceId>ccn-0q3b7oviikmm9h****</InstanceId>
            <InstanceType>CCN</InstanceType>
            <RegionId>ccn-cn-shanghai</RegionId>
        </Conflicts>
        <Communities>65501:1</Communities>
        <AsPaths>65501</AsPaths>
    </CenRouteEntries>
</DescribeCenChildInstanceRouteEntriesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "PageSize" : 10,
  "RequestId" : "17A57456-EF48-419D-9AE6-9B03D9996018",
  "PageNumber" : 1,
  "TotalCount" : 4,
  "CenRouteEntries" : [ {
    "Status" : "Active",
    "Type" : "CEN",
    "PublishStatus" : "Published",
    "NextHopType" : "VBR",
    "OperationalMode" : true,
    "NextHopRegionId" : "cn-hangzhou",
    "NextHopInstanceId" : "vbr-bp13gtbhdp0pfqg6s****",
    "DestinationCidrBlock" : "10.0.0.0/24",
    "RouteTableId" : "vtb-bp1r9pvl4xen8s9ju****",
    "CenRouteMapRecords" : [ {
      "RouteMapId" : "cenrmap-w4yf7toozfol3q****",
      "RegionId" : "cn-hangzhou"
    } ],
    "Conflicts" : [ {
      "Status" : "conflict",
      "DestinationCidrBlock" : "192.168.1.0/24",
      "InstanceId" : "ccn-0q3b7oviikmm9h****",
      "InstanceType" : "CCN",
      "RegionId" : "ccn-cn-shanghai"
    } ],
    "Communities" : [ "65501:1" ],
    "AsPaths" : [ "65501" ]
  } ]
}

错误码

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