Grupo de destinos

Idioma:

Los grupos de destino son un conjunto de destinos. Los comandos del grupo de destino se muestran en la siguiente tabla.

Los comandos del grupo de destino toman los siguientes parámetros del URI.:

protocol: El protocolo NAS para el iniciador: fc, iscsi o srp
target-group: El nombre del grupo de destinos

Tabla 39 Comandos de grupos de destino

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

Enumerar 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 [correcto]) 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 Tm8gcGVla2luZyE=
Accept: application/json

Resultado de ejemplo:

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.zfs-storage.example.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 group que contiene las propiedades del grupo de destino.

Ejemplo de solicitud:

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

Resultado de ejemplo:

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

{
    "group": {
        "href": "/api/san/v1/iscsi/target-groups/test-group",
        "name": "test-group",
        "targets": [
            "iqn.zfs-storage.example.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 Tm8gcGVla2luZyE=
Accept: application/json
Content-Type: application/json
Content-Length: 97

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

Resultado de ejemplo:

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.zfs-storage.example.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008"]
    }
}

Suprimir un grupo de destino

Suprime un grupo de destino existente.

Ejemplo de solicitud:

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

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

HTTP/1.1 204 No-Content