---
title: Entidad de interfaces (v3)
slug: develop/es/entidad-de-interfaces-v3
docTags: 
createdAt: 2025-03-11T07:03:28.938Z
---

Una matriz de información sobre cualquier interfaz de red.

El orden de los objetos de interfaz indica la prioridad (“metric“) de cada interfaz. El primer objeto de interfaz en la matriz es la interfaz de mayor prioridad y el tráfico se enviará a esa interfaz si hay una conexión activa. Todas las demás interfaces se consideran interfaces secundarias. Consulte [esta página](docId:0WMnKXWCvc8wkbC4lL137) para obtener más información.

Las propiedades que se muestran dependerán del tipo de interfaz. La entidad interfaces contiene las siguientes propiedades obligatorias:

- `identificación` <font color="#704ae0">string</font> <font color="#01a0af">required</font>: El tipo de interfaz de red (por ejemplo, "wireless\_wlan0" o "wired\_eth0")
- `nombre` <font color="#704ae0">string</font> <font color="#01a0af">required</font>: Un nombre de interfaz de red de destino (por ejemplo, "wlan0", "eth0", "usb0" o "ppp0")
- `tipo` <font color="#704ae0">string</font> <font color="#01a0af">required</font>: El tipo de interfaz del reproductor (uno de "Ethernet", "Cellular", "WiFi", "Virtual" u "Other")
- `proto` <font color="#704ae0">string</font> <font color="#01a0af">required</font>: Un protocolo de configuración o una interfaz de red determinada, como "Static" o "DHCPv4"
- `ssid` <font color="#704ae0">string</font> <font color="#01a0af">required</font>: El nombre de la red inalámbrica, que es obligatorio si la interfaz es WLAN.

Estas propiedades opcionales también pueden utilizarse:

- `ip`  <font color="#704ae0">string[]</font> <font color="#704ae0">or </font><font color="#704ae0">null</font> <font color="#01a0af">optional</font>: Una matriz de direcciones IPv4 de destino (en notación CIDR) para aplicar mediante la interfaz de red actual.
- `puerta de enlace` <font color="#704ae0">string or null</font> <font color="#01a0af">optional</font>: Una dirección IPv4 del reproductor.
- `dns` <font color="#704ae0">string[]</font> <font color="#01a0af">optional</font>: Una matriz de direcciones DNS del dispositivo
- `rateLimitDuringInitialDownloads` <font color="#704ae0">int or null</font> <font color="#01a0af">optional</font>: El límite de velocidad de datos para descargar contenido durante las descargas iniciales.
- `rateLimitInsideContentDownloadWindow`<font color="#704ae0"> int or null</font> <font color="#01a0af">optional</font>: El límite de velocidad de datos durante las descargas de contenido.
- `rateLimitOutsideContentDownloadWindow` <font color="#704ae0">int or null</font> <font color="#01a0af">optional</font>: La limitación de velocidad de datos cuando no se está descargando contenido.
- `contentDownloadEnabled` <font color="#704ae0">bool</font> <font color="#01a0af">optional</font>: Si es true, los datos de contenido se pueden descargar mediante esta conexión. True es el valor predeterminado.
- `textFeedsDownloadEnabled` <font color="#704ae0">bool</font> <font color="#01a0af">optional</font>: Si es true, los datos de feeds de texto se pueden descargar mediante esta conexión. True es el valor predeterminado.
- `mediaFeedsDownloadEnabled` <font color="#704ae0">bool</font> <font color="#01a0af">optional</font>: Si es true, los datos de feeds multimedia se pueden descargar mediante esta conexión. True es el valor predeterminado.
- `healthReportingEnabled` <font color="#704ae0">bool</font> <font color="#01a0af">optional</font>: Si es true, la carga de datos de informes de estado está habilitada mediante esta conexión. True es el valor predeterminado.
- `logsUploadEnabled` <font color="#704ae0">bool</font> <font color="#01a0af">optional</font>: Si es true, la carga de actualizaciones de registros está habilitada mediante esta conexión. True es el valor predeterminado.
- `frase de contraseña` <font color="#704ae0">string</font> <font color="#01a0af">optional</font>: La contraseña de la red inalámbrica
- `seguridad` <font color="#704ae0">object</font> <font color="#01a0af">optional</font>: Si se proporciona esto, los siguientes campos son obligatorios:
- `autenticación` <font color="#704ae0">object</font>:
  - `modo` <font color="#704ae0">string</font>: Los posibles modos de red son "Shared", "Open", "EAP" u "Other". El valor predeterminado es “Shared”
  - `frase de contraseña` <font color="#704ae0">string</font>: La contraseña cifrada para la red, si existe
- `cifrado` <font color="#704ae0">object:</font>
  - `modo` <font color="#704ae0">string</font>: Los posibles modos de cifrado son "None", "WEP", "TKIP", "CCMP", "TKIP,CCMP" u "Other". El valor predeterminado es “TKIP,CCMP”.
- `wpaSettings` <font color="#704ae0">object</font> <font color="#01a0af">optional</font>: Si se proporciona esto, los siguientes campos son obligatorios:
  - `enableWPAEnterpriseAuthentication` <font color="#704ae0">bool</font>: Si es true, la autenticación mediante 802.1x (para conexiones cableadas) o WPA Enterprise Authentication (para conexiones inalámbricas) está habilitada.
  - `wpaEnterpriseVariant` <font color="#704ae0">string</font>: Ya sea WPAEnterpriseEapTls o WPAEnterprisePeap
  - `eapCertificateType` <font color="#704ae0">string</font>: Ya sea WPAEapTlsPKCS o WPAEapTlsPEMorDER
  - `eapCertificateFile` <font color="#704ae0">object</font>: Un objeto artifact que tiene un nombre (que es una string) y un asset (que es un archivo de certificado). Esto puede tomar el valor predeterminado null si no es aplicable.
  - `eapCertificatePassphrase` <font color="#704ae0">string</font>: Una frase de contraseña para proteger el certificado del cliente. Esto puede tomar el valor predeterminado null si no es aplicable.
  - `eapPemOrDerKeyFile` <font color="#704ae0">object</font>: Un objeto artifact que tiene un nombre (que es una string) y un asset (que es un archivo de certificado X.509 codificado en PEM o DER).  Esto puede tomar el valor predeterminado null si no es aplicable.
  - `peapUsername` <font color="#704ae0">string</font>: El nombre de usuario de PEAP para la autenticación. Esto puede tomar el valor predeterminado null si no es aplicable.
  - `peapPassphrase` <font color="#704ae0">string</font>: La contraseña de PEAP para la autenticación. Esto puede tomar el valor predeterminado null si no es aplicable.
  - `caCertificateFile` <font color="#704ae0">object</font>: Un objeto artifact que tiene un nombre (que es una string) y un asset (que es un archivo de certificado CA PEM/DER). Esto puede tomar el valor predeterminado null si no es aplicable.