Périphériques réseau

Langue :

Ces commandes répertorient les périphériques réseau physiques sur le système. Les périphériques réseau physiques n'incluent aucune propriété modifiable.

Table 22 Commandes des périphériques réseau

Demande	Ajouter au chemin /network/v{1\|2}	Description
GET	/devices/`device`	Obtention des propriétés du périphérique réseau spécifié
GET	/devices	Enumération de tous les objets de périphérique réseau

Table 23 Propriétés du périphérique réseau

Propriété	Description
`active`	Indicateur booléen signalant si le périphérique est actif
`duplex`	Valeur duplex du périphérique
`factory_mac`	Adresse MAC d'usine
`media`	Périphérique de média
`speed`	Vitesse du périphérique, en mégaoctets/s
`up`	Indicateur booléen signalant si le périphérique est opérationnel

Liste des périphériques réseau

Cette commande répertorie tous les périphériques réseau.

Exemple de demande :

GET /api/network/v1/devices HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
Host: zfs-storage.example.com:215
Accept: application/json

Exemple de résultat :

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 412
X-Zfssa-Gns-Api: 1.0

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

Obtention d'un périphérique réseau

Cet commande obtient les propriétés d'un périphérique réseau unique.

Exemple de demande :

GET /api/network/v1/devices/ixgbe0 HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
Host: zfs-storage.example.com:215
Accept: application/json

Exemple de résultat :

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 178
X-Zfssa-Gns-Api: 1.0

{
    "devices": {
        "active": false,
        "device": "ixgbe0",
        "duplex": "full-duplex",
        "factory_mac": "0:21:28:a1:d9:68",
        "href": "/api/network/v1/devices/ixgbe0",
        "media": "Ethernet",
        "speed": "1000 Mbit/s",
        "up": true
    }
}