功能介紹
查詢提交請求的租戶的所有路由列表，并根據(jù)過濾條件進行過濾。分頁查詢響應格式請參考分頁查詢。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
GET /v2.0/vpc/routes
樣例：
樣例：
GET https://{Endpoint}/v2.0/vpc/routes?id={id}&vpc_id={vpc_id}&
tenant_id={tenant_id}&destination={destination}&type={type}&limit={limit}&marker={marker}
參數(shù)說明請參見表1。
|
名稱 |
是否必選 |
參數(shù)類型 |
說明 |
|---|---|---|---|
|
id |
否 |
String |
按照routes_id過濾查詢 |
|
tenant_id |
否 |
String |
按照tenant_id過濾查詢 |
|
vpc_id |
否 |
String |
按照vpc_id過濾查詢 |
|
destination |
否 |
String |
按照路由目的地址CIDR過濾查詢 |
|
type |
否 |
String |
按照type進行過濾查詢，目前只支持peering |
|
marker |
否 |
String |
分頁查詢的起始資源ID，表示從指定資源的下一條記錄開始查詢。 marker需要和limit配合使用：
|
|
limit |
否 |
Integer |
分頁查詢每頁返回的記錄個數(shù)，取值范圍為0~intmax（2^31-1），默認值2000。 limit需要和marker配合使用，詳細規(guī)則請見marker的參數(shù)說明。 默認值為2000。 |
請求參數(shù)
無
請求示例
GET https://{Endpoint}/v2.0/vpc/routes?vpc_id=ab78be2d-782f-42a5-aa72-35879f6890ff
響應參數(shù)
|
參數(shù)名稱 |
類型 |
說明 |
|---|---|---|
|
routes |
||
|
routes_links |
只有在使用limit過濾，并且資源個數(shù)超過limit或者資源個數(shù)超過2000時（limit默認值），該參數(shù)的rel和href取值才會顯示為next和其對應的link。 |
響應示例
{
"routes": [
{
"type": "peering",
"nexthop": "60c809cb-6731-45d0-ace8-3bf5626421a9",
"destination": "192.168.200.0/24",
"vpc_id": "ab78be2d-782f-42a5-aa72-35879f6890ff",
"tenant_id": "6fbe9263116a4b68818cf1edce16bc4f",
"id": "3d42a0d4-a980-4613-ae76-a2cddecff054"
}
]
}
狀態(tài)碼
請參見狀態(tài)碼。
錯誤碼
請參考錯誤碼。
