Gère les routes 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-###
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" }] }
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" } }
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
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