Initiateurs SAN

Les commandes suivantes permettent de gérer les initiateurs SAN.

Table 10-1  Commandes initiateur

Demande Chemin /san/v1.0 Description GET /<protocol>/initiators Enumération de tous les initiateurs SAN pour les objets du protocole donné (FC, iSCSI, SRP) GET /<protocol>/initiators /<initiator> Obtention de l'initiateur SAN spécifié pour les propriétés du protocole donné (FC, iSCSI, SRP) POST /<protocol>/initiators Création d'un nouvel initiateurs SAN pour le protocole donné (FC, iSCSI, SRP) PUT /<protocol>/initiators /<initiator> Modification de l'initiateur SAN spécifié pour l'objet du protocole donné (FC, iSCSI, SRP) DELETE /<protocol>/initiators /<initiator> Destruction de l'objet initiateur spécifié

Ces commandes utilisent les paramètres URI suivants.

Table 10-2  Paramètres URI

Nom Description protocol Protocole NAS pour l'initiateur (FC, iSCSI, SRP) initiateur L'iqn, wwn ou eui de l'initiateur

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.

Table 10-3  Propriétés d'initiateur

Nom Protocole Description alias all Alias de cet initiateur initiateur fc World Wide Name (WWN) du port pour cet initiateur iqn iscsi Nom qualifié iSCSI pour cet initiateur chapuser iscsi Nom d'utilisateur Challenge handshake auth protocol (CHAP) chapsecret iscsi Secret Challenge handshake auth protocol (CHAP) initiateur srp Identificateur unique étendu (EUI, Extended Unique Identifier)

List Initiators

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": ""
    }]
}

Get Initiator Details

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": ""
    }
}

Create an Initiator

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": ""
    }
}

Modify an Initiator

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"
    }
}

Delete an Initiator

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