Skip to main content
Element Software
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

ModilyVirtualNetwork

Contributeurs

Vous pouvez utiliser le ModifyVirtualNetwork méthode permettant de modifier les attributs d'un réseau virtuel existant.

Cette méthode vous permet d'ajouter ou de supprimer des blocs d'adresse, de modifier le masque de réseau ou de modifier le nom ou la description du réseau virtuel. Vous pouvez également l'utiliser pour activer ou désactiver les espaces de noms, ainsi qu'ajouter ou supprimer une passerelle si les espaces de noms sont activés sur le réseau virtuel.

Remarque Cette méthode nécessite soit l'ID virtualNetworkTag soit la virtualNetworkTag comme paramètre, mais pas les deux.

AVERTISSEMENT :

L'activation ou la désactivation de la fonctionnalité VLAN de stockage routable pour un réseau virtuel existant en modifiant le paramètre d'espace de noms interrompt tout le trafic géré par le réseau virtuel. Il est préférable de modifier le paramètre d'espace de noms lors d'une fenêtre de maintenance planifiée.

Paramètres

Cette méthode présente les paramètres d'entrée suivants :

Nom

Description

Type

Valeur par défaut

Obligatoire

VirtualNetworkID

Identificateur unique du réseau virtuel à modifier. Il s'agit de l'ID réseau virtuel attribué par le cluster.

entier

Aucune

Non

VirtualNetworkTag

Balise réseau qui identifie le réseau virtuel à modifier.

entier

Aucune

Non

Verrous d'adresse

Le nouveau bloc d'adresses à définir pour ce réseau virtuel. Cela peut inclure de nouveaux blocs d'adresse à ajouter à l'objet existant ou ignorer les blocs d'adresse inutilisés qui doivent être supprimés. Vous pouvez également augmenter ou réduire la taille des blocs d'adresse existants. Vous pouvez uniquement augmenter la taille des verrous d'adresse de départ pour un objet réseau virtuel ; vous ne pouvez jamais le réduire. Membres requis pour cet objet :

  • Début : début de la plage d'adresses IP. (chaîne)

  • Taille : nombre d'adresses IP à inclure dans le bloc. (entier)

Objet JSON

Aucune

Non

passerelle

L'adresse IP d'une passerelle du réseau virtuel. Ce paramètre n'est valide que si le paramètre d'espace de noms est défini sur vrai.

chaîne

Aucune

Non

attributs

Liste des paires nom-valeur au format d'objet JSON.

Objet JSON

Aucune

Non

nom

Nouveau nom pour le réseau virtuel.

chaîne

Aucune

Non

espace de noms

Lorsque la valeur true est définie sur, active la fonctionnalité des VLAN de stockage routables en recréant le réseau virtuel et en configurant un espace de noms pour le contenir. Lorsqu'elle est définie sur FALSE, désactive la fonctionnalité VRF pour le réseau virtuel. La modification de cette valeur interrompt le trafic en cours d'exécution sur ce réseau virtuel.

booléen

Aucune

Non

masque de réseau

Nouveau masque de réseau pour ce réseau virtuel.

chaîne

Aucune

Non

vit

Adresse IP virtuelle de stockage pour ce réseau virtuel. Le SVIP d'un réseau virtuel ne peut pas être modifié. Vous devez créer un nouveau réseau virtuel pour utiliser une autre adresse SVIP.

chaîne

Aucune

Non

Valeurs de retour

Cette méthode n'a pas de valeurs de retour.

Exemple de demande

Les demandes pour cette méthode sont similaires à l'exemple suivant :

{
  "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
}

Exemple de réponse

Cette méthode renvoie une réponse similaire à l'exemple suivant :

{
  "id": 1,
  "result": {
  }
}

Nouveau depuis la version

9.6