O artigo solicitado não está disponível. Ou ele não se aplica a esta versão do produto ou as informações relevantes estão organizadas de forma diferente nesta versão dos documentos. Você pode pesquisar, navegar ou voltar para a outra versão.

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.

CriarGrupoDeAcessoAoVolume

11/12/2025 Colaboradores

PDFs

Você pode usar CreateVolumeAccessGroup Para criar um novo grupo de acesso a volumes. Ao criar o grupo de acesso ao volume, você precisa dar um nome a ele e, opcionalmente, pode inserir iniciadores e volumes.

Qualquer IQN de iniciador que você adicionar ao grupo de acesso ao volume poderá acessar qualquer volume no grupo sem autenticação CHAP.

Os volumes clonados não herdam a associação ao grupo de acesso ao volume do volume de origem.

Ao criar grupos de acesso por volume, considere o seguinte:

Um grupo de acesso por volume pode conter até 64 IQNs de iniciadores.
Um iniciador só pode pertencer a um grupo de acesso a volumes.
Um grupo de acesso a volumes pode conter até 2000 volumes.
Cada grupo de acesso a volume pode pertencer a, no máximo, quatro grupos de acesso a volume.

Parâmetros

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

Nome	Descrição	Tipo	Valor padrão	Obrigatório
iniciadores	Lista de IDs ou nomes de iniciadores (IQNs e WWPNs) a serem incluídos no grupo de acesso ao volume. Se você passar uma lista de nomes de iniciadores, os iniciadores serão criados caso ainda não existam. Se você passar uma lista de IDs de iniciadores, o método retornará um erro caso algum dos iniciadores ainda não exista. Passar nomes de iniciadores está obsoleto; você deve usar IDs de iniciadores sempre que possível.	matriz de inteiros ou matriz de strings (obsoleto)		Não
nome	Nome do grupo de acesso ao volume. Não precisa ser original, mas é recomendável. Deve ter entre 1 e 64 caracteres.	corda	Nenhum	Sim
volumes	Lista de IDs de volume a serem incluídos no grupo de acesso ao volume.	matriz de inteiros		Não
atributos	Lista de pares nome-valor em formato de objeto JSON.	objeto JSON	{}	Não

Nome

Descrição

Tipo

Valor padrão

Obrigatório

iniciadores

Lista de IDs ou nomes de iniciadores (IQNs e WWPNs) a serem incluídos no grupo de acesso ao volume. Se você passar uma lista de nomes de iniciadores, os iniciadores serão criados caso ainda não existam. Se você passar uma lista de IDs de iniciadores, o método retornará um erro caso algum dos iniciadores ainda não exista. Passar nomes de iniciadores está obsoleto; você deve usar IDs de iniciadores sempre que possível.

matriz de inteiros ou matriz de strings (obsoleto)

Não

nome

Nome do grupo de acesso ao volume. Não precisa ser original, mas é recomendável. Deve ter entre 1 e 64 caracteres.

corda

Nenhum

Sim

volumes

Lista de IDs de volume a serem incluídos no grupo de acesso ao volume.

matriz de inteiros

Não

atributos

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

objeto JSON

{}

Não

Valores de retorno

Este método tem os seguintes valores de retorno:

Nome

Descrição

Tipo

grupoDeAcessoDeVolume

Um objeto contendo informações sobre o grupo de acesso a volumes recém-criado.

grupoDeAcessoDeVolume

ID do grupo de acesso ao volume

O ID do grupo de acesso ao volume recém-criado.

inteiro

Exemplo de solicitação

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

{
   "method": "CreateVolumeAccessGroup",
   "params": {
      "name": "myaccessgroup",
      "initiators": ["iqn.1993-08.org.debian: 01: a31b1d799d5c"],
      "volumes": [327],
      "attributes": {}
   }
}

Exemplo de resposta

Este método retorna uma resposta semelhante ao exemplo a seguir:

{
  "id": null,
  "result": {
    "volumeAccessGroup": {
      "attributes": {},
      "deletedVolumes": [],
      "initiatorIDs": [
        95
      ],
      "initiators": [
        "iqn.1993-08.org.debian: 01: a31b1d799d5c"
      ],
      "name": "myaccessgroup",
      "volumeAccessGroupID": 96,
      "volumes": [
        327
      ]
    },
    "volumeAccessGroupID": 96
  }
}

Novidade desde a versão

9,6