Groupe de cibles

Les groupes de cibles sont des collections de cibles.

Table 10-11  Commandes de groupe de cibles

Demande Chemin /san/v1.0 Description GET /<protocol>/target-groups Enumération de tous les groupes de cibles SAN pour les objets du protocole donné (FC, iSCSI, SRP) GET /<protocol>/target-groups /<target-group> Obtention du groupe de cibles SAN spécifié pour les propriétés du protocole donné (FC, iSCSI, SRP) POST /<protocol>/target-groups Création d'un nouveau groupe de cibles SAN pour le protocole donné (FC, iSCSI, SRP) PUT /<protocol>/target-groups /<target-group> Modification du groupe de cibles SAN spécifié pour l'objet du protocole donné (FC, iSCSI, SRP) DELETE /<protocol>/target-groups /<target-group> Destruction de l'objet du groupe cible spécifié

Ces commandes utilisent les paramètres URI suivants.

Table 10-12  Paramètres URI

Nom Description protocol Protocole NAS pour l'initiateur (FC, iSCSI, SRP) name Nom du groupe de cibles

List Target Groups

Répertorie tous les groupes de cibles disponibles pour un appareil. Le statut HTTP 200 (OK) est renvoyé en cas de succès et le corps contient un objet JSON avec une propriété nommée "groups" contenant un tableau des objets de groupe de cibles.

Exemple de demande :

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

Exemple de réponse :

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",
        ...
    }]
 }

Get Target Group

Obtient un groupe de cibles unique. La demande utilise un paramètre URI unique, qui est le nom du groupe de cibles. Le corps de la réponse contient un objet JSON nommé "target-group" contenant les propriétés du groupe de cibles.

Exemple de demande :

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

Exemple de réponse :

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"]
    }
}

Create a Target Group

Crée un nouveau groupe de cibles iSCSI. Le corps de la demande est un objet JSON avec une seule propriété name, qui est le nom du nouveau groupe.

Exemple de demande :

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"]}

Exemple de réponse :

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"]
    }
}

Delete a Target Group

Supprime un groupe de cibles existant.

Exemple de demande :

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

Une suppression réussie renvoie le code HTTP 204 (No Content) :

HTTP/1.1 204 No-Content