Grupos de iniciadores

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.

Tabla 10-4  Comandos de grupo de iniciadores

Solicitud Ruta /san/v1.0 Descripción GET /<protocol>/initiator-groups Detallar todos los grupos de iniciadores SAN para los objetos del protocolo (FC, iSCSI, SRP) determinados. GET /<protocol>/initiator-groups /<name> Obtener el grupo de iniciadores SAN especificado para las propiedades del protocolo (FC, iSCSI, SRP) determinadas. POST /<protocol>/initiator-groups Crear un nuevo grupo de iniciadores SAN especificado para el protocolo (FC, iSCSI, SRP) determinado. PUT /<protocol>/initiator-groups /<name> Modificar el grupo de iniciadores SAN especificado para el objeto del protocolo (FC, iSCSI, SRP) determinado. DELETE /<protocol>/initiator-groups /<name> Destruir el nombre del objeto especificado.

Estos comandos usan los siguientes parámetros del URI.

Tabla 10-5  Parámetros del URI

Nombre Descripción protocol El protocolo NAS para el iniciador (FC, iSCSI, 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.

Mostrar 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
Accept: application/json

Ejemplo de respuesta:

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

{
    "groups": [{
        "href": "/san/v1/iscsi/initiator-groups/aktest-initiators-0",
        "initiators": ["iqn.1986-03.com.sun:0"],
        "name": "aktest-initiators-0"
    }, {
        "href": "/san/v1/iscsi/initiator-groups/aktest-initiators-1",
        "initiators": ["iqn.1986-03.com.sun:1"],
        "name": "aktest-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
Accept: application/json

Ejemplo de respuesta:

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

{
    "group": {
        "href": "/api/san/v1/iscsi/initiator-groups/test-group"
        "initiators": ["iqn.1986-03.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 10-6  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
Content-Type: application/json
Content-Length: 64
Accept: application/json

{
   "name":"group-01",
   "initiators": ["iqn.1986-03.com.sun:02"]
}

Ejemplo de respuesta:

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.1986-03.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 el estado HTTP 204 (No Content).

HTTP/1.1 204 No-Content