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.

API de Configuración - addSocketSite

  • Actualizado en Jul 30, 2026
  • Publicado el Jul 1, 2026
  • 3 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.

Descripción general de addSocketSite

Utilice la API de mutación addSocketSite para crear un nuevo sitio de Socket en su cuenta y definir las siguientes configuraciones para el sitio:

  • Nombre

  • Descripción

  • Tipo

  • Tipo de conexión

  • Zona horaria

  • País

  • Estado

  • Dirección

  • Rango Nativo

El sitio se crea con configuraciones de ancho de banda predeterminadas, 25 Mbps de bajada y 25 Mbps de subida, y se crea sin una licencia asignada.

Para cuentas de revendedores, puede crear claves API separadas dentro de cada cuenta de cliente que esté configurando con la API de Cato.

Ubicación del accountId para su Cuenta

Este ID de Cuenta no se muestra en la Aplicación de Gestión de Cato, en su lugar es el número en la URL para la Aplicación de Gestión de Cato. Por ejemplo, el ID de Cuenta es 26 para la siguiente URL: https://cc.catonetworks.com/#!/26/topology.

Ingrese este ID en el argumento accountId para la API de creación de sitio, por ejemplo:

site(accountId: 26) {
    addSocketSite(input: $addSocketSite) { 
        siteId 
    } 
}

Detalles para los Argumentos de addSocketSite

Estos son los argumentos para crear un nuevo sitio de Socket utilizando la API de configuración de Cato. Los argumentos son obligatorios a menos que se indiquen como opcionales:

  • nombre - Nombre del sitio

  • connectionType - Socket Físico o vSocket para este sitio

  • tipoDeSitio - Tipo de sitio en su organización, por ejemplo Centro de Datos en la Nube

  • descripción - (opcional) Descripción del sitio

  • nativeNetworkRange - Rango IP para LAN nativa detrás del sitio, en formato CIDR

  • ubicaciónDelSitio - Datos sobre la ubicación física del sitio

Nombre de AddSocketSite

Defina el nombre del sitio de Socket que está creando.

Tipo de conexión de AddSocketSite

El connectionType es un argumento enum que define el tipo de Socket físico o virtual para el sitio.

Estas son las opciones:

  • SOCKET_X1500 - Socket X1500 o X1500B para un sitio físico

  • SOCKET_X1600 - Socket X1600 para un sitio físico

  • SOCKET_X1700 - Socket X1700 o X1700B para un sitio físico

  • SOCKET_ESX - vSocket para un sitio virtual VMware

  • SOCKET_AWS - vSocket para un sitio virtual AWS

  • SOCKET_AZURE - vSocket para un sitio virtual Azure

Tipo de sitio de AddSocketSite

El tipoDeSitio es un argumento de enumeración que define el tipo de sitio que determina qué icono se utiliza para el sitio en la pantalla de Supervisión > Topología en la Aplicación de Gestión de Cato.

Estas son las opciones:

  • SUCURSAL - Sitios físicos o virtuales

  • SEDE - Sitios físicos para sedes corporativas

  • NUBE_CD - Sitios virtuales para centros de datos basados en la nube

  • CENTRO_DE_DATOS - Sitios físicos para centros de datos

Descripción de AddSocketSite (Opcional)

La descripción es un campo de texto libre opcional para describir el sitio.

Rango de red nativo de AddSocketSite

Defina el rango IP para el rango nativo de LAN para el sitio en el argumento nativeNetworkRange en el formato IPSubnet. El rango nativo utiliza CIDR para la subred, y los bloques CIDR /32 no son compatibles.

Ubicación del sitio de AddSocketSite

Los argumentos ubicaciónDelSitio definen los siguientes detalles físicos para el sitio. El códigoDePaís es relevante para el número de licencias de sitio que están disponibles para una Región específica en su cuenta.

Puede utilizar la consulta API entityLookup para recuperar valores para estos argumentos, consulte API de Cato - EntityLookup.

Estos son los argumentos ubicaciónDelSitio:

  • códigoDePaís - Código de dos letras (ISO 3166-1 alpha-2) para el país donde se encuentra el sitio

    Para entityLookup, utilice el tipo con el valor país

  • códigoDeEstado - (Opcional) Para los países aplicables, el estado donde se encuentra el sitio

    Para entityLookup, utilice el tipo con el valor estadoPaís

  • zona horaria - Zona horaria para el sitio, utilizada para establecer el marco de tiempo para la ventana de mantenimiento para actualizaciones de Socket y vSocket

    Para entityLookup, utilice el tipo con el valor zona horaria

  • dirección - (Opcional) Dirección de la calle para el sitio físico

Script de Postman de Ejemplo

mutación addSocketSite ($accountId: ID!, $input: AddSocketSiteInput!) {
    site(accountId: $accountId) {
        addSocketSite (input: $input) {
            siteId
        }
    }
}

Variables de GraphQL

{
    "accountId": "26",
    "input": {
        "name": "SampleUsSite2",
        "description": "Mi primer sitio API",
        "siteType": "BRANCH",
        "connectionType": "SOCKET_X1500",
        "nativeNetworkRange": "10.0.0.0/24",
        "siteLocation": {
            "countryCode": "US",
            "timezone": "US/Central",
            "stateCode": "US-AL"
        }
    }
}

Recursos Relacionados

Artículos relacionados