Groupe de cibles

Langue :

Les groupes de cibles sont des collections de cibles. Les commandes de groupes de cibles sont répertoriées dans le tableau ci-dessous.

Les commandes de groupes de cibles utilisent les paramètres URI suivants :

protocol: Protocole NAS de l'initiateur : fc, iscsi ou srp
target-group: Nom du groupe de cibles

Table 39 Commandes de groupe de cibles

Demande	Ajouter au chemin /san/v{1\|2}	Description
GET	/`protocol`/target-groups	Enumération de tous les groupes de cibles SAN pour les objets du protocole donné : `fc`, `iscsi` ou `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` ou `srp`
POST	/`protocol`/target-groups	Création d'un nouveau groupe de cibles SAN pour le protocole donné : `fc`, `iscsi` ou `srp`
PUT	/`protocol`/target-groups/`target-group`	Modification du groupe de cibles SAN spécifié pour l'objet du protocole donné : `fc`, `iscsi` ou `srp`
DELETE	/`protocol`/target-groups/`target-group`	Destruction de l'objet du groupe cible spécifié

Liste des groupes de cibles

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 Tm8gcGVla2luZyE=
Accept: application/json

Exemple de résultat :

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

Obtention d'un groupe de cibles

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 comporte un objet JSON nommé group qui contient 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 Tm8gcGVla2luZyE=
Accept: application/json

Exemple de résultat :

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

Création d'un groupe de cibles

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

Exemple de résultat :

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

Suppression d'un groupe de cibles

Supprime un groupe de cibles existant.

Exemple de demande :

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

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

HTTP/1.1 204 No-Content