華為云計(jì)算 云知識(shí) 查詢路由表列表ListRouteTables
查詢路由表列表ListRouteTables

 

功能介紹

查詢提交請(qǐng)求的帳戶的所有路由表列表,并根據(jù)過(guò)濾條件進(jìn)行過(guò)濾。

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

GET /v1/{project_id}/routetables

樣例:

GET https://{Endpoint}/v1/{project_id}/routetables?limit=10&marker=4779ab1c-7c1a-44b1-a02e-93dfc361b32d&
vpc_id=3ec3b33f-ac1c-4630-ad1c-7dba1ed79d85&subnet_id=9873b33f-ac1c-4630-ad1c-7dba1ed79r78

參數(shù)說(shuō)明請(qǐng)參見(jiàn)表1。

表1 參數(shù)說(shuō)明

名稱

是否必選

參數(shù)類型

說(shuō)明

project_id

String

項(xiàng)目ID,請(qǐng)參見(jiàn)獲取項(xiàng)目ID。

limit

Integer

分頁(yè)查詢每頁(yè)返回的記錄個(gè)數(shù),取值范圍為0~intmax(2^31-1),默認(rèn)值2000。

limit需要和marker配合使用,詳細(xì)規(guī)則請(qǐng)見(jiàn)marker的參數(shù)說(shuō)明。

marker

String

分頁(yè)查詢的起始資源ID,表示從指定資源的下一條記錄開(kāi)始查詢。

marker需要和limit配合使用:

  • 若不傳入marker和limit參數(shù),查詢結(jié)果返回第一頁(yè)全部資源記錄。
  • 若不傳入marker參數(shù),limit為10,查詢結(jié)果返回第1~10條資源記錄。
  • 若marker為第10條記錄的資源ID,limit為10,查詢結(jié)果返回第11~20條資源記錄。
  • 若marker為第10條記錄的資源ID,不傳入limit參數(shù),查詢結(jié)果返回第11條及之后的所有資源記錄。

id

String

路由表ID,可過(guò)濾對(duì)應(yīng)ID的路由表

vpc_id

String

VPC的UUID

subnet_id

String

子網(wǎng)的UUID

如果您使用管理控制臺(tái),此值即為子網(wǎng)詳情中的“網(wǎng)絡(luò)ID”參數(shù)值。

請(qǐng)求參數(shù)

無(wú)

請(qǐng)求示例

GET https://{Endpoint}/v1/{project_id}/routetables?limit=10&marker=4779ab1c-7c1a-44b1-a02e-93dfc361b32d&
vpc_id=3ec3b33f-ac1c-4630-ad1c-7dba1ed79d85&subnet_id=9873b33f-ac1c-4630-ad1c-7dba1ed79r78

響應(yīng)參數(shù)

表2 響應(yīng)參數(shù)

名稱

參數(shù)類型

說(shuō)明

routetables

Array of routetable objects

路由表列表對(duì)象,參見(jiàn)表3。

表3 routetable字段說(shuō)明

名稱

參數(shù)類型

說(shuō)明

id

String

  • 功能說(shuō)明:路由表唯一標(biāo)識(shí)
  • 取值范圍:標(biāo)準(zhǔn)UUID

name

String

  • 功能說(shuō)明:路由表名稱
  • 取值范圍:0-64個(gè)字符,支持?jǐn)?shù)字、字母、中文、_(下劃線)、-(中劃線)、.(點(diǎn))

default

Boolean

  • 功能說(shuō)明:是否為默認(rèn)路由表
  • 取值范圍:true表示默認(rèn)路由表;false表示自定義路由表

subnets

Array of subnet objects

  • 功能說(shuō)明:路由表所關(guān)聯(lián)的子網(wǎng),參見(jiàn)表4
  • 約束:只能關(guān)聯(lián)路由表所屬VPC下的子網(wǎng)

tenant_id

String

  • 功能說(shuō)明:項(xiàng)目ID

vpc_id

String

  • 功能說(shuō)明:路由表所屬VPC的ID

description

String

  • 路由表的描述信息
  • 取值范圍:0-255個(gè)字符,不能包含“<”和“>”

created_at

String

  • 功能說(shuō)明:資源創(chuàng)建時(shí)間,UTC時(shí)間
  • 格式:yyyy-MM-ddTHH:mm:ss

updated_at

String

  • 功能說(shuō)明:資源更新時(shí)間,UTC時(shí)間
  • 格式:yyyy-MM-ddTHH:mm:ss
表4 subnet字段說(shuō)明

名稱

參數(shù)類型

說(shuō)明

id

String

路由表關(guān)聯(lián)的子網(wǎng)ID

響應(yīng)示例

{
    "routetables": [
        {
            "id": "3d42a0d4-a980-4613-ae76-a2cddecff054",
            "name": "routetable-1234",
            "vpc_id": "ab78be2d-782f-42a5-aa72-35879f6890ff",
            "subnets": [
                {
                    "id": "8d4ce32f-d68a-4c4c-9f18-c68d8a5c7f2f"
                }
            ],
            "tenant_id": "6fbe9263116a4b68818cf1edce16bc4f",
            "description": "abc",
            "created_at": "2022-12-15T02:56:40",
            "updated_at": "2022-12-15T02:56:40"
        },
        {
            "id": "3d42a0d4-a980-4613-ae76-a2cddecfff89",
            "name": "routetable-5678",
            "vpc_id": "ab78be2d-782f-42a5-aa72-35879f667809",
            "subnets": [
                {
                    "id": "8d4ce32f-d68a-4c4c-9f18-c68d8a5c7f2f"
                }
            ],
            "tenant_id": "6fbe9263116a4b68818cf1edce16bc4f",
            "description": "abc",
            "created_at": "2022-12-15T02:59:03",
            "updated_at": "2022-12-15T02:59:03"
        }
    ]
}

狀態(tài)碼

請(qǐng)參見(jiàn)狀態(tài)碼。

錯(cuò)誤碼

請(qǐng)參考錯(cuò)誤碼。