Guía de la API de RESTful de Oracle^® ZFS Storage Appliance (versión OS8.8.x)

Interfaces de red

Tabla 24  Comandos de la interfaz de la red

Solicitud Anexar a la ruta de acceso /api/network/v{1|2} Descripción POST /interfaces Crear un enlace de datos de interfaz de red nuevo. GET /interfaces/interface Obtener las propiedades de interfaz de red especificadas. GET /interfaces Mostrar todos los objetos de interfaz de red. PUT /interfaces/interface Modificar el objeto de interfaz de red especificado. DELETE /interfaces/interface Destruir el objeto especificado de la interfaz.

Tabla 25  Propiedades de interfaz de red

Propiedad Descripción admin Indicador que muestra si se admite la administración en esta interfaz. class Tipo de clase ("ip", "ipmp") (inmutable después de la creación). curaddrs Direcciones IP actuales (inmutable). enable Indicador que muestra si esta interfaz está activada. label Etiqueta de usuario para la interfaz. links Seleccionar un enlace de red para esta interfaz. state Estado de la interfaz (inmutable). v4addrs Direcciones IPv4. v6dhcp Indicador IPv4 DHCP. v6addrs Direcciones IPv6. v6dhcp Indicador IPv6 DHCP.

Mostrar interfaces de red

Este comando muestra todas las interfaces de red configuradas.

Ejemplo de solicitud:

GET /api/network/v1/interfaces HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
Host: zfs-storage.example.com:215
Accept: application/json

Resultado de ejemplo:

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"]
        ...
    }]
}

Obtener interfaz de red

Este comando obtiene la lista completa de propiedades para una interfaz de red especificada.

Ejemplo de solicitud:

GET /api/network/v1/interfaces/ixgbe0 HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
Host: zfs-storage.example.com:215
Accept: application/json

Resultado de ejemplo:

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
    }
}

Crear interfaz de red

Este comando crea una interfaz de red nueva.

Ejemplo de solicitud:

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"
}

Resultado de ejemplo:

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

Modificar interfaz de red

Este comando modifica una interfaz de red existente.

Ejemplo de solicitud:

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

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

Resultado de ejemplo:

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
}

Suprimir interfaz de red

Este comando suprime una interfaz de red existente.

Ejemplo de solicitud:

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

Resultado de ejemplo:

HTTP/1.1 204 No Content