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.

ModifyVolumeAccessGroup

Colaboradores
PDFs

Você pode usar o ModifyVolumeAccessGroup método para atualizar iniciadores e adicionar ou remover volumes de um grupo de acesso de volume.

Se um iniciador ou volume especificado for uma cópia do que existe atualmente, o grupo de acesso ao volume é deixado como está. Se você não especificar um valor para volumes ou iniciadores, a lista atual de iniciadores e volumes não será alterada.

Parâmetros

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

Nome

Descrição

Tipo

Valor padrão

Obrigatório

VolumeAccessGroupID

A ID do grupo de acesso ao volume a modificar.

número inteiro

Nenhum

Sim

nome

O novo nome para este grupo de acesso ao volume.

cadeia de carateres

Nenhum

Não

atributos

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

Objeto JSON

Nenhum

Não

iniciadores

Lista de IDs ou nomes de iniciadores (IQNs e WWPNs) a incluir no grupo de acesso de volume. Se você passar uma lista de nomes de iniciadores, os iniciadores serão criados se eles ainda não existirem. Se você passar uma lista de IDs de iniciador, o método retornará um erro se algum dos iniciadores ainda não existir. Passar nomes de iniciador é obsoleto; você deve usar IDs de iniciador sempre que possível.

array inteiro (recomendado) ou array de cadeia de carateres (obsoleto)

Nenhum

Não

DeleteOrphanInitiators

Especifica se os objetos do iniciador devem ser excluídos após serem removidos de um grupo de acesso de volume ou não. Valores possíveis:

  • Verdadeiro: Excluir objetos do iniciador depois que eles são removidos de um grupo de acesso de volume.

  • Falso: Não exclua objetos do iniciador depois que forem removidos de um grupo de acesso de volume. Este é o padrão.

booleano

falso

Não

volumes

Uma lista de IDs de volume de volumes a modificar.

array inteiro

Nenhum

VolumeAccessGroup

Valor de retorno

Este método tem o seguinte valor de retorno:

Nome

Descrição

Tipo

VolumeAccessGroup

Um objeto contendo informações sobre o grupo de acesso de volume recém-modificado.

VolumeAccessGroup

Exemplo de solicitação

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

{
   "method": "ModifyVolumeAccessGroup",
   "params": {
      "volumeAccessGroupID": 96,
      "name": "accessgrouptest",
      "initiators": [115,114],
      "volumes": [
         346
    ],
      "attributes": {}
   }
}

Exemplo de resposta

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

{
  "id": null,
  "result": {
    "volumeAccessGroup": {
      "attributes": {},
      "deletedVolumes": [
        327
      ],
      "initiatorIDs": [
        114,
        115
      ],
      "initiators": [
        "iqn.1998-01.com.vmware:desk1-esx1-577b283a",
        "iqn.1998-01.com.vmware:donesq-esx1-421b281b"
      ],
      "name": "accessgrouptest",
      "volumeAccessGroupID": 96,
      "volumes": [
        346
      ]
    }
  }
}

Novo desde a versão

9,6

Encontre mais informações