Enlaces de Datos de Red

Idioma:

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 16 Comandos de enlaces de datos de red

Solicitud	Anexar a la ruta de acceso /network/v{1\|2}	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 17 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 18 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 19 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 20 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”]
`mode`	ChooseOne	Modo [“active”, “passive”, “off”]
`timer`	ChooseOne	Temporizador [“short”, “long”]
`key`	Integer	Clave de agregación (“inmutable”)

Tabla 21 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:215
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 enlace de datos con una lista de objetos de enlace de datos.

GET /api/network/v1/datalinks/ixgbe0 HTTP/1.1
Host: zfs-storage.example.com:215
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 class, que define la clase de enlace de datos que se debe 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.

Las propiedades se asignan a las mismas propiedades de la CLI disponibles en el menú "configuration net datalinks".

Ejemplo de solicitud:

POST /api/network/v1/datalinks 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": "device",
    "jumbo": true,
    "links": ["ixgbe2"],
    "label": "TestDataLink"
}

Resultado de ejemplo:

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}

Resultado de ejemplo:

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

Resultado de ejemplo:

HTTP/1.1 204 No Content