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
 
 

Initiateurs SAN

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