華為云計(jì)算 云知識(shí) 更新網(wǎng)絡(luò)NeutronUpdateNetwork
更新網(wǎng)絡(luò)NeutronUpdateNetwork

 

功能介紹

更新網(wǎng)絡(luò)。

調(diào)試

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

URI

PUT /v2.0/networks/{network_id}

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

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

名稱

是否必選

說(shuō)明

network_id

網(wǎng)絡(luò)id

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

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

參數(shù)名稱

類型

必選

說(shuō)明

network

network object

network對(duì)象,參見(jiàn)表3。

更新操作時(shí)至少指定一項(xiàng)屬性

表3 network對(duì)象

屬性

是否必選

類型

說(shuō)明

name

String

網(wǎng)絡(luò)名稱。

【使用說(shuō)明】name不能為admin_external_net(預(yù)置網(wǎng)絡(luò)名稱,不可占用)。

admin_state_up

Boolean

管理狀態(tài)。

【使用說(shuō)明】只支持true。

port_security_enabled

Boolean

端口安全使能標(biāo)記,如果不能使,則network下所有虛機(jī)的安全組和dhcp防欺騙不生效

請(qǐng)求示例

更新id為c360322d-5315-45d7-b7d2-481f98c56edb的network,名稱更新為network-test02。

PUT https://{Endpoint}/v2.0/networks/c360322d-5315-45d7-b7d2-481f98c56edb

{
  "network": {
    "name": "network-test02"
  }
}

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

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

參數(shù)名稱

類型

說(shuō)明

network

network object

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

表5 network對(duì)象

屬性

類型

說(shuō)明

status

String

網(wǎng)絡(luò)狀態(tài),可以為ACTIVE,BUILD,DOWN或ERROR。

subnets

Array of strings

網(wǎng)絡(luò)關(guān)聯(lián)的子網(wǎng)ID列表。

一個(gè)network僅支持關(guān)聯(lián)一個(gè)subnet。

name

String

網(wǎng)絡(luò)名稱。

name不能為admin_external_net(預(yù)置網(wǎng)絡(luò)名稱,不可占用)。

router:external

Boolean

擴(kuò)展屬性:是否外部網(wǎng)絡(luò),默認(rèn)值false。

admin_state_up

Boolean

管理狀態(tài)。

只支持true。

tenant_id

String

項(xiàng)目ID

shared

Boolean

是否支持跨租戶共享。

id

String

網(wǎng)絡(luò)的id

【使用說(shuō)明】在查詢網(wǎng)絡(luò)列表時(shí)候非必選

provider:network_type

String

擴(kuò)展屬性:網(wǎng)絡(luò)類型(支持vxlan,geneve)。

租戶只能指定此參數(shù)為geneve,不指定時(shí)網(wǎng)路類型自動(dòng)分配,一般分配為vxlan類型。

availability_zone_hints

Array of strings

本網(wǎng)絡(luò)的候選可用域,當(dāng)前版本不支持可用域調(diào)度。

availability_zones

Array of strings

本網(wǎng)絡(luò)的可用域。

port_security_enabled

Boolean

端口安全使能標(biāo)記,如果不使能,則network下所有虛機(jī)的安全組和dhcp防欺騙不生效

dns_domain

String

默認(rèn)內(nèi)網(wǎng)DNS域地址,系統(tǒng)自動(dòng)生成維護(hù),不支持設(shè)置和更新

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

響應(yīng)示例

{
    "network": {
        "id": "c360322d-5315-45d7-b7d2-481f98c56edb",
        "name": "network-test02",
        "status": "ACTIVE",
        "shared": false,
        "subnets": [],
        "availability_zone_hints": [],
        "availability_zones": [
            "az2.dc2",
            "az5.dc5"
        ],
        "admin_state_up": true,
        "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
        "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
        "provider:network_type": "vxlan",
        "router:external": false,
        "port_security_enabled": true,
        "created_at": "2018-09-20T01:53:18",
        "updated_at": "2018-09-20T01:55:47"
    }
}

狀態(tài)碼

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

錯(cuò)誤碼

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