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
 
 

Liaisons de données réseau

La commande de liaison de données réseau permet de gérer la liaison de données sur l'appareil. Vous pouvez répertorier, modifier, créer et supprimer des ressources de liaison de données.

Table 16  Commandes de liaison de données réseau
Demande
Ajouter au chemin /network/v{1|2}
Description
POST
/datalinks
Création d'une liaison de données réseau
GET
/datalinks/datalink
Obtention des propriétés de la liaison de données réseau spécifiée
GET
/datalinks
Enumération des objets de liaison de données réseau
PUT
/datalinks/datalink
Modification de l'objet de la liaison de données réseau spécifiée
DELETE
/datalinks/datalink
Destruction de l'objet de la liaison de données spécifiée
Table 17  Propriétés de la liaison de données du périphérique physique
Propriété
Type
Description
class
String
"périphérique" ("inaltérable")
label
NetworkLabel
Etiquette
links
ChooseOne
Liens ["igb1", "igb0", "ixgbe2", "ixgbe3", "igb4", "igb3", "ixgbe1", "igb2", "igb5"]
jumbo
Boolean
Utilisation des cadres Jubmo ["true", "false"] ("deprecated")
mtu
PositiveInteger
Unité de transmission maximale (MTU)
speed
ChooseOne
Vitesse de liaison ["auto", "10", "100", "1000", "10000"]
duplex
ChooseOne
Valeur duplex de la liaison ["auto", "half", "full"]
Table 18  Propriétés de la liaison de données du périphérique VNIC
Propriété
Type
Description
class
String
"vnic" ("inaltérable")
label
NetworkLabel
Etiquette
links
ChooseOne
Liens ["ixgbe0"]
mtu
PositiveInteger
Unité de transmission maximale (MTU)
id
VLAN
ID de VLAN
Table 19  Propriétés de la liaison de données du périphérique VLAN
Propriété
Type
Description
class
String
"vlan" ("inaltérable")
label
NetworkLabel
Etiquette
links
ChooseOne
Liens ["ixgbe0"]
mtu
PositiveInteger
Unité de transmission maximale (MTU)
id
VLAN
ID de VLAN
Table 20  Propriétés de la liaison de données du périphérique en fonction d'un groupement
Propriété
Type
Description
class
String
"groupement" ("inaltérable")
label
NetworkLabel
Etiquette
links
ChooseN
Liens ["igb1", "igb0", "ixgbe2", "ixgbe3", "igb4", "igb3", "ixgbe1", "igb2", "igb5"]
jumbo
Boolean
Utilisation des cadres Jubmo ["true", "false"] ("deprecated")
mtu
PositiveInteger
Unité de transmission maximale (MTU)
policy
ChooseOne
Stratégie ["L2", "L3", "L4", "L2+L3", "L2+L4", "L3+L4"]
mode
ChooseOne
Mode ["active", "passive", "off"]
timer
ChooseOne
Horloge ["short", "long"]
key
Integer
Clé du groupement ("inaltérable")
Table 21  Propriétés de la liaison de données du périphérique de partition IP
Propriété
Type
Description
class
String
"partition" ("inaltérable")
label
NetworkLabel
Etiquette
links
ChooseOne
Liens
pkey
pkey
Clé de partition
linkmode
ChooseOne
Mode de liaison ["cm", "ud"]

Liste des liaisons de données réseau

Cette commande répertorie toutes les liaisons de données configurées sur l'appareil. Chaque objet de la liste des liaisons de données contient un href permettant d'effectuer cette opération sur une seule ressource de liaison de données avec des propriétés de liaison de données.

Exemple de demande :

GET /api/network/v1/datalinks HTTP/1.1
Host: zfs-storage.example.com:215
Accept: application/json

Exemple de données au format JSON :

{
    "datalinks": [{
        "href": "/api/network/v1/datalinks/ixgbe0",
        ...
    }, {
        "href": "/api/network/v1/datalinks/ixgbe1",
        ...
    }, {
        "href": "/api/network/v1/datalinks/ixgbe2",
        ...
    }, {
        "href": "/api/network/v1/datalinks/ixgbe3",
        ...
    }]
}

Obtention d'une liaison de données réseau

La méthode GET renvoie un objet JSON contenant une propriété de liaison de données ainsi qu'une liste d'objets de liaison de données.

GET /api/network/v1/datalinks/ixgbe0 HTTP/1.1
Host: zfs-storage.example.com:215
Accept: application/json

Exemple de données au format JSON :

{
    "datalink": {
        "class": "device",
        "datalink": "ixgbe0",
        "duplex": "auto",
        "href": "/api/network/v1/datalinks/ixgbe0",
        "jumbo": false,
        "label": "Untitled Datalink",
        "links": [
            "ixgbe0"
        ],
        "mac": "0:21:28:a1:d9:68",
        "mtu": 1500,
        "speed": "auto"
    }
}

Création d'une liaison de données réseau

La commande POST crée une nouvelle liaison de données. Lors de la création d'une nouvelle liaison de données, la propriété class, qui définit la classe de la liaison de données à créer, est également requise. La classe de la liaison de données est définie lors de sa création et peut appartenir à l'une des catégories suivantes ::

  • device : la liaison de données créée est basée sur un périphérique.

  • vnic : la liaison de données créée est basée sur un VNIC

  • vlan : la liaison de données créée est basée sur un VLAN

  • aggregation : la liaison de données créée est basée sur un groupement

  • partition : la liaison de données créée est basée sur une partition IB

Les propriétés sont mappées vers les propriétés identiques de la CLI qui sont disponibles dans le menu de configuration des liaisons de données réseau.

Exemple de demande :

POST /api/network/v1/datalinks HTTP/1.1
Host: zfs-storage.example.com:215
X-Auth-User: root
X-Auth-Key: password
Content-Type: application/json
Content-Length: 78

{
    "class": "device",
    "jumbo": true,
    "links": ["ixgbe2"],
    "label": "TestDataLink"
}

Exemple de résultat :

HTTP/1.1 201 Created
X-Zfssa-Appliance-Api: 1.0
Location: /api/network/v1/datalinks/ixgbe2

Modification d'une liaison de données réseau

La méthode PUT permet de modifier les propriétés de la liaison de données. Pour plus d'informations sur la configuration des liaisons de données, consultez la documentation de la CLI.

Exemple de demande :

PUT /api/network/v1/datalinks/ixgbe2 HTTP/1.1

{"jumbo": true}

Exemple de résultat :

HTTP/1.1 202 Accepted
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
Content-Length: 219

{
    "datalink": {
        "href": "/api/network/v1/datalinks/ixgbe2",
        "class": "device",
        "label": "MyDataLink",
        "links": ["ixgbe2"],
        "mac": "0:21:28:a1:d9:6a",
        "mtu": 9000,
        "duplex": "auto",
        "jumbo": true,
        "speed": "auto"
    }
}

Suppression d'une liaison de données réseau

Cette commande supprime la liaison de données du système. Supprimez la liaison de données spécifiée à l'aide du chemin d'accès href.

Exemple de demande :

DELETE /api/network/v1/datalinks/ixgbe2 HTTP/1.1

Exemple de résultat :

HTTP/1.1 204 No Content