Skip to main content
Element Software
12.7
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

ModifyVolumeAccessGroup

Colaboradores

Puede utilizar el ModifyVolumeAccessGroup método para actualizar los iniciadores y añadir o quitar volúmenes de un grupo de acceso de volúmenes.

Si un iniciador o volumen especificado es un duplicado de lo que existe actualmente, el grupo de acceso de volúmenes se deja como está. Si no especifica un valor para los volúmenes o los iniciadores, no se cambia la lista actual de iniciadores y volúmenes.

Parámetros

Este método tiene los siguientes parámetros de entrada:

Nombre

Descripción

Tipo

Valor predeterminado

Obligatorio

VolumeAccessGroupID

El ID del grupo de acceso de volúmenes que se desea modificar.

entero

Ninguno

nombre

El nuevo nombre de este grupo de acceso de volúmenes.

cadena

Ninguno

No

atributos

La lista de pares nombre-valor en el formato de objetos JSON.

Objeto JSON

Ninguno

No

iniciadores

Lista de ID o nombres de iniciador (IQN y WWPN) que se van a incluir en el grupo de acceso de volúmenes. Si pasa una lista de nombres de iniciador, se crean los iniciadores si no existen todavía. Si pasa una lista de ID de iniciador, el método devuelve un error si alguno de los iniciadores aún no existe. Pasar los nombres de iniciadores está obsoleto; debe usar ID de iniciador cuando sea posible.

matriz de enteros (recomendado) o matriz de cadenas (obsoleto)

Ninguno

No

DeleteOrphanInitiators

Especifica si se eliminarán los objetos iniciadores después de que se eliminen de un grupo de acceso de volúmenes o no. Los posibles valores son los siguientes:

  • True: Elimine los objetos iniciadores después de que se eliminen de un grupo de acceso de volúmenes.

  • False: No se eliminan los objetos del iniciador después de que se quitan de un grupo de acceso de volúmenes. Este es el valor predeterminado.

booleano

falso

No

volúmenes

Una lista de ID de volumen de los volúmenes que se van a modificar.

matriz en números enteros

Ninguno

Valor de retorno

Este método tiene el siguiente valor devuelto:

Nombre

Descripción

Tipo

VolumeAccessGroup

Un objeto que contiene información acerca del grupo de acceso de volúmenes recién modificado.

Ejemplo de solicitud

Las solicitudes de este método son similares al ejemplo siguiente:

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

Ejemplo de respuesta

Este método devuelve una respuesta similar al siguiente ejemplo:

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

Nuevo desde la versión

9.6