Groupes d'initiateurs

Les commandes initiateur iSCSI sont utilisées pour gérer les initiateur iSCSI et les groupes d'initiateurs iSCSI sur un appareil. Les commandes disponibles sont répertoriées dans le tableau ci-dessous.

Table 10-4  Commandes de groupe d'initiateurs

Demande Chemin /san/v1.0 Description GET /<protocol>/initiator-groups Répertorie tous les groupes d'initiateurs SAN pour les objets du protocole donné (FC, iSCSI, SRP) GET /<protocol>/initiator-groups /<name> Obtention du groupe d'initiateurs SAN spécifié pour les propriétés du protocole donné (FC, iSCSI, SRP) POST /<protocol>/initiator-groups Création d'un nouveau groupe d'initiateurs SAN pour le protocole donné (FC, iSCSI, SRP) PUT /<protocol>/initiator-groups /<name> Modification du groupe d'initiateurs SAN spécifié pour l'objet du protocole donné (FC, iSCSI, SRP) DELETE /<protocol>/initiator-groups /<name> Destruction de l'objet de nom spécifié

Ces commandes utilisent les paramètres URI suivants.

Table 10-5  Paramètres URI

Nom Description protocol Protocole NAS pour l'initiateur (FC, iSCSI, SRP) name Nom du groupe d'initiateurs.

Chaque groupe d'initiateurs a une propriété "name" et une propriété "initiators" contenant une liste des initiateurs dans le groupe d'initiateurs.

List Initiator Groups

Répertorie tous les groupes d'initiateurs iSCSI disponibles. Le statut HTTP 200 (OK) est renvoyé en cas de succès et le corps contient un objet JSON avec une propriété nommée "groups" contenant un tableau des objets de groupe d'initiateurs.

Exemple de demande :

GET /api/san/v1/iscsi/initiator-groups HTTP/1.1
Host: zfs-storage.example.com
Accept: application/json

Exemple de réponse :

HTTP/1.1 200 OK
Content-Type: application/json

{
    "groups": [{
        "href": "/san/v1/iscsi/initiator-groups/aktest-initiators-0",
        "initiators": ["iqn.1986-03.com.sun:0"],
        "name": "aktest-initiators-0"
    }, {
        "href": "/san/v1/iscsi/initiator-groups/aktest-initiators-1",
        "initiators": ["iqn.1986-03.com.sun:1"],
        "name": "aktest-initiators-1"
    }]
}

Get Initiator Group Details

Obtention des informations détaillées à partir d'un unique groupe d'initiateurs iSCSI. Le groupe est accessible en suivant la propriété href renvoyée dans la commande répertoriant les groupes d'initiateurs.

Exemple de demande :

GET /api/san/v1/iscsi/initiator-groups/test-group HTTP/1.1
Host: zfs-storage.example.com
Accept: application/json

Exemple de réponse :

HTTP/1.1 200 OK
Content-Type: application/json

{
    "group": {
        "href": "/api/san/v1/iscsi/initiator-groups/test-group"
        "initiators": ["iqn.1986-03.com.sun:02:01"],
        "name": "test-group"
    }
}

Create an Initiator Group

Crée un groupe d'initiateurs iSCSI sans membres. Le corps de la demande contient un objet JSON avec un seul paramètre "name" contenant le nom du groupe.

Table 10-6  Propriétés de la création de groupe d'initiateurs

Propriété Type Description name string Nom du groupe d'initiateurs initiators tableau Tableau des propriétés IQN de l'initiateur existant

Exemple de demande :

POST /api/san/v1/iscsi/initiator-groups HTTP/1.1
Host: zfs-storage.example.com
Content-Type: application/json
Content-Length: 64
Accept: application/json

{
   "name":"group-01",
   "initiators": ["iqn.1986-03.com.sun:02"]
}

Exemple de réponse :

HTTP/1.1 201 Created
Content-Type: application/json
Location: /api/san/v1/iscsi/initiator-groups/test-group

{
    "group": {
        "href": "/api/san/v1/iscsi/initiator-groups/test-group",
        "initiators": ["iqn.1986-03.com.sun:02"],
        "name": "group-01"
    }
}

Delete an Initiator Group

Supprime un groupe d'initiateurs de l'appareil.

Exemple de demande :

DELETE /api/san/v1.0/iscsi/initiator-groups/group-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