Liaisons de données réseau

Langue :

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