Les commandes suivantes permettent de gérer les initiateurs SAN.
|
Ces commandes utilisent les paramètres URI suivants.
|
De nombreuses commandes initiateur utilisent les propriétés répertoriées ci-dessous 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 Accept: application/json
Exemple de réponse :
HTTP/1.1 200 OK Content-Type: application/json { "initiators": [{ "alias": "init-02", "href": "/api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:02:02", "initiator": "iqn.1986-03.com.sun:02:02", "chapsecret": "", "chapuser": "" },{ "alias": "init-01", "initiator": "iqn.1986-03.com.sun:02:01", "href": "/api/san/v1/iscsi/initiators/iqn.1986-03.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.1986-03.com.sun:02:01 HTTP/1.1 Host: zfs-storage.example.com Accept: application/json
Exemple de réponse :
HTTP/1.1 200 OK Content-Type: application/json { "initiator": { "alias": "init-01", "href": "/api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:02:01" "initiator": "iqn.1986-03.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 Content-Type: application/json Accept: application/json { "initiator": "iqn.1986-03.com.sun:02:02", "alias":"init-02" }
Exemple de réponse :
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.1986-03.com.sun:02:02 { "initiator": { "alias": "init-02", "href": "/api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:02:02", "initiator": "iqn.1986-03.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é "initiateur".
Exemple de demande :
PUT /api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:01 /HTTP/1.1 Host: zfs-storage.example.com Content-Type: application/json Accept: application/json { "alias":"init-01-secure", "chapuser":"chuck", "chapsecret":"igottheintersect" }
Exemple de réponse :
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.1986-03.com.sun:01", "iqn": "iqn.1986-03.com.sun:1", "chapsecret": "igottheintersect", "chapuser": "chuck" } }
Supprime un initiateur de l'appareil.
Exemple de demande :
DELETE /api/san/v1/iscsi/initiators/iqn.1986-03.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