--- title: "Configuración de la API - updateSocketInterface" slug: "configuration-api-updatesocketinterface" updated: 2026-07-30T02:09:30Z published: 2026-07-30T02:09:30Z canonical: "knowledge.catonetworks.com/configuration-api-updatesocketinterface" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Configuración de la API - updateSocketInterface Recomendamos encarecidamente que, antes de comenzar a usar la API de Cato, revise la [Política de Soporte para la API de Cato](/v1/docs/support-policy-for-the-cato-api). ## Visión general de updateSocketInterface Utilice la API de mutación updateSocketInterface para actualizar las siguientes configuraciones de interfaz de Socket en la sección **Socket** para un sitio en la aplicación de Gestión de Cato (Red > Sitios > {site name} > Configuración del Sitio > Socket) - Destino para la interfaz - Nombre - Configuraciones de la interfaz LAN - Ancho de banda del sitio - Configuraciones de la interfaz WAN - Fuera de la Nube (para destino Cato) - Configuraciones de interfaz WAN alternativa - Miembro de LAG (agregación de enlaces) - Tipo de VRRP ### Localizando el siteID para un Sitio El ID del sitio no se muestra en la aplicación de gestión de Cato, puedes localizar el ID del sitio: - Usando la consulta API entityLookup (ver [API de Cato - EntityLookup](/v1/docs/cato-api-entitylookup)), utiliza el `tipo` con el valor **site** También puedes utilizar el parámetro `search` con el valor como el nombre del sitio, y la consulta devuelve el ID del sitio - Número en la URL para la aplicación de gestión de Cato, cuando seleccionas un sitio (Red > Sitios > {site name}). Por ejemplo, el ID del sitio es 12345 para la siguiente URL: https://cc.catonetworks.com/#/26/sites/12345/networkAnalytics ### Comprendiendo los Valores de socketInterfaceId para un Socket El `socketInterfaceId` es un enum que contiene valores para los Sockets de Cato. Los nombres de las interfaces se muestran en la pantalla de Sockets para un sitio (Red > Sitios > {site name} > Configuración del Sitio > Socket) como sigue: - X1500 Socket - Automático, LAN1, LAN2, WAN1, WAN2, WAN3, USB1, USB2 - X1600 Socket - 1-8, USB1, USB2 - X1700 Socket - INT_1 - INT_12 ## Detalles para los Argumentos de updateSocketInterfaceInput Estos son los argumentos para actualizar las siguientes configuraciones de la interfaz de Socket para un sitio usando la API de configuración de Cato. Solo el argumento destType es obligatorio, de lo contrario incluye los argumentos para las configuraciones de la interfaz de Socket que estás actualizando. - destType - Destino para la interfaz - nombre - Nombre del sitio - lan - Configuraciones de la interfaz LAN - ancho de banda - Ancho de banda de subida y bajada del sitio - wan - Configuraciones de la interfaz WAN - offCloud - Configuraciones para **Fuera de la nube** para interfaces con el destino **Cato** - altWAN - Configuraciones para interfaces con el destino **WAN Alternativa** o **WAN Alternativa (Capa-2)** - lag - Para el destino LAN LAG Master, número mínimo de enlaces (incluyendo maestro y miembro) para esta agregación de enlaces (LAG) - vrrp - Para la configuración de alta disponibilidad (HA) de Socket, tipo de conexión VRRP entre los Sockets ### updateSocketInterfaceInput destType El destType es un argumento enum, que define el destino para la interfaz. Estas son las opciones: - CATO - Tráfico WAN para la nube de Cato - LAN - LAN interna detrás del Socket - VRRP_AND_LAN - Para HA de Socket, la interfaz se usa para tráfico LAN y VRRP - INTERFACE_DISABLED - La interfaz está deshabilitada y no está pasando tráfico - ALTERNATIVE - Tráfico WAN no sobre la nube de Cato, como MPLS - LAYER_2_WAN - Opción **WAN Alternativa (Capa-2)** para una red MPLS con sitios de Socket en el mismo subred - VRRP - Para HA de Socket, la interfaz se usa solo para tráfico VRRP - LAN_LAG_MASTER_AND_VRRP - Para HA de Socket y configuración LAN LAG, la interfaz es el Maestro LAN LAG y se usa para tráfico VRRP - LAN_LAG_MASTER - Para configuración LAN LAG, la interfaz es el Maestro LAN LAG - LAN_LAG_MEMBER - Para configuración LAN LAG, la interfaz es un miembro LAN LAG - LAN_AND_HA - Para HA de vSocket en Azure y AWS, la interfaz es para tráfico LAN y HA ### updateSocketInterfaceInput nombre El argumento `nombre` es para el nombre de la interfaz de Socket. ### updateSocketInterfaceInput lan Los argumentos `lan` son para las configuraciones de una interfaz LAN para el Socket. Estas son las opciones: - subred - Rango nativo para la interfaz LAN en formato CIDR - IP local - Dirección IP local para el rango de la red LAN ### updateSocketInterfaceInput ancho de banda Para interfaces que se usan para tráfico WAN, los argumentos `ancho de banda` definen el ancho de banda de subida y bajada para la interfaz. Estas son las opciones: - anchoDeBandaAscendente - el máximo ancho de banda ascendente para esta interfaz - anchoDeBandaDescendente - el máximo ancho de banda descendente para esta interfaz ### actualizarEntradaDeInterfazDeSocket wan Los argumentos `wan` son para la configuración de una Interfaz WAN para el Socket. Los roles WAN generalmente se utilizan para definir tráfico en las Reglas de Red. La precedencia se utiliza para la precedencia de conmutación por error para un Socket con interfaces activas y pasivas Estas son las opciones: - rol - define el rol para la Interfaz WAN: sin agrupar, Automático, wan_1, wan_2, wan_3 - precedencia - define la precedencia de conmutación por error para la interfaz: ACTIVO, PASIVO, ÚLTIMO_RECURSO [ÚLTIMO_RECURSO](/v1/docs/configuring-a-last-resort-link) es la interfaz de más baja precedencia ### actualizarEntradaDeInterfazDeSocket fueraDeLaNube Los argumentos `fueraDeLaNube` son para los sitios de Socket que utilizan la [característica Fuera de la Nube](/v1/docs/routing-traffic-to-an-off-cloud-link) para enrutar tráfico sobre Internet público en lugar de sobre la Nube Cato. Estas son las opciones: - activado - Valor Booleano, cuando `verdadero` entonces el tráfico Fuera de la Nube está habilitado para el sitio - publicIP (opcional) - Define una dirección IP pública estática para iniciar la conexión a Internet - puertoEstáticoPúblico (opcional) - Define un número de puerto estático para el tráfico Fuera de la Nube ### actualizarEntradaDeInterfazDeSocket altWan Los argumentos `altWan` son para los sitios de Socket que se conectan a una red WAN Alternativa, como MPLS. Generalmente, se utilizan IPs privadas e interfaces para conectar directamente al proveedor MPLS. Estas son las opciones: - privateInterfaceIp - Dirección IP privada para la interfaz de Socket para el tráfico - privateNetwork - Rango de IP privado (con CIDR) para la LAN - privateGatewayIp - Dirección IP privada para la puerta de enlace WAN Alternativa (como un firewall o enrutador MPLS) - privateVlanTag (opcional) - Etiqueta VLAN para la interfaz (dirección IP privada) - publicInterfaceIP (opcional) - Dirección IP pública para la interfaz de Socket para el tráfico - publicNetwork (opcional) - Rango de IP público (con CIDR) para la LAN - publicGatewayIp (opcional) - Dirección IP pública para la puerta de enlace WAN Alternativa (como un firewall o enrutador MPLS) - publicVlantag (opcional) - Etiqueta VLAN para la interfaz (dirección IP pública) ### actualizarEntradaDeInterfazDeSocket lag El argumento `lag` es para la interfaz LAN LAG maestra y define el número mínimo de interfaces (incluyendo maestra y miembro) para el LAG para este sitio de Socket. Esta es la opción: - minEnlaces - número mínimo de interfaces (enlaces) en el LAG ### actualizarEntradaDeInterfazDeSocket vrrp El argumento enum `vrrp` es para configuraciones HA de Socket y define el tipo de conexión VRRP entre los Sockets para los mensajes de keepalive. Estas son las opciones: - VIA_SWITCH - La conexión VRRP se enruta a través de un switch entre los Sockets - DIRECT_LINK - La conexión VRRP se enruta directamente entre los Sockets ## Script de Postman de Ejemplo ### Script de Ejemplo - Actualizando Rango Nativo y Nombre Este es un ejemplo de uso de la API de configuración para cambiar el nombre de la interfaz LAN1 a LAN-01, y actualizar la subred y la IP local del Rango Nativo para Socket. ```plaintext mutación actualizarInterfazDeSocket ($accountId: ID!, $siteId: ID!, $socketInterfaceId: SocketInterfaceIDEnum!, $input: UpdateSocketInterfaceInput!) {    sitio(accountId: $accountId) {        actualizarInterfazDeSocket (siteId: $siteId, socketInterfaceId: $socketInterfaceId, input: $input) {            siteId            socketInterfaceId        }    } } ``` **Variables de GraphQL** ```plaintext {    "accountId": "26",    "siteId": 26,    "socketInterfaceId": "LAN1",    "input": {        "name": "LAN-01",        "destType": "LAN",        "lan": {            "subnet": "10.0.0.0/24",            "localIp": "10.0.0.1"        }    } } ``` ### Script de Ejemplo - Cambiando Ancho de Banda y Nombre Este es un ejemplo de uso de la API de configuración para cambiar el ancho de banda y el nombre para la interfaz WAN. ```plaintext mutación actualizarInterfazDeSocket ($accountId: ID!, $siteId: ID!, $socketInterfaceId: SocketInterfaceIDEnum!, $input: UpdateSocketInterfaceInput!) {    sitio(accountId: $accountId) {        actualizarInterfazDeSocket (siteId: $siteId, socketInterfaceId: $socketInterfaceId, input: $input) {            siteId            socketInterfaceId        }    } } ``` **Variables de GraphQL** ```plaintext {    "accountId": "26",    "siteId": 126,    "socketInterfaceId": "WAN1",    "input": {        "name": "WAN Demo",        "destType": "CATO",        "bandwidth": {            "upstreamBandwidth": 100,            "downstreamBandwidth": 100        }    } } ``` ### Recursos relacionados - [Usando la API de Creación de Sitios Cato con Postman (EA)](/v1/docs/using-the-cato-site-creation-api-with-postman) - [Scripts de API de Configuración](https://support.catonetworks.com/hc/en-us/articles/8130916998429)