ModifyVirtualNetwork
建議變更
PDF
您可以使用此 `ModifyVirtualNetwork`方法變更現有虛擬網路的屬性。
此方法可讓您新增或移除位址區塊、變更網路遮罩、或修改虛擬網路的名稱或說明。您也可以使用它來啟用或停用命名空間、以及在虛擬網路上啟用命名空間時新增或移除閘道。
|
此方法需要虛擬網路ID或虛擬網路標籤做為參數、但不能同時做為參數。 |
注意：
變更命名空間參數、為現有虛擬網路啟用或停用可路由的儲存VLAN功能、會中斷虛擬網路處理的任何流量。最好是在排程的維護期間變更命名空間參數。
參數
此方法具有下列輸入參數：
名稱 |
說明 |
類型 |
預設值 |
必要 |
虛擬網路ID |
要修改之虛擬網路的唯一識別碼。這是叢集指派的虛擬網路ID。 |
整數 |
無 |
否 |
虛擬化網路標籤 |
識別要修改之虛擬網路的網路標籤。 |
整數 |
無 |
否 |
定址鎖定 |
為此虛擬網路設定的新位址區塊。這可能包括新的位址區塊、以新增至現有物件、或省略需要移除的未使用位址區塊。或者、您也可以擴充或縮小現有位址區塊的大小。您只能增加虛擬網路物件的起始定址鎖定大小、永遠無法減少。此物件的必要成員：
|
Json物件 |
無 |
否 |
閘道 |
虛擬網路閘道的IP位址。此參數僅在命名空間參數設定為true時有效。 |
字串 |
無 |
否 |
屬性 |
Json物件格式的名稱-值配對清單。 |
Json物件 |
無 |
否 |
名稱 |
虛擬網路的新名稱。 |
字串 |
無 |
否 |
命名空間 |
設為true時、可重新建立虛擬網路並設定命名空間以容納該虛擬網路、藉此啟用可路由的儲存VLAN功能。設為假時、會停用虛擬網路的VRF功能。變更此值會中斷流經此虛擬網路的流量。 |
布林值 |
無 |
否 |
網路遮罩 |
此虛擬網路的新網路遮罩。 |
字串 |
無 |
否 |
服務 |
此虛擬網路的儲存虛擬IP位址。無法變更虛擬網路的SVIP。您必須建立新的虛擬網路、才能使用不同的SVIP位址。 |
字串 |
無 |
否 |
傳回值
此方法沒有傳回值。
申請範例
此方法的要求類似於下列範例：
{
"method": "ModifyVirtualNetwork",
"params": {
"virtualNetworkID": 2,
"name": "ESX-VLAN-3112",
"addressBlocks": [
{
"start": "10.1.112.1",
"size": 20
},
{
"start": "10.1.112.100",
"size": 20
}
],
"netmask": "255.255.255.0",
"gateway": "10.0.1.254",
"svip": "10.1.112.200",
"attributes": {}
},
"id":1
}
回應範例
此方法會傳回類似下列範例的回應：
{
"id": 1,
"result": {
}
}
新的自版本
9.6