Skip to main content
Element Software
Uma versão mais recente deste produto está disponível.
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

ModifyVirtualNetwork

Colaboradores
PDFs

Você pode usar o ModifyVirtualNetwork método para alterar os atributos de uma rede virtual existente.

Este método permite adicionar ou remover blocos de endereços, alterar a máscara de rede ou modificar o nome ou a descrição da rede virtual. Você também pode usá-lo para habilitar ou desabilitar namespaces, bem como adicionar ou remover um gateway se namespaces estiverem habilitados na rede virtual.

Observação Este método requer o virtualNetworkID ou o virtualNetworkTag como um parâmetro, mas não ambos.

CUIDADO:

Ativar ou desativar a funcionalidade de VLANs de armazenamento roteáveis para uma rede virtual existente, alterando o parâmetro namespace interrompe qualquer tráfego manipulado pela rede virtual. É melhor se você alterar o parâmetro namespace durante uma janela de manutenção programada.

Parâmetros

Este método tem os seguintes parâmetros de entrada:

Nome

Descrição

Tipo

Valor padrão

Obrigatório

VirtualNetworkID

Identificador exclusivo da rede virtual a modificar. Esta é a ID de rede virtual atribuída pelo cluster.

número inteiro

Nenhum

Não

VirtualNetworkTag

A etiqueta de rede que identifica a rede virtual a modificar.

número inteiro

Nenhum

Não

Destinatários Blocks

O novo bloco de endereços a definir para esta rede virtual. Isso pode incluir novos blocos de endereço para adicionar ao objeto existente ou omitir blocos de endereços não utilizados que precisam ser removidos. Como alternativa, você pode estender ou reduzir o tamanho dos blocos de endereços existentes. Você só pode aumentar o tamanho dos endereços iniciais bloqueios de um objeto de rede virtual; você nunca pode diminuí-lo. Membros necessários para este objeto:

  • Início: O início do intervalo de endereços IP. (string)

  • Tamanho: O número de endereços IP a incluir no bloco. (número inteiro)

Objeto JSON

Nenhum

Não

gateway

O endereço IP de um gateway da rede virtual. Este parâmetro é válido somente se o parâmetro namespace estiver definido como true.

cadeia de carateres

Nenhum

Não

atributos

Lista de pares nome-valor no formato de objeto JSON.

Objeto JSON

Nenhum

Não

nome

O novo nome para a rede virtual.

cadeia de carateres

Nenhum

Não

namespace

Quando definido como verdadeiro, ativa a funcionalidade de VLANs de armazenamento roteáveis recriando a rede virtual e configurando um namespace para contá-la. Quando definido como false, desativa a funcionalidade VRF para a rede virtual. A alteração desse valor interrompe o tráfego que está sendo executado por essa rede virtual.

booleano

Nenhum

Não

máscara de rede

Nova máscara de rede para esta rede virtual.

cadeia de carateres

Nenhum

Não

svip

O endereço IP virtual de armazenamento para esta rede virtual. O SVIP para uma rede virtual não pode ser alterado. Você deve criar uma nova rede virtual para usar um endereço SVIP diferente.

cadeia de carateres

Nenhum

Não

Valores de retorno

Este método não tem valores de retorno.

Exemplo de solicitação

As solicitações para este método são semelhantes ao seguinte exemplo:

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

Exemplo de resposta

Este método retorna uma resposta semelhante ao seguinte exemplo:

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

Novo desde a versão

9,6