Iniciadores de SAN

Idioma:

Los siguientes comandos se utilizan para gestionar los iniciadores SAN.

Estos comandos usan los siguientes parámetros del URI:

protocol: El protocolo NAS para el iniciador: fc, iscsi o srp
initiator: El IQN, WWN o EUI del iniciador

Tabla 32 Comandos iniciadores

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

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

Tabla 33 Propiedades del iniciador

Propiedad	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`	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 "initiators" en formato JSON.

Ejemplo de solicitud para mostrar iniciadores iSCSI:

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

Resultado de ejemplo:

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

{
    "initiators": [{
        "alias": "init-02",
        "href": "/api/san/v1/iscsi/initiators/iqn.zfs-storage.example.com.sun:02:02",
        "initiator": "iqn.zfs-storage.example.com.sun:02:02",
        "chapsecret": "",
        "chapuser": ""
    },{
        "alias": "init-01",
        "initiator": "iqn.zfs-storage.example.com.sun:02:01",
        "href": "/api/san/v1/iscsi/initiators/iqn.zfs-storage.example.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.zfs-storage.example.com.sun:02:01 HTTP/1.1
Host: zfs-storage.example.com:215
Accept: application/json

Resultado de ejemplo:

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

{
    "initiator": {
        "alias": "init-01",
        "href": "/api/san/v1/iscsi/initiators/iqn.zfs-storage.example.com.sun:02:01"
        "initiator": "iqn.zfs-storage.example.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 la cabecera HTTP y en el Status Code 201 (Created) (código de estado 201 [creado]) 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:215
Content-Type: application/json
Accept: application/json

{
    "initiator": "iqn.zfs-storage.example.com.sun:02:02",
    "alias":"init-02"
}

Resultado de ejemplo:

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.zfs-storage.example.com.sun:02:02

{
    "initiator": {
        "alias": "init-02",
        "href": "/api/san/v1/iscsi/initiators/iqn.zfs-storage.example.com.sun:02:02",
        "initiator": "iqn.zfs-storage.example.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.zfs-storage.example.com.sun:01 HTTP/1.1
Host: zfs-storage.example.com:215
Content-Type: application/json
Accept: application/json

{
    "alias":"init-01-secure",
    "chapuser":"admin4",
    "chapsecret":"secret"
}

Resultado de ejemplo:

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.zfs-storage.example.com.sun:01",
        "iqn": "iqn.zfs-storage.example.com.sun:1",
        "chapsecret": "secret",
        "chapuser": "admin4"
    }
}

Suprimir un iniciador

Suprime un iniciador del dispositivo.

Ejemplo de solicitud:

DELETE /api/san/v1/iscsi/initiators/iqn.zfs-storage.example.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