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.
|
Chaque groupe d'initiateurs a une propriété "name" et une propriété "initiators" contenant 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 Accept: application/json
Exemple de réponse :
HTTP/1.1 200 OK Content-Type: application/json { "groups": [{ "href": "/san/v1/iscsi/initiator-groups/aktest-initiators-0", "initiators": ["iqn.1986-03.com.sun:0"], "name": "aktest-initiators-0" }, { "href": "/san/v1/iscsi/initiator-groups/aktest-initiators-1", "initiators": ["iqn.1986-03.com.sun:1"], "name": "aktest-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 Accept: application/json
Exemple de réponse :
HTTP/1.1 200 OK Content-Type: application/json { "group": { "href": "/api/san/v1/iscsi/initiator-groups/test-group" "initiators": ["iqn.1986-03.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 Content-Type: application/json Content-Length: 64 Accept: application/json { "name":"group-01", "initiators": ["iqn.1986-03.com.sun:02"] }
Exemple de réponse :
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.1986-03.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