Go to main content

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

Quitter la vue de l'impression

Mis à jour : Août 2021
 
 

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.


Remarque -  Lorsqu'une interface est supprimée, toutes les routes qui lui sont associées le sont également.

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