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

Interfaces réseau

Table 24  Commandes de l'interface réseau

Demande Ajouter au chemin /api/network/v{1|2} 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 25  Propriétés de l'interface réseau

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

Liste des interfaces réseau

Cette commande répertorie toutes les interfaces réseau configurées.

Exemple de demande :

GET /api/network/v1/interfaces 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: 369

{
    "interfaces": {[
        "href": "/api/network/v1/interfaces/ixgbe0",
        "v4addrs": ["ipaddr-1"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe1",
        "v4addrs": ["ipaddr-2"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe2",
        "v4addrs": ["ipaddr-3"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe3",
        "v4addrs": ["ipaddr-4"]
        ...
    }]
}

Obtention d'une interface réseau

Cette commande 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 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: 292

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

Création d'une interface réseau

Cette commande crée une nouvelle interface réseau.

Exemple de demande :

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

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

Exemple de résultat :

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

Modification d'une interface réseau

Cette commande modifie une interface réseau existante.

Exemple de demande :

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

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

Exemple de résultat :

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

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

Suppression d'une interface réseau

Cette commande supprime une interface réseau existante.

Exemple de demande :

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

Exemple de résultat :

HTTP/1.1 204 No Content