Groupes d'initiateurs

Langue :

Les commandes initiateur iSCSI sont utilisées pour gérer les initiateur iSCSI et les groupes d'initiateurs iSCSI sur un appareil. Les commandes disponibles sont répertoriées dans le tableau ci-dessous.

Ces commandes utilisent les paramètres URI suivants:

protocol: Protocole NAS de l'initiateur : fc, iscsi ou srp
name: Nom du groupe d'initiateurs

Chaque groupe d'initiateurs a une propriété name et une propriété initiators qui contient une liste des initiateurs dans le groupe d'initiateurs.

Table 34 Commandes de groupe d'initiateurs

Demande	Ajouter au chemin /san/v{1\|2}	Description
GET	/`protocol`/initiator-groups	Enumération de tous les groupes d'initiateurs SAN pour les objets du protocole donné (FC, iSCSI, SRP) : `fc`, `iscsi`, `srp`
GET	/`protocol`/initiator-groups/`name`	Obtention du groupe d'initiateurs SAN spécifié pour les propriétés du protocole donné : `fc`, `iscsi`, `srp`
POST	/`protocol`/initiator-groups	Création d'un nouveau groupe d'initiateurs SAN pour le protocole donné : `fc`, `iscsi`, `srp`
PUT	/`protocol`/initiator-groups/`name`	Modification du groupe d'initiateurs SAN spécifié pour l'objet du protocole donné : `fc`, `iscsi`, `srp`
DELETE	/`protocol`/initiator-groups/`name`	Destruction de l'objet de nom spécifié

Liste des groupes d'initiateurs

Répertorie tous les groupes d'initiateurs iSCSI disponibles. 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 d'initiateurs.

Exemple de demande :

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

Exemple de résultat :

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

{
    "groups": [{
        "href": "/san/v1/iscsi/initiator-groups/p1-initiators-0",
        "initiators": ["iqn.zfs-storage.example.com.sun:0"],
        "name": "p1-initiators-0"
    }, {
        "href": "/san/v1/iscsi/initiator-groups/p1-initiators-1",
        "initiators": ["iqn.zfs-storage.example.com.sun:1"],
        "name": "p1-initiators-1"
    }]
}

Obtention des détails d'un groupe d'initiateurs

Obtention des informations détaillées à partir d'un unique groupe d'initiateurs iSCSI. Le groupe est accessible en suivant la propriété href renvoyée dans la commande répertoriant les groupes d'initiateurs.

Exemple de demande :

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

Exemple de résultat :

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

{
    "group": {
        "href": "/api/san/v1/iscsi/initiator-groups/test-group"
        "initiators": ["iqn.zfs-storage.example.com.sun:02:01"],
        "name": "test-group"
    }
}

Création d'un groupe d'initiateurs

Crée un groupe d'initiateurs iSCSI sans membres. Le corps de la demande contient un objet JSON avec un seul paramètre name contenant le nom du groupe.

Table 35 Propriétés de la création de groupe d'initiateurs

Propriété	Type	Description
`name`	string	Nom du groupe d'initiateurs
`initiators`	tableau	Tableau des propriétés IQN de l'initiateur existant

Exemple de demande :

POST /api/san/v1/iscsi/initiator-groups HTTP/1.1
Host: zfs-storage.example.com:215
Content-Type: application/json
Content-Length: 64
Accept: application/json

{
   "name":"group-01",
   "initiators": ["iqn.zfs-storage.example.com.sun:02"]
}

Exemple de résultat :

HTTP/1.1 201 Created
Content-Type: application/json
Location: /api/san/v1/iscsi/initiator-groups/test-group

{
    "group": {
        "href": "/api/san/v1/iscsi/initiator-groups/test-group",
        "initiators": ["iqn.zfs-storage.example.com.sun:02"],
        "name": "group-01"
    }
}

Suppression d'un groupe d'initiateurs

Supprime un groupe d'initiateurs de l'appareil.

Exemple de demande :

DELETE /api/san/v1.0/iscsi/initiator-groups/group-01 HTTP/1.1
Host: zfs-storage.example.com:215

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

HTTP/1.1 204 No-Content