Grupos de iniciadores

Idioma:

Los comandos del iniciador iSCSI se utilizan para gestionar los iniciadores iSCSI y los grupos iniciadores iSCSI en un dispositivo. Los comandos disponibles se detallan en la tabla de abajo.

Estos comandos usan los siguientes parámetros del URI:

protocol: El protocolo NAS para el iniciador: fc, iscsi o srp
name: El nombre del grupo de iniciadores.

Cada grupo de iniciadores tiene una propiedad name y una propiedad initiators que contiene una lista de iniciadores en el grupo de iniciadores.

Tabla 34 Comandos de grupo de iniciadores

Solicitud	Anexar a la ruta de acceso /san/v{1\|2}	Descripción
GET	/`protocol`/initiator-groups	Detallar todos los grupos de iniciadores SAN para los objetos del protocolo determinados: `fc`, `iscsi`, `srp`
GET	/`protocol`/initiator-groups/`name`	Obtener el grupo de iniciadores SAN especificado para las propiedades del protocolo determinadas: `fc`, `iscsi`, `srp`
POST	/`protocol`/initiator-groups	Crear un nuevo grupo de iniciadores SAN especificado para el protocolo determinado: `fc`, `iscsi`, `srp`
PUT	/`protocol`/initiator-groups/`name`	Modificar el grupo de iniciadores SAN especificado para el objeto del protocolo determinado: `fc`, `iscsi`, `srp`
DELETE	/`protocol`/initiator-groups/`name`	Destruir el nombre del objeto especificado.

Enumerar grupos de iniciadores

Mostrar todos los grupos iniciadores iSCSI disponibles. Cuando esto es correcto, se devuelve HTTP Status 200 (OK) (estado HTTP 200 [correcto]) y el cuerpo contiene un objeto JSON con una propiedad denominada "groups" que contiene una matriz de objetos de grupo de iniciadores.

Ejemplo de solicitud:

GET /api/san/v1/iscsi/initiator-groups HTTP/1.1
Host: zfs-storage.example.com:215
Accept: application/json

Resultado de ejemplo:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "groups": [{
        "href": "/san/v1/iscsi/initiator-groups/p1-initiators-0",
        "initiators": ["iqn.zfs-storage.example.com.sun:0"],
        "name": "p1-initiators-0"
    }, {
        "href": "/san/v1/iscsi/initiator-groups/p1-initiators-1",
        "initiators": ["iqn.zfs-storage.example.com.sun:1"],
        "name": "p1-initiators-1"
    }]
}

Obtener detalles del grupo de iniciadores

Obtiene información detallada de un solo grupo de iniciadores iSCSI. Se puede acceder al grupo siguiendo la propiedad href que se devuelve en el comando List initiator group command.

Ejemplo de solicitud:

GET /api/san/v1/iscsi/initiator-groups/test-group HTTP/1.1
Host: zfs-storage.example.com:215
Accept: application/json

Resultado de ejemplo:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "group": {
        "href": "/api/san/v1/iscsi/initiator-groups/test-group"
        "initiators": ["iqn.zfs-storage.example.com.sun:02:01"],
        "name": "test-group"
    }
}

Crear un grupo de iniciadores

Crea un grupo de iniciadores iSCSI sin miembros. El cuerpo de la solicitud contiene un objeto JSON con un solo parámetro name que contiene el nombre del grupo.

Tabla 35 Propiedades de creación del grupo de iniciadores

Propiedad	Tipo	Descripción
`name`	string	El nombre del grupo de iniciadores.
`initiators`	array	Una matriz de propiedades IQN de un iniciador existente.

Ejemplo de solicitud:

POST /api/san/v1/iscsi/initiator-groups HTTP/1.1
Host: zfs-storage.example.com:215
Content-Type: application/json
Content-Length: 64
Accept: application/json

{
   "name":"group-01",
   "initiators": ["iqn.zfs-storage.example.com.sun:02"]
}

Resultado de ejemplo:

HTTP/1.1 201 Created
Content-Type: application/json
Location: /api/san/v1/iscsi/initiator-groups/test-group

{
    "group": {
        "href": "/api/san/v1/iscsi/initiator-groups/test-group",
        "initiators": ["iqn.zfs-storage.example.com.sun:02"],
        "name": "group-01"
    }
}

Suprimir un grupo de iniciadores

Suprime un grupo de iniciadores del dispositivo.

Ejemplo de solicitud:

DELETE /api/san/v1.0/iscsi/initiator-groups/group-01 HTTP/1.1
Host: zfs-storage.example.com:215

La supresión satisfactoria devuelve HTTP status 204 (No Content) (estado HTTP 204 [sin contenido]):

HTTP/1.1 204 No-Content