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:
Protocole NAS de l'initiateur : fc, iscsi ou srp
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.
|
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 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é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.
|
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" } }
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