
調(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"
}
}
