Enlaces de datos de red

El comando de enlaces de datos de red brinda una administración de los enlaces de datos en el dispositivo. Puede detallar, modificar, crear y suprimir recursos de enlaces de datos.

Tabla 7-1  Comandos de enlaces de datos de red

Solicitud Ruta /network/v1 Descripción POST /datalinks Crear un enlace de datos de red nuevo. GET /datalinks/<datalink> Obtener las propiedades de los enlaces de datos de la red especificada. GET /datalinks Detallar todos los objetos de los enlaces de datos de la red. PUT /datalinks/<datalink> Modificar el objeto de enlace de datos especificado de la red. DELETE /datalinks/<datalink> Destruir el objeto del enlace de datos especificado.

Tabla 7-2  Propiedades del enlace de datos del dispositivo físico

Propiedad Tipo Descripción class String “dispositivo” (“inmutable”) label NetworkLabel Etiqueta links ChooseOne Enlaces [“igb1”, “igb0”, “ixgbe2”, “ixgbe3”, “igb4”, “igb3”, “ixgbe1”, “igb2”, “igb5”] jumbo Boolean Utilizar tramas de pausa [“true”, “false”] (“deprecated”) mtu PositiveInteger Unidad de transmisión máxima (MTU) speed ChooseOne Velocidad del enlace [“auto”, “10”, “100”, “1000”, “10000”] duplex ChooseOne Enlace del dúplex [“auto”, “half”, “full”]

Tabla 7-3  Propiedades del enlace de datos del dispositivo VNIC

Propiedad Tipo Descripción class String “vnic” (“inmutable”) label NetworkLabel Etiqueta links ChooseOne Enlaces [“ixgbe0”] mtu PositiveInteger Unidad de transmisión máxima (MTU) id VLAN ID de VLAN

Tabla 7-4  Propiedades del enlace de datos del dispositivo VLAN

Propiedad Tipo Descripción class String “vlan” (“inmutable”) label NetworkLabel Etiqueta links ChooseOne Enlaces [“ixgbe0”] mtu PositiveInteger Unidad de transmisión máxima (MTU) id VLAN ID de VLAN

Tabla 7-5  Propiedades del enlace de datos del dispositivo basado en la agregación

Propiedad Tipo Descripción class String “agregación” (“inmutable”) label NetworkLabel Etiqueta links ChooseN Enlaces [“igb1”, “igb0”, “ixgbe2”, “ixgbe3”, “igb4”, “igb3”, “ixgbe1”, “igb2”, “igb5”] jumbo Boolean Utilizar tramas de pausa [“true”, “false”] (“deprecated”) mtu PositiveInteger Unidad de transmisión máxima (MTU) policy ChooseOne Política [“L2”, “L3”, “L4”, “L2+L3”, “L2+L4”, “L3+L4”] modo ChooseOne Modo [“active”, “passive”, “off”] temporizador ChooseOne Temporizador [“short”, “long”] key Integer Clave de agregación (“inmutable”)

Tabla 7-6  Propiedades del enlace de datos del dispositivo basado en partición IP

Propiedad Tipo Descripción class String “partición” (“inmutable”) label NetworkLabel Etiqueta links ChooseOne Enlaces pkey Pkey Clave de partición linkmode ChooseOne Modo de enlace [“cm”, “ud”]

Mostrar enlaces de datos de la red.

Marca todos los enlaces de datos configurados en el dispositivo. Cada objeto en la lista de enlaces de datos contiene una href para obtener la operación en un solo recurso de enlace de datos junto con las propiedades del enlace de datos.

Ejemplo de solicitud:

GET /api/network/v1/datalinks HTTP/1.1
Host: zfs-storage.example.com
Accept: application/json

Ejemplo de datos JSON:

{
    "datalinks": [{
        "href": "/api/network/v1/datalinks/ixgbe0",
        ...
    }, {
        "href": "/api/network/v1/datalinks/ixgbe1",
        ...
    }, {
        "href": "/api/network/v1/datalinks/ixgbe2",
        ...
    }, {
        "href": "/api/network/v1/datalinks/ixgbe3",
        ...
    }]
}

Obtener enlace de datos de la red

El método GET devuelve un objeto JSON que contiene una propiedad de datos con una lista de objetos de enlaces de datos.

GET /api/network/v1/datalinks/ixgbe0 HTTP/1.1 Host: zfs-storage.example.com

Accept: application/json

Ejemplo de datos JSON:

{
    "datalink": {
        "class": "device",
        "datalink": "ixgbe0",
        "duplex": "auto",
        "href": "/api/network/v1/datalinks/ixgbe0",
        "jumbo": false,
        "label": "Untitled Datalink",
        "links": [
            "ixgbe0"
        ],
        "mac": "0:21:28:a1:d9:68",
        "mtu": 1500,
        "speed": "auto"
    }
}

Crear enlace de datos de la red

El comando POST crea un nuevo enlace de datos. Una propiedad adicional que se necesita cuando se crea un nuevo enlace de datos es la propiedad de clase, que define la clase de enlace de datos a crear. La clase de enlaces de datos se define durante la creación de enlaces de datos, y puede ser de uno de los siguientes tipos.

• device: crea un enlace de datos basado en dispositivos.

• vnic: crea un enlace de datos basado en VNIC.

• vlan: crea un enlace de datos basado en VLAN.

• aggregation: crea un enlace de datos basado en la agregación.

• partition: crea un enlace de datos basado en la partición de IB.

El mapa de propiedades para las mismas propiedades disponibles en el menú “configuration net datalinks”.

Ejemplo de solicitud:

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

{
    "class": "device",
     "jumbo": true,
     "links": ["ixgbe2"],
     "label": "TestDataLink"
}

Ejemplo de respuesta:

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

Modificar enlace de datos de la red

El método PUT se usa para modificar las propiedades del enlace de datos. Para obtener detalles sobre la configuración de enlaces de datos, consulte la documentación de CLI.

Ejemplo de solicitud:

PUT /api/network/v1/datalinks/ixgbe2 HTTP/1.1

{"jumbo": true}

Ejemplo de respuesta:

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

{
    "datalink": {
        "href": "/api/network/v1/datalinks/ixgbe2",
        "class": "device",
        "label": "MyDataLink",
        "links": ["ixgbe2"],
        "mac": "0:21:28:a1:d9:6a",
        "mtu": 9000,
        "duplex": "auto",
        "jumbo": true,
        "speed": "auto"
    }
}

Suprimir enlace de datos de la red

Este comando elimina un enlace de datos del sistema. Use la ruta href para suprimir el enlace de datos especificado.

Ejemplo de solicitud:

DELETE /api/network/v1/datalinks/ixgbe2 HTTP/1.1

Ejemplo de respuestas:

HTTP/1.1 204 No Content