Initiateurs SAN

Langue :

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

Ces commandes utilisent les paramètres URI suivants:

protocol: Protocole NAS de l'initiateur : fc, iscsi ou srp
initiator: IQN, WWN ou EUI de l'initiateur

Table 32 Commandes initiateur

Demande	Ajouter au chemin /san/v{1\|2}	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 initiateur 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é

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.

Table 33 Propriétés d'initiateur

Propriété	Protocole	Description
`alias`	all	Alias de cet initiateur
`initiator`	`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)
`initiator`	`srp`	Identificateur unique étendu (EUI, Extended Unique Identifier)

Liste des initiateurs

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

Obtention des détails d'un initiateur

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éation d'un initiateur

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

Modification d'un initiateur

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

Suppression d'un initiateur

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