華為云計(jì)算 云知識(shí) 創(chuàng)建路由器NeutronCreateRouter
創(chuàng)建路由器NeutronCreateRouter

 

功能介紹

創(chuàng)建路由器。

調(diào)試

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

URI

POST /v2.0/routers

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

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

參數(shù)名稱

類型

是否必選

說(shuō)明

router

router object

router對(duì)象,參見(jiàn)表2。

表2 router對(duì)象

屬性

是否必選

類型

說(shuō)明

name

String

路由器的名稱。

【使用說(shuō)明】

僅支持?jǐn)?shù)字、字母、_(下劃線)、-(中劃線)、.(點(diǎn))。

admin_state_up

Boolean

管理狀態(tài)。

【取值范圍】

只支持true。

external_gateway_info

external_gateway_info object

擴(kuò)展屬性:外部網(wǎng)關(guān)信息,參見(jiàn)external_gateway_info對(duì)象

表3 external_gateway_info對(duì)象

屬性

是否必選

類型

說(shuō)明

network_id

String

外部網(wǎng)絡(luò)的UUID。

外部網(wǎng)絡(luò)的信息請(qǐng)通過(guò)GET /v2.0/networks?router:external=True或neutron net-external-list方式查詢。

請(qǐng)求示例

創(chuàng)建路由器,命名為router-test2。

POST https://{Endpoint}/v2.0/routers 

{
    "router": {
           "name": "router-test2",
           "admin_state_up": true
    }
}

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

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

參數(shù)名稱

類型

說(shuō)明

router

router object

router對(duì)象,參見(jiàn)表5

表5 router對(duì)象

屬性

類型

說(shuō)明

id

String

路由器的id

【使用說(shuō)明】在查詢路由器列表時(shí)非必選

name

String

路由器的名稱。

僅支持?jǐn)?shù)字、字母、_(下劃線)、-(中劃線)、.(點(diǎn))。

admin_state_up

Boolean

管理狀態(tài)。

只支持true。

status

String

狀態(tài),可以為ACTIVE, DOWN,ERROR。

tenant_id

String

項(xiàng)目ID

external_gateway_info

external_gateway_info object

擴(kuò)展屬性:外部網(wǎng)關(guān)信息,參見(jiàn)external_gateway_info對(duì)象

routes

Array of route objects

擴(kuò)展屬性:路由信息列表,參見(jiàn)routes對(duì)象

project_id

String

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

created_at

String

資源創(chuàng)建時(shí)間,UTC時(shí)間

格式:yyyy-MM-ddTHH:mm:ss

updated_at

String

資源更新時(shí)間,UTC時(shí)間

格式:yyyy-MM-ddTHH:mm:ss

表6 external_gateway_info對(duì)象

屬性

類型

說(shuō)明

network_id

String

外部網(wǎng)絡(luò)的UUID。

外部網(wǎng)絡(luò)的信息請(qǐng)通過(guò)GET /v2.0/networks?router:external=True或neutron net-external-list方式查詢。

enable_snat

Boolean

是否啟用SNAT。

默認(rèn)為false。

表7 route對(duì)象

屬性

類型

說(shuō)明

destination

String

IP地址段

nexthop

String

下一跳IP地址,nexthop僅支持是router所關(guān)聯(lián)的子網(wǎng)范圍內(nèi)IP地址

響應(yīng)示例

{
    "router": {
        "id": "f5dbdfe0-86f9-4b0a-9a32-6be143f0a076",
        "name": "router-test2",
        "status": "ACTIVE",
        "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
        "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
        "admin_state_up": true,
        "external_gateway_info": {
            "network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
            "enable_snat": false
        },
        "routes": [],
        "created_at": "2018-09-20T02:06:07",
        "updated_at": "2018-09-20T02:06:09"
    }
}

狀態(tài)碼

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

錯(cuò)誤碼

請(qǐng)參見(jiàn)錯(cuò)誤碼。