Guide RESTful API des systèmes Oracle^® ZFS Storage Appliance, version OS8.8.x

Routes réseau

Ces commandes gèrent les routes réseau.

Table 26  Gestion des routes réseau

Demande Ajouter au chemin /api/network/v{1|2} 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 route spécifié GET /routing Obtention des propriétés du routage réseau PUT /routing Modification des propriétés du routage réseau

Table 27  Gestion des propriétés des routes réseau

Propriété 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-###.

Liste des 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 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: 192

{
    "routes": [{
        "destination": "ipaddr-0",
        "family": "IPv4",
        "gateway": "ipaddr-1",
        "href": "/api/network/v1/routing/route-000",
        "interface": "ixgbe0",
        "mask": 0,
        "route": "route-000",
        "type": "static"
    }, {
        "destination": "ipaddr-2",
        "family": "IPv4",
        "gateway": "ipaddr-3",
        "href": "/api/network/v1/routes/route-001",
        "interface": "ixgbe0",
        "mask": 24,
        "route": "route-001",
        "type": "system"
    }]
}

Obtention d'une route

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

Exemple de demande :

GET /api/network/v1/routes/destination=ipaddr-1 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: 192

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

Ajout d'une 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 Tm8gcGVla2luZyE=
Host: zfs-storage.example.com:215
Content-Type: application/json
Content-Length: 164

{
    "family": "IPv4",
    "destination": "ipaddr-0",
    "mask": "0",
    "gateway": "ipaddr-1",
    "interface": "ixgbe0"
}

Exemple de résultat :

HTTP/1.1 201 Created

Suppression d'une route

Supprime une route réseau existante.

Exemple de demande :

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

Exemple de résultat :

HTTP/1.1 204 No Content