Routes réseau

Gère les routes réseau.

Table 7-11  Gestion des routes réseau

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

Table 7-12  Propriétés de la route réseau

Nom Description type Type de route, par exemple "system" ou "static" (inaltérable) family Famille d'adresses (IPv4 ou IPv6) destination Adresse de destination de la route gateway Adresse de passerelle interface Interface de liaison de données réseau

Le chemin d'accès href à chaque route utilise les ID de route définis dans la CLI. Il est néanmoins possible de modifier ces valeurs lors de la modification des routes. L'API prend en charge la sélection de routes uniques par le biais de propriétés uniques au sein de la route. La syntaxe est routes/<name>=<value>, et non routes/route-###

List Routes

Répertorie toutes les routes réseau créées sur un appareil.

Exemple de demande :

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

Exemple de résultat :

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

{
    "routes": [{
        "destination": "0.0.0.0",
        "family": "IPv4",
        "gateway": "10.80.231.1",
        "href": "/api/network/v1/routing/route-000",
        "interface": "ixgbe0",
        "mask": 0,
        "route": "route-000",
        "type": "static"
    }, {
        "destination": "10.80.231.0",
        "family": "IPv4",
        "gateway": "10.80.231.58",
        "href": "/api/network/v1/routes/route-001",
        "interface": "ixgbe0",
        "mask": 24,
        "route": "route-001",
        "type": "system"
    }]
}

Get Route

Obtient les propriétés d'une route unique.

Exemple de demande :

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

Exemple de résultat :

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

{
    "route": {
        "destination": "10.80.231.0",
        "family": "IPv4",
        "gateway": "10.80.231.58",
        "href": "/api/network/v1/routes/route-001",
        "interface": "ixgbe0",
        "mask": 24,
        "route": "route-001",
        "type": "system"
    }
}

Add Route

Crée une route réseau. Les valeurs href de la route peuvent être modifiées lorsque d'autres routes sont ajoutées au système. En cas de création, aucune information de route n'est renvoyée car les propriétés renvoyées seraient identiques aux propriétés d'entrée. Une création réussie renvoie le code de statut HTTP 204 (Created).

Exemple de demande de création d'une route statique :

POST /api/network/v1/routes HTTP/1.1
Authorization: Basic abcd1234MWE=
Host: zfssa.example.com:215
Content-Type: application/json
Content-Length: 164

{
    "family": "IPv4",
    "destination": "0.0.0.0",
    "mask": "0",
    "gateway": "10.11.12.1",
    "interface": "ixgbe0"
}

Exemple de résultat :

HTTP/1.1 201 Created

Delete Route

Supprime une route réseau existante.

Exemple de demande :

DELETE /api/network/v1/routes/route-001 HTTP/1.1
Authorization: Basic abcd1234MWE=
Host: zfssa.example.com:215

Exemple de résultat :

HTTP/1.1 204 No Content