Rutas de red

Gestiona las rutas de red.

Tabla 7-11  Gestionar rutas de red

Solicitud Ruta /api/network/v1 Descripción POST /routes Crear una ruta de red nueva. GET /routes/<route> Obtener las propiedades de ruta de red especificadas. GET /routes Detallar todos los objetos de la ruta de la red. DELETE /routes/<route> Destruir el objeto de la ruta especificada. GET /routing Obtener propiedades de enrutamiento de red. PUT /routing Modificar propiedades de enrutamiento de red.

Tabla 7-12  Propiedades de ruta de red

Nombre Descripción type Tipo de ruta, como “system” o “static” (inmutable) family Familia de direcciones (ya sea IPv4 o IPv6) destination Dirección de destino de ruta gateway Dirección de la puerta de enlace interface Interfaz de la puerta de enlace de la red

La ruta href para cada ruta utiliza los ID de la ruta especificados en la CLI, pero estos valores pueden cambiar a medida que se modifican las rutas. La API admite la selección de rutas individuales utilizando propiedades exclusivas contenidas en la ruta. La sintaxis es routes/<name>=<value> compared to routes/route-###

Mostrar rutas

Muestra todas las rutas de red creadas en un dispositivo.

Ejemplo de solicitud:

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

Resultado de ejemplo:

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

{
    "routes": [{
        "destination": "0.0.0.0",
        "family": "IPv4",
        "gateway": "10.80.231.1",
        "href": "/api/network/v1/routing/route-000",
        "interface": "ixgbe0",
        "mask": 0,
        "route": "route-000",
        "type": "static"
    }, {
        "destination": "10.80.231.0",
        "family": "IPv4",
        "gateway": "10.80.231.58",
        "href": "/api/network/v1/routes/route-001",
        "interface": "ixgbe0",
        "mask": 24,
        "route": "route-001",
        "type": "system"
    }]
}

Obtener ruta

Obtiene las propiedades de una sola ruta.

Ejemplo de solicitud:

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

Resultado de ejemplo:

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

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

Agregar ruta

Crea una ruta de red nueva. Los valores href de la ruta pueden cambiar si se agregan otras rutas al sistema. No se devuelve información de la ruta para una ruta creada, dado que las propiedades devueltas serían idénticas a las propiedades de entrada. Una creación correcta devuelve el estado HTTP Status 204 (Created) (estado HTTP 204 [creado]).

Solicitud de ejemplo para crear una ruta estática:

POST /api/network/v1/routes HTTP/1.1
Authorization: Basic abcd1234MWE=
Host: zfssa.example.com:215
Content-Type: application/json
Content-Length: 164

{
    "family": "IPv4",
    "destination": "0.0.0.0",
    "mask": "0",
    "gateway": "10.11.12.1",
    "interface": "ixgbe0"
}

Resultado de ejemplo:

HTTP/1.1 201 Created

Suprimir ruta

Suprime una ruta de red existente.

Ejemplo de solicitud:

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

Resultado de ejemplo:

HTTP/1.1 204 No Content