華為云計算 云知識 查詢有效路由列表ListEffectiveRoutes
查詢有效路由列表ListEffectiveRoutes

 

功能介紹

查詢有效的路由列表,支持分頁查詢能力

調試

您可以在API Explorer中調試該接口,支持自動認證鑒權。API Explorer可以自動生成SDK代碼示例,并提供SDK代碼示例調試功能。

URI

GET /v3/{project_id}/enterprise-router/route-tables/{route_table_id}/routes

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項目ID

route_table_id

String

路由表ID

表2 Query參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

limit

Integer

每頁返回的個數(shù)。 取值范圍:0~2000。

最小值:0

最大值:2000

marker

String

上一頁最后一條記錄的路由id,為空時為查詢第一頁。 使用說明:必須與limit一起使用。

最小長度:1

最大長度:128

destination

Array

路由目的地址

resource_type

Array

請求參數(shù)

響應參數(shù)

狀態(tài)碼: 200

表3 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

routes

Array of EffectiveRoute objects

路由列表

request_id

String

請求ID

page_info

PageInfo object

分頁查詢的信息

表4 EffectiveRoute

參數(shù)

參數(shù)類型

描述

route_id

String

路由ID

destination

String

路由目的地

next_hops

Array of RouteAttachment objects

路由下一跳列表

is_blackhole

Boolean

是否黑洞路由

route_type

String

路由類型

表5 RouteAttachment

參數(shù)

參數(shù)類型

描述

resource_id

String

連接關聯(lián)的資源ID

resource_type

String

連接關聯(lián)的資源類型:

  • vpc:虛擬 私有云

  • vpn:vpn網(wǎng)關

  • vgw:云專線的虛擬網(wǎng)關

  • peering:對等連接,通過云連接CC加載不同區(qū)域的企業(yè)路由器來創(chuàng)建“對等連接(Peering)”連接

attachment_id

String

連接ID

表6 PageInfo

參數(shù)

參數(shù)類型

描述

next_marker

String

下一個marker標識,為空時表示最后一頁

current_count

Integer

當前列表中資源數(shù)量

請求示例

查詢有效路由列表

GET https://{erouter_endpoint}/v3/08d5a9564a704afda6039ae2babbef3c/enterprise-router/
route-tables/915a14a6-867b-4af7-83d1-70efceb146f9/routes

響應示例

狀態(tài)碼: 200

OK

{
  "routes" : [ {
    "route_id" : "9b3b38a9-1c9d-4f01-9429-81af6b545289",
    "destination" : "192.168.0.0/16",
    "next_hops" : [ {
      "resource_id" : "9c4ab06a-0ab4-4fad-93a8-f733f3a4433d",
      "resource_type" : "vpc",
      "attachment_id" : "9b3b38a9-1c9d-4f01-9429-81af6b545289"
    } ],
    "is_blackhole" : false,
    "route_type" : "static"
  } ],
  "page_info" : {
    "next_marker" : "1",
    "current_count" : 1
  },
  "request_id" : "915a14a6-867b-4af7-83d1-70efceb146f9"
}

狀態(tài)碼

狀態(tài)碼

描述

200

OK

錯誤碼

請參見錯誤碼。