Les commandes de cibles iSCSI sont utilisées pour gérer les cibles iSCSI et les groupes de cibles iSCSI. Les commandes disponibles sont répertoriées ci-dessous.
|
Cette commande utilise les paramètres URI suivants
|
Toutes les commandes "get" renvoient les propriétés de la cible, tandis que les commandes "create" et "modify target" utilisent les propriétés suivantes en tant qu'entrée.
|
Les propriétés suivantes sont utilisées pour obtenir les informations du groupe de cibles iSCSI.
|
Répertorie toutes les cibles SAN du protocole spécifié disponibles sur l'appareil.
Exemple de demande :
GET /api/san/v1/iscsi/targets HTTP/1.1 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: 1337 { "size": 7, "targets": [{ "alias": "tst.volumes.py.12866.target", "href": "/api/san/v1/iscsi/targets/iqn.1986-03.com.sun:02: 72b6fa9a-96c4-e511-db19-aadb9bac2052", "iqn": "iqn.1986-03.com.sun:02:72b6fa9a-96c4- e511-db19-aadb9bac2052", ... }, { "alias": "tst.volumes.py.96238.target", "href": "/api/san/v1/iscsi/targets/iqn.1986-03.com.sun:02: 31d26d2e-6aa0-6054-fe58-8b1fb508b008", "iqn": "iqn.1986-03.com.sun:31d26d2e-6aa0-6054-fe58-8b1fb508b008", ... } ...] }
Obtient les propriétés à partir d'une cible unique. La cible peut être sélectionnée à l'aide de la propriété "iqn" ou en utilisant "alias=<alias>".
Exemple de demande :
GET /api/san/v1/iscsi/targets/alias=test-target HTTP/1.1 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: 251 { "target": { "alias": "test-target", "auth": "none", "href": "/api/san/v1/iscsi/targets/alias=test-target", "interfaces": ["ixgbe0"], "iqn": "iqn.1986-03.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008", "targetchapsecret": "", "targetchapuser": "" } }
Crée une nouvelle cible. Le corps de la demande contient un objet JSON avec une seule propriété name, qui est le nom du nouveau groupe cible iSCSI.
Exemple de demande :
POST /api/san/v1/iscsi/targets HTTP/1.1 Host: zfs-storage.example.com:215 Authorization: Basic abcd123MWE= Content-Type: application/json Content-Length: 23 Accept: application/json {"alias": "test-target"}
Exemple de réponse :
HTTP/1.1 201 Created Content-Type: application/json Content-Length: 233 X-Zfssa-San-Api: 1.0 Location: /api/san/v1/iscsi/targets/iqn.1986-03.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008 { "target": { "href": "/api/san/v1/iscsi/targets/iqn.1986-03.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008", "alias": "test-target", "iqn": "iqn.1986-03.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008", "auth": "none", "targetchapuser": "", "targetchapsecret": "", "interfaces": ["ixgbe0"] } }
Modifie une cible iSCSI existante. Le corps de la demande contient un objet JSON contenant les propriétés de la cible iSCSI en cours de modification. Le code de statut HTTP 202 (Accepted) est renvoyé en cas de succès. Le corps de la réponse contient les propriétés de la cible iSCSI résultante pour la cible encodée dans un objet JSON.
Exemple de demande :
PUT /api/san/v1/iscsi/targets/alias=test-target HTTP/1.1 Host: zfs-storage.example.com:215 Authorization: Basic abcd123MWE= Host: zfs-storage.example.com Content-Type: application/json Content-Length: 54 Accept: application/json {"targetchapsecret":"letmeinnowplease", "auth":"chap", "targetchapuser":"argus"}
Exemple de réponse :
HTTP/1.1 202 Accepted Content-Type: application/json Content-Length: 189 X-Zfssa-San-Api: 1.0 { "target": { "href": "/api/san/v1/iscsi/targets/alias=test-target", "auth": "chap", "targetchapsecret": "letmeinnowplease", "alias": "test-arget", "iqn": "iqn.1986-03.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008", "targetchapuser": "argus", "interfaces": ["ixgbe0"] } }
Supprime une cible SAN du système.
Exemple de demande :
DELETE /api/san/v1/iscsi/targets/iqn.1986-03.com.sun:02:e7e688b1 HTTP/1.1 Host: zfs-storage.example.com:215 Authorization: Basic abcd123MWE=
Une suppression réussie renvoie le code HTTP 204 (No Content) :
HTTP/1.1 204 No-Content