Grupo de destinos

Los grupos de destino son un conjunto de destinos.

Tabla 10-11  Comandos del grupo de destino

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

Estos comandos usan los siguientes parámetros del URI.

Tabla 10-12  Parámetros del URI

Nombre Descripción protocol El protocolo NAS para el iniciador (FC, iSCSI, SRP) name El nombre del grupo de destinos

Mostrar grupos de destino

Mostrar todos los grupos de destino disponibles para un dispositivo Cuando esto es correcto, se devuelve HTTP Status 200 (OK) (estado HTTP 200 [aceptar]) y el cuerpo contiene un objeto JSON con una propiedad denominada “groups” que contiene una matriz de grupos de destino.

Ejemplo de solicitud:

GET /api/san/v1/iscsi/target-groups
Host: zfs-storage.example.com:215
Authorization: Basic abcd123MWE=
Accept: application/json

Ejemplo de respuesta:

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

{
    "groups": [{
        "href": "/api/san/v1/iscsi/target-groups/test-group",
        "name": "test-group",
        "targets": [
            "iqn.1986-03.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008"
        ]
    }, {
        "href": "/api/san/v1/iscsi/target-groups/alt-group",
        ...
    }]
 }

Obtener grupo de destinos

Obtiene un grupo de destinos simple. Esta solicitud toma un solo parámetro del URI, que es el nombre del grupo de destinos. El cuerpo de la respuesta contiene un objeto JSON denominado "target-group" que contiene las propiedades del grupo de destinos.

Ejemplo de solicitud:

GET /api/san/v1/iscsi/target-groups/test-group
Host: zfs-storage.example.com:215
Authorization: Basic abcd123MWE=
Accept: application/json

Ejemplo de respuesta:

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

{
    "group": {
        "href": "/api/san/v1/iscsi/target-groups/test-group",
        "name": "test-group",
        "targets": [
            "iqn.1986-03.com.sun:02:0d5a0ed8-44b6-49f8-a594-872bf787ca5a"]
    }
}

Crear un grupo de destino

Crear un nuevo grupo de destino iSCSI. La solicitud tiene un objeto JSON con una sola propiedad name que es el nombre del nuevo grupo.

Ejemplo de solicitud:

POST /api/san/v1/iscsi/target-groups HTTP/1.1
Host: zfs-storage.example.com:215
Authorization: Basic abcd123MWE
Accept: application/json
Content-Type: application/json
Content-Length: 97

{"name":"test-group",
 "targets": ["iqn.1986-03.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008"]}

Ejemplo de respuesta:

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 154
X-Zfssa-San-Api: 1.0
Location: /api/san/v1/iscsi/target-groups/test-group

{
    "group": {
        "href": "/api/san/v1/iscsi/target-groups/test-group",
        "name": "test-group",
        "targets": [
            "iqn.1986-03.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008"]
    }
}

Suprimir un grupo de destino

Suprime un grupo de destino existente.

Ejemplo de solicitud:

DELETE /api/nas/v1.0/iscsi/target-groups/test-group

La supresión satisfactoria devuelve el estado HTTP 204 (No Content).

HTTP/1.1 204 No-Content