全部产品
Search

搜索本产品

    云企业网：DescribeCenChildInstanceRouteEntries - 查询云企业网的网络实例路由条目

    文档中心

    云企业网：DescribeCenChildInstanceRouteEntries - 查询云企业网的网络实例路由条目

    更新时间：Nov 11, 2024

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

    调试

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

    授权信息

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

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

    请求参数

    名称类型必填描述示例值
    CenIdstring是

    云企业网实例 ID。

    		cen-7qthudw0ll6jmc****
    ChildInstanceIdstring是

    网络实例 ID。

    		vpc-bp18sth14qii3pnvo****
    ChildInstanceTypestring是

    网络实例的类型。取值：

    • VPC：专有网络实例。

    • VBR：边界路由器实例。

    • CCN：云连接网实例。

    • ECR：专线网关实例。

    		VPC
    Statusstring否

    路由条目的状态。取值：

    • Active：可用。

    • Candidate：备份。

    • Rejected：拒绝。

    • Prohibited：禁止。

    • All（默认值）：表示查询网络实例下所有状态的路由条目信息。

    		Active
    PageNumberinteger否

    查询页码。默认值为 1。

    		1
    PageSizeinteger否

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

    		10
    ChildInstanceRegionIdstring是

    网络实例所在的地域 ID。

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

    		cn-hangzhou
    ChildInstanceRouteTableIdstring否

    网络实例的路由表 ID。 在您查询 VPC 实例路由表下的路由条目信息时，如果您不指定路由表 ID，系统默认查询 VPC 实例系统路由表下的路由条目信息。

    		vtb-p0wxx3apzgn6uqp3r****

    返回参数

    名称类型描述示例值
    object
    PageSizeinteger

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

    		10
    RequestIdstring

    请求 ID。

    		17A57456-EF48-419D-9AE6-9B03D9996018
    PageNumberinteger

    查询页码。

    		1
    TotalCountinteger

    总条目数。

    		4
    CenRouteEntriesarray<object>

    路由条目信息。

    CenRouteEntryobject
    Statusstring

    路由条目的状态。取值：

    • Active：可用。

    • Candidate：备份。

    • Rejected：拒绝。

    • Prohibited：禁止。

    		Active
    Typestring

    路由条目的类型。取值：

    • CEN：表示通过云企业网传递的路由。
    • System：表示系统路由。
    • Custom：表示自定义路由。
    		CEN
    PublishStatusstring

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

    • Published：已发布。

    • NonPublished：未发布。

    		Published
    NextHopTypestring

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

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

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

    • true：允许发布或撤销。

    • false：不允许发布或撤销。

    		true
    NextHopRegionIdstring

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

    		cn-hangzhou
    NextHopInstanceIdstring

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

    		vbr-bp13gtbhdp0pfqg6s****
    DestinationCidrBlockstring

    路由条目的目标网段。

    		10.0.0.0/24
    RouteTableIdstring

    路由表 ID。

    		vtb-bp1r9pvl4xen8s9ju****
    CenRouteMapRecordsarray<object>

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

    CenRouteMapRecordobject
    RouteMapIdstring

    路由策略 ID。

    		cenrmap-w4yf7toozfol3q****
    RegionIdstring

    路由策略应用的地域 ID。

    		cn-hangzhou
    Conflictsarray<object>

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

    Conflictobject
    Statusstring

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

    • conflict：路由条目的目标网段相同造成的冲突。

    • overflow：其他网络实例路由表的路由条目数量超出限制造成的冲突。

    		conflict
    DestinationCidrBlockstring

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

    		192.168.1.0/24
    InstanceIdstring

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

    		ccn-0q3b7oviikmm9h****
    InstanceTypestring

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

    • VPC：专有网络。
    • VBR：边界路由器。
    • CCN：云连接网。
    • ECR：专线网关。
    		CCN
    RegionIdstring

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

    		ccn-cn-shanghai
    Communitiesarray

    路由条目的 Community 属性值列表。

    Communitystring

    路由条目的 Community 属性值。

    		65501:1
    AsPathsarray

    路由条目的 AS Path 属性值列表。

    AsPathstring

    路由条目的 AS Path 属性值。

    		65501

    示例

    正常返回示例

    JSON格式

    {
  "PageSize": 10,
  "RequestId": "17A57456-EF48-419D-9AE6-9B03D9996018",
  "PageNumber": 1,
  "TotalCount": 4,
  "CenRouteEntries": {
    "CenRouteEntry": [
      {
        "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": {
          "CenRouteMapRecord": [
            {
              "RouteMapId": "cenrmap-w4yf7toozfol3q****",
              "RegionId": "cn-hangzhou"
            }
          ]
        },
        "Conflicts": {
          "Conflict": [
            {
              "Status": "conflict",
              "DestinationCidrBlock": "192.168.1.0/24",
              "InstanceId": "ccn-0q3b7oviikmm9h****",
              "InstanceType": "CCN",
              "RegionId": "ccn-cn-shanghai"
            }
          ]
        },
        "Communities": {
          "Community": [
            "65501:1"
          ]
        },
        "AsPaths": {
          "AsPath": [
            "65501"
          ]
        }
      }
    ]
  }
}

    错误码

    HTTP status code错误码错误信息描述
    400InvalidParameterInvalid parameter.参数不合法。
    400UnauthorizedThe AccessKeyId is unauthorized.账号无权限操作。
    404InvalidRouteTableId.NotFoundThe specified RouteTableId is not found.RouteTableId不存在。

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

    变更历史

    变更时间变更内容概要操作
    2024-10-25OpenAPI 错误码发生变更查看变更详情
    2023-12-26OpenAPI 描述信息更新、OpenAPI 错误码发生变更查看变更详情