Go to main content

Guide RESTful API des systèmes Oracle® ZFS Storage Appliance, version OS8.8.x

Quitter la vue de l'impression

Mis à jour : Août 2021
 
 

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.

Ces commandes utilisent les paramètres URI suivants:

protocol

Protocole NAS de l'initiateur : fc, iscsi ou srp

name

Nom du groupe d'initiateurs

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

Table 34  Commandes de groupe d'initiateurs
Demande
Ajouter au chemin /san/v{1|2}
Description
GET
/protocol/initiator-groups
Enumération de tous les groupes d'initiateurs SAN pour les objets du protocole donné (FC, iSCSI, SRP) : 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é

Liste des groupes d'initiateurs

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:215
Accept: application/json

Exemple de résultat :

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

{
    "groups": [{
        "href": "/san/v1/iscsi/initiator-groups/p1-initiators-0",
        "initiators": ["iqn.zfs-storage.example.com.sun:0"],
        "name": "p1-initiators-0"
    }, {
        "href": "/san/v1/iscsi/initiator-groups/p1-initiators-1",
        "initiators": ["iqn.zfs-storage.example.com.sun:1"],
        "name": "p1-initiators-1"
    }]
}

Obtention des détails d'un groupe d'initiateurs

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:215
Accept: application/json

Exemple de résultat :

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

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

Création d'un groupe d'initiateurs

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 35  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:215
Content-Type: application/json
Content-Length: 64
Accept: application/json

{
   "name":"group-01",
   "initiators": ["iqn.zfs-storage.example.com.sun:02"]
}

Exemple de résultat :

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.zfs-storage.example.com.sun:02"],
        "name": "group-01"
    }
}

Suppression d'un groupe d'initiateurs

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