Iniciadores de SAN

Los siguientes comandos se utilizan para gestionar los iniciadores SAN.

Tabla 10-1  Comandos iniciadores

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

Estos comandos usan los siguientes parámetros del URI.

Tabla 10-2  Parámetros del URI

Nombre Descripción protocol El protocolo NAS para el iniciador (FC, iSCSI, SRP) initiator El iqn, wwn o eui del iniciador

Muchos de los comandos del iniciador usan las propiedades detalladas abajo como valores de devolución. Los comandos de creación y modificación también usan las propiedades como valores de entrada.

Tabla 10-3  Propiedades del iniciador

Nombre Protocolo Descripción alias all Alias para este iniciador initiator fc Nombre a nivel mundial para este iniciador (WWN) iqn iscsi Nombre iSCSI completo para este iniciador chapuser iscsi Nombre de usuario del protocolo auth por desafío mutuo (CHAP) chapsecret iscsi Secret (secreto) del protocolo auth por desafío mutuo (CHAP) initiator srp Identificador único extendido (EUI)

Mostrar iniciadores

Muestra todos los iniciadores configurados en el dispositivo de un tipo de protocolo especificado. El cuerpo de la respuesta contiene una matriz de propiedades denominadas “iniciadores” en formato JSON.

Ejemplo de solicitud para mostrar iniciadores iSCSI:

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

Ejemplo de respuesta:

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

{
    "initiators": [{
        "alias": "init-02",
        "href": "/api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:02:02",
        "initiator": "iqn.1986-03.com.sun:02:02",
        "chapsecret": "",
        "chapuser": ""
    },{
        "alias": "init-01",
        "initiator": "iqn.1986-03.com.sun:02:01",
        "href": "/api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:02:01",
        "chapsecret": "",
        "chapuser": ""
    }]
}

Obtener detalles del iniciador

Muestra los detalles de un solo iniciador iSCSI. El cuerpo de la respuesta contiene las propiedades del iniciador iSCSI como un objeto nombrado “initiator” en formato JSON.

Ejemplo de solicitud:

GET /api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:02:01 HTTP/1.1
Host: zfs-storage.example.com
Accept: application/json

Ejemplo de respuesta:

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

{
    "initiator": {
        "alias": "init-01",
        "href": "/api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:02:01"
        "initiator": "iqn.1986-03.com.sun:02:01",
        "chapsecret": "",
        "chapuser": ""
    }
}

Crear un iniciador

Crea un nuevo iniciador de iSCSI. Debe suplementar el nombre completo iSCSI (IQN). El cuerpo de la solicitud contiene las propiedades del iniciador iSCSI en formato JSON. La respuesta incluye la ubicación de URI del nuevo iniciador iSCSI en el encabezado HTTP y en el Status Code 201 (Created) cuando son correctos. El cuerpo de la respuesta contiene las propiedades del iniciador iSCSI como un objeto nombrado “initiator” en formato JSON.

Ejemplo de solicitud:

POST /api/san/v1.0/iscsi/initiators HTTP/1.1
Host: zfs-storage.example.com
Content-Type: application/json
Accept: application/json

{
    "initiator": "iqn.1986-03.com.sun:02:02",
    "alias":"init-02"
}

Ejemplo de respuesta:

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 181
X-Zfssa-San-Api: 1.0
Location: /api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:02:02

{
    "initiator": {
        "alias": "init-02",
        "href": "/api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:02:02",
        "initiator": "iqn.1986-03.com.sun:02:02",
        "chapsecret": "",
        "chapuser": ""
    }
}

Modificar un iniciador

Este comando modifica un iniciador existente. El cuerpo de la solicitud contiene las propiedades del iniciador que deben modificarse en el formato JSON. El IQN para el iniciador se suministra en el URI. Cuando esto es correcto, se devuelve HTTP Status 202 (Accepted) (estado HTTP 202 [aceptado]). El cuerpo de la respuesta contiene las propiedades del iniciador iSCSI nuevo como un objeto nombrado “initiator” en formato JSON.

Ejemplo de solicitud:

PUT /api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:01  /HTTP/1.1
Host: zfs-storage.example.com
Content-Type: application/json
Accept: application/json

{
    "alias":"init-01-secure",
    "chapuser":"chuck",
    "chapsecret":"igottheintersect"
}

Ejemplo de respuesta:

HTTP/1.1 202 Accepted
Content-Length: 167
Content-Type: application/json
X-Zfs-Sa-Nas-Api: 1.0

{
    "initiator": {
        "alias": "init-01-secure",
        "href": "/api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:01",
        "iqn": "iqn.1986-03.com.sun:1",
        "chapsecret": "igottheintersect",
        "chapuser": "chuck"
    }
}

Suprimir un iniciador

Suprime un iniciador del dispositivo.

Ejemplo de solicitud:

DELETE /api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:01 HTTP/1.1
Host: zfs-storage.example.com:215

La supresión satisfactoria devuelve HTTP Code 204 (No Content) (código HTTP 204 [sin contenido]):

HTTP/1.1 204 No-Content