CreateVolumeAccessGroup
Sugerir cambios
PDF
Puede utilizar CreateVolumeAccessGroup para crear un nuevo grupo de acceso de volúmenes. Al crear el grupo de acceso de volúmenes, es necesario asignarle un nombre y de manera opcional se pueden introducir iniciadores y volúmenes.
Cualquier IQN de iniciador que se añade al grupo de acceso de volúmenes puede acceder a cualquier volumen del grupo sin autenticación CHAP.
|
Los volúmenes clonados no heredan pertenencia al grupo de acceso de volúmenes en el volumen de origen. |
Tenga en cuenta lo siguiente al crear grupos de acceso de volúmenes:
-
Un grupo de acceso de volúmenes puede contener hasta 64 IQN de iniciador.
-
Un iniciador solo puede pertenecer a un grupo de acceso de volúmenes.
-
Un grupo de acceso de volúmenes puede contener hasta 2000 volúmenes.
-
Cada grupo de acceso de volúmenes puede pertenecer a un máximo de cuatro grupos de acceso de volúmenes.
Parámetros
Este método tiene los siguientes parámetros de entrada:
| Nombre | Descripción | Tipo | Valor predeterminado | Obligatorio |
|---|---|---|---|---|
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 o matriz de cadenas (obsoleto) |
No |
|
nombre |
El nombre del grupo de acceso de volúmenes. No es necesario ser único, pero se recomienda. Debe tener entre 1 y 64 caracteres de longitud. |
cadena |
Ninguno |
Sí |
volúmenes |
Lista de ID de volumen que se incluirán en el grupo de acceso de volúmenes. |
matriz en números enteros |
No |
|
atributos |
La lista de pares nombre-valor en el formato de objetos JSON. |
Objeto JSON |
{} |
No |
Valores devueltos
Este método tiene los siguientes valores devueltos:
Nombre |
Descripción |
Tipo |
VolumeAccessGroup |
Un objeto que contiene información acerca del grupo de acceso de volúmenes recién creado. |
|
VolumeAccessGroupID |
El ID del grupo de acceso de volúmenes recién creado. |
entero |
Ejemplo de solicitud
Las solicitudes de este método son similares al ejemplo siguiente:
{
"method": "CreateVolumeAccessGroup",
"params": {
"name": "myaccessgroup",
"initiators": ["iqn.1993-08.org.debian: 01: a31b1d799d5c"],
"volumes": [327],
"attributes": {}
}
}
Ejemplo de respuesta
Este método devuelve una respuesta similar al siguiente ejemplo:
{
"id": null,
"result": {
"volumeAccessGroup": {
"attributes": {},
"deletedVolumes": [],
"initiatorIDs": [
95
],
"initiators": [
"iqn.1993-08.org.debian: 01: a31b1d799d5c"
],
"name": "myaccessgroup",
"volumeAccessGroupID": 96,
"volumes": [
327
]
},
"volumeAccessGroupID": 96
}
}
Nuevo desde la versión
9.6