Press CTRL+K to open search

Configuración de la API - updateSocketInterface

  • Actualizado en Jul 30, 2026
  • Publicado el Jul 1, 2026
  • 6 minuto(s) leído(s)
Prev Next

Recomendamos encarecidamente que, antes de comenzar a usar la API de Cato, revise la Política de Soporte para la API de Cato.

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), 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 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 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.

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

{
    "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.

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

{
    "accountId": "26",
    "siteId": 126,
    "socketInterfaceId": "WAN1",
    "input": {
        "name": "WAN Demo",
        "destType": "CATO",
        "bandwidth": {
            "upstreamBandwidth": 100,
            "downstreamBandwidth": 100
        }
    }
}

Artículos relacionados