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

Rutas de red

Estos comandos gestionan rutas de red.

Tabla 26  Gestionar rutas de red

Solicitud Anexar a la ruta de acceso /api/network/v{1|2} 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 27  Gestionar propiedades de ruta de red

Propiedad 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 en lugar de 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 Tm8gcGVla2luZyE=
Host: zfs-storage.example.com:215
Accept: application/json

Resultado de ejemplo:

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

{
    "routes": [{
        "destination": "ipaddr-0",
        "family": "IPv4",
        "gateway": "ipaddr-1",
        "href": "/api/network/v1/routing/route-000",
        "interface": "ixgbe0",
        "mask": 0,
        "route": "route-000",
        "type": "static"
    }, {
        "destination": "ipaddr-2",
        "family": "IPv4",
        "gateway": "ipaddr-3",
        "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=ipaddr-1 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: 192

{
    "route": {
        "destination": "ipaddr-1",
        "family": "IPv4",
        "gateway": "ipaddr-2",
        "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 Tm8gcGVla2luZyE=
Host: zfs-storage.example.com:215
Content-Type: application/json
Content-Length: 164

{
    "family": "IPv4",
    "destination": "ipaddr-0",
    "mask": "0",
    "gateway": "ipaddr-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 Tm8gcGVla2luZyE=
Host: zfs-storage.example.com:215

Resultado de ejemplo:

HTTP/1.1 204 No Content