ModifyVirtualNetwork
Änderungen vorschlagen
PDFs
Sie können die ModifyVirtualNetwork Methode zum Ändern der Attribute eines bestehenden virtuellen Netzwerks.
Mit dieser Methode können Sie Adressblöcke hinzufügen oder entfernen, die Netzmaske ändern oder den Namen oder die Beschreibung des virtuellen Netzwerks modifizieren. Sie können es auch verwenden, um Namensräume zu aktivieren oder zu deaktivieren sowie ein Gateway hinzuzufügen oder zu entfernen, wenn Namensräume im virtuellen Netzwerk aktiviert sind.
|
Diese Methode erfordert entweder die virtualNetworkID oder den virtualNetworkTag als Parameter, aber nicht beide. |
VORSICHT:
Das Aktivieren oder Deaktivieren der Funktionalität „Routbare Speicher-VLANs“ für ein bestehendes virtuelles Netzwerk durch Ändern des Namespace-Parameters unterbricht jeglichen Datenverkehr, der vom virtuellen Netzwerk verarbeitet wird. Am besten ändern Sie den Namespace-Parameter während eines geplanten Wartungsfensters.
Parameter
Diese Methode hat die folgenden Eingabeparameter:
Name |
Beschreibung |
Typ |
Standardwert |
Erforderlich |
virtuelle Netzwerk-ID |
Eindeutige Kennung des zu modifizierenden virtuellen Netzwerks. Dies ist die vom Cluster zugewiesene virtuelle Netzwerk-ID. |
ganze Zahl |
Keine |
Nein |
virtuelles Netzwerk-Tag |
Das Netzwerk-Tag, das das zu modifizierende virtuelle Netzwerk identifiziert. |
ganze Zahl |
Keine |
Nein |
Adressblöcke |
Der neue Adressblock, der für dieses virtuelle Netzwerk festgelegt werden soll. Dies kann das Hinzufügen neuer Adressblöcke zum bestehenden Objekt oder das Weglassen ungenutzter Adressblöcke, die entfernt werden müssen, beinhalten. Alternativ können Sie die Größe bestehender Adressblöcke erweitern oder verkleinern. Die Größe der anfänglichen addressBlocks eines Virtual Network-Objekts kann nur erhöht, aber niemals verringert werden. Erforderliche Elemente für dieses Objekt:
|
JSON-Objekt |
Keine |
Nein |
Tor |
Die IP-Adresse eines Gateways des virtuellen Netzwerks. Dieser Parameter ist nur gültig, wenn der Namespace-Parameter auf „true“ gesetzt ist. |
Schnur |
Keine |
Nein |
Attribute |
Liste von Name-Wert-Paaren im JSON-Objektformat. |
JSON-Objekt |
Keine |
Nein |
Name |
Der neue Name für das virtuelle Netzwerk. |
Schnur |
Keine |
Nein |
Namensraum |
Wenn auf „true“ gesetzt, wird die Funktionalität der routbaren Speicher-VLANs aktiviert, indem das virtuelle Netzwerk neu erstellt und ein Namespace konfiguriert wird, der es enthält. Wenn auf „false“ gesetzt, wird die VRF-Funktionalität für das virtuelle Netzwerk deaktiviert. Eine Änderung dieses Wertes unterbricht den Datenverkehr in diesem virtuellen Netzwerk. |
boolescher Wert |
Keine |
Nein |
Netzmaske |
Neue Netzwerkmaske für dieses virtuelle Netzwerk. |
Schnur |
Keine |
Nein |
VIP |
Die virtuelle Speicher-IP-Adresse für dieses virtuelle Netzwerk. Der SVIP für ein virtuelles Netzwerk kann nicht geändert werden. Sie müssen ein neues virtuelles Netzwerk erstellen, um eine andere SVIP-Adresse zu verwenden. |
Schnur |
Keine |
Nein |
Rückgabewerte
Diese Methode hat keinen Rückgabewert.
Anforderungsbeispiel
Anfragen für diese Methode ähneln dem folgenden Beispiel:
{
"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
}
Antwortbeispiel
Diese Methode liefert eine Antwort, die dem folgenden Beispiel ähnelt:
{
"id": 1,
"result": {
}
}
Neu seit Version
9,6