Les commandes suivantes permettent de gérer les initiateurs SAN.
Ces commandes utilisent les paramètres URI suivants:
Protocole NAS de l'initiateur : fc, iscsi ou srp
IQN, WWN ou EUI de l'initiateur
|
De nombreuses commandes initiateur utilisent les propriétés répertoriées dans le tableau suivant en tant que valeurs de renvoi. Les commandes de création et de modification utilisent également les propriétés en tant que valeurs de sortie.
|
Répertorie tous les initiateurs configurés sur l'appareil d'un type de protocole spécifié. Le corps de la réponse contient un tableau de propriétés initiateur nommées "initiateurs" au format JSON.
Exemple de demande d'énumération des initiateurs iSCSI :
GET /api/san/v1/iscsi/initiators 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 { "initiators": [{ "alias": "init-02", "href": "/api/san/v1/iscsi/initiators/iqn.zfs-storage.example.com.sun:02:02", "initiator": "iqn.zfs-storage.example.com.sun:02:02", "chapsecret": "", "chapuser": "" },{ "alias": "init-01", "initiator": "iqn.zfs-storage.example.com.sun:02:01", "href": "/api/san/v1/iscsi/initiators/iqn.zfs-storage.example.com.sun:02:01", "chapsecret": "", "chapuser": "" }] }
Répertorie les détails d'un initiateur iSCSI unique. Le corps de la réponse contient des propriétés initiateur iSCSI au format JSON en tant qu'objet nommé "initiateur".
Exemple de demande :
GET /api/san/v1/iscsi/initiators/iqn.zfs-storage.example.com.sun:02:01 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 { "initiator": { "alias": "init-01", "href": "/api/san/v1/iscsi/initiators/iqn.zfs-storage.example.com.sun:02:01" "initiator": "iqn.zfs-storage.example.com.sun:02:01", "chapsecret": "", "chapuser": "" } }
Crée un nouvel initiateur iSCSI. Vous devez fournir le nom qualifié iSCSI (IQN). Le corps de la réponse contient les propriétés d'initiateur iSCSI au format JSON. La réponse inclut l'URI d'emplacement du nouvel initiateur iSCSI dans l'en-tête HTTP et le code de statut 201 (Created) en cas de réussite. Le corps de la réponse contient des propriétés initiateur iSCSI au format JSON en tant qu'objet nommé "initiateur".
Exemple de demande :
POST /api/san/v1.0/iscsi/initiators HTTP/1.1 Host: zfs-storage.example.com:215 Content-Type: application/json Accept: application/json { "initiator": "iqn.zfs-storage.example.com.sun:02:02", "alias":"init-02" }
Exemple de résultat :
HTTP/1.1 201 Created Content-Type: application/json Content-Length: 181 X-Zfssa-San-Api: 1.0 Location: /api/san/v1/iscsi/initiators/iqn.zfs-storage.example.com.sun:02:02 { "initiator": { "alias": "init-02", "href": "/api/san/v1/iscsi/initiators/iqn.zfs-storage.example.com.sun:02:02", "initiator": "iqn.zfs-storage.example.com.sun:02:02", "chapsecret": "", "chapuser": "" } }
Cette commande modifie un initiateur existant. Le corps de la réponse contient les propriétés d'initiateur devant être modifiées au format JSON. L'IQN de l'initiateur est fourni dans l'URI. Le code de statut HTTP 202 (Accepted) est renvoyé en cas de succès. Le corps de la réponse contient de nouvelles propriétés initiateur iSCSI au format JSON en tant qu'objet nommé initiator.
Exemple de demande :
PUT /api/san/v1/iscsi/initiators/iqn.zfs-storage.example.com.sun:01 HTTP/1.1 Host: zfs-storage.example.com:215 Content-Type: application/json Accept: application/json { "alias":"init-01-secure", "chapuser":"admin4", "chapsecret":"secret" }
Exemple de résultat :
HTTP/1.1 202 Accepted Content-Length: 167 Content-Type: application/json X-Zfs-Sa-Nas-Api: 1.0 { "initiator": { "alias": "init-01-secure", "href": "/api/san/v1/iscsi/initiators/iqn.zfs-storage.example.com.sun:01", "iqn": "iqn.zfs-storage.example.com.sun:1", "chapsecret": "secret", "chapuser": "admin4" } }
Supprime un initiateur de l'appareil.
Exemple de demande :
DELETE /api/san/v1/iscsi/initiators/iqn.zfs-storage.example.com.sun: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