Interfaces réseau

Table 7-9  Commandes de l'interface réseau

Demande Chemin /api/network/v1 Description POST /interfaces Création d'une interface réseau GET /interfaces/<interface> Obtention des propriétés de l'interface réseau spécifiée GET /interfaces Enumération de tous les objets de l'interface réseau PUT /interfaces/<interface> Modification de l'objet d'interface réseau spécifié DELETE /interfaces/<interface> Destruction de l'objet d'interface spécifié

Table 7-10  Propriétés de l'interface réseau

Nom Description admin Indicateur de l'autorisation de l'administration sur cette interface class Type de classe ("ip", "ipmp") (inaltérable après la création) curaddrs Adresses IP actuelles (inaltérables) enable Indicateur de l'activation de cette interface label Etiquette utilisateur de l'interface links Choix d'une liaison réseau pour cette interface state Etat de l'interface (inaltérable) v4addrs Adresses IPv4 v6dhcp Indicateur IPv4 DHCP v6addrs Adresses IPv6 v6dhcp Indicateur IPv6 DHCP

List Network Interfaces

Répertorie toutes les interfaces réseau configurées.

Exemple de demande :

GET /api/network/v1/interfaces HTTP/1.1
Authorization: Basic abcd1234MWE=
Host: zfssa.example.com:215
Accept: application/json

Exemple de réponse :

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 369

{
    "interfaces": {[
        "href": "/api/network/v1/interfaces/ixgbe0",
        "v4addrs": ["10.80.231.58/24"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe1",
        "v4addrs": ["10.80.231.59/24"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe2",
        "v4addrs": ["10.80.231.60/24"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe3",
        "v4addrs": ["10.80.231.61/24"]
        ...
    }]
}

Get Network Interface

Obtient la liste complète des propriétés pour une interface réseau spécifiée.

Exemple de demande :

GET /api/network/v1/interfaces/ixgbe0 HTTP/1.1
Authorization: Basic abcd1234MWE=
Host: zfssa.example.com:215
Accept: application/json

Exemple de réponse :

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 292

{
    "interface": {
        "admin": true,
        "class": "ip",
        "curaddrs": ["10.80.231.58/24"],
        "enable": true,
        "href": "/api/network/v1/interfaces/ixgbe0",
        "interface": "ixgbe0",
        "label": "Untitled Interface",
        "links": ["ixgbe0"],
        "state": "up",
        "v4addrs": ["10.80.231.58/24"],
        "v4dhcp": false,
        "v6addrs": [],
        "v6dhcp": false
    }
}

Create Network Interface

Crée une nouvelle interface réseau.

Exemple de demande :

POST /api/network/v1/interfaces HTTP/1.1
Host: zfssa.example.com:215
X-Auth-User: root
X-Auth-Key: letmein
Content-Type: application/json
Content-Length: 78

{
    "class": "ip",
    "links": ["ixgbe3"],
    "v4addrs":"192.168.1.9/24"
}

Exemple de réponse :

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

Modify Network Interface

Modifie une interface réseau existante.

Exemple de demande :

PUT /api/network/v1/interfaces/ixgbe3 HTTP/1.1

{
    "v4addrs": ["192.168.1.99/24"],
    "interface": "Demo Rest"
}

Exemple de réponse :

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

{
    "admin": true,
    "class": "ip",
    "curaddrs": ["192.168.1.9/24"],
    "enable": true,
    "href": "/api/network/v1/interfaces/ixgbe3",
    "interface": "ixgbe3",
    "label": "Demo Rest",
    "links": ["ixgbe3"],
    "state": "failed",
    "v4addrs": ["192.168.1.99/24"]
    "v4dhcp": false,
    "v6addrs": [],
    "v6dhcp": false
}

Delete Network Interface

Supprime une interface réseau existante.

Exemple de demande :

DELETE /api/network/v1/interfaces/ixgbe3 HTTP/1.1
Authorization: Basic abcd1234MWE=
Host: zfssa.example.com:215

Exemple de résultat :

HTTP/1.1 204 No Content