ModifyVolumeAccessGroup
Sugerir cambios
PDF
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 |
Sí |
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:
|
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