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 31 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 32 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 33 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 34 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 35 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 36 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