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 31 Commandes de liaison de données réseau

Demande	Chemin /network/v1	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 32 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 33 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 34 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 35 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 36 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"]

List Network Datalinks

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
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",
        ...
    }]
}

Get Network Datalink

Les méthodes GET renvoient 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

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"
    }
}

Create Network Datalink

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 :

périphérique : 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
groupement : 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: zfssa.example.com:215
X-Auth-User: root
X-Auth-Key: letmein
Content-Type: application/json
Content-Length: 78

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

Exemple de réponse :

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

Modify Network Datalink

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éponse :

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"
    }
}

Delete Network Datalink

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éponses :

HTTP/1.1 204 No Content