Interfaces de red

Tabla 7-9  Comandos de la interfaz de la red

Solicitud Ruta /api/network/v1 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 7-10  Propiedades de interfaz de red

Nombre 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 Indicadores que muestran si la 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

Muestra todas las interfaces de red configuradas.

Ejemplo de solicitud:

GET /api/network/v1/interfaces HTTP/1.1
Authorization: Basic abcd1234MWE=
Host: zfssa.example.com:215
Accept: application/json

Ejemplo de respuesta:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 369

{
    "interfaces": {[
        "href": "/api/network/v1/interfaces/ixgbe0",
        "v4addrs": ["10.80.231.58/24"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe1",
        "v4addrs": ["10.80.231.59/24"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe2",
        "v4addrs": ["10.80.231.60/24"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe3",
        "v4addrs": ["10.80.231.61/24"]
        ...
    }]
}

Obtener interfaz de red

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 abcd1234MWE=
Host: zfssa.example.com:215
Accept: application/json

Ejemplo de respuesta:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 292

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

Crear interfaz de red

Crea una interfaz de red nueva.

Ejemplo de solicitud:

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

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

Ejemplo de respuesta:

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

Modificar interfaz de red

Modifica una interfaz de red existente.

Ejemplo de solicitud:

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

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

Ejemplo de respuesta:

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

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

Suprimir interfaz de red

Suprime una interfaz de red existente.

Ejemplo de solicitud:

DELETE /api/network/v1/interfaces/ixgbe3 HTTP/1.1
Authorization: Basic abcd1234MWE=
Host: zfssa.example.com:215

Resultado de ejemplo:

HTTP/1.1 204 No Content