Press CTRL+K to open search

API de Configuración - Añadir, Actualizar y Eliminar staticHost

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

Este artículo explica cómo usar la API de Cato para gestionar los hosts que están definidos para un sitio con estos comandos:

  • addStaticHost

  • updateStaticHost

  • removeStaticHost

Descripción general de staticHost

Utilice las APIs de mutación staticHost para agregar, actualizar y eliminar hosts para un sitio en su cuenta y definir las siguientes configuraciones para el host:

  • Nombre del host

  • Dirección IP del host

  • Dirección MAC (opcional - utilizada para reservar una asignación IP DHCP para el host)

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

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

Detalles de los Argumentos addStaticHost y updateStaticHost

Se utilizan los mismos argumentos para crear o actualizar un host detrás de un sitio utilizando la API de configuración de Cato. Para addStaticHost, los argumentos son obligatorios a menos que se marquen como opcionales. Para updateStaticHost, incluya los argumentos para las configuraciones del host que está actualizando.

  • hostId - Para updateStaticHost, introduzca el ID del host que está actualizando

    Para addStaticHost, este ID se genera cuando se crea el nuevo host

  • name - Nombre del host detrás del sitio

  • ip - Dirección IP del host detrás del sitio

  • macAddress - (opcional) Dirección MAC del host detrás del sitio

    La dirección MAC del host se utiliza para la reserva DHCP para hosts con una dirección IP estática

StaticHost hostId

El hostId es el ID interno de Cato para la entidad de host.

El networkRangeId se puede recuperar utilizando la API de solo lectura entityLookup, utilice el tipo con el valor host

StaticHost nombre

Utilice el argumento name para definir el nombre del host.

StaticHost ip

Utilice el argumento ip para definir la dirección IP del host.

StaticHost macAddress (Opcional)

Utilice el argumento macAddress para definir la dirección MAC del host para la reserva DHCP.

Para las cuentas que utilizan a Cato como el servidor DHCP, la dirección IP de los hosts definidos con una dirección MAC está reservada y no puede ser asignada a un host diferente. Asegúrese de que la dirección IP del host no esté dentro del rango DHCP para un segmento de red definido para el sitio.

removeStaticHost

Utilice la API removeStaticHost para eliminar un host que está definido para un sitio. Solo necesita utilizar el hostId con esta API.

Script de Postman de Ejemplo

mutación addStaticHost ($accountId: ID!, $siteId: ID!, $input:AddStaticHostInput!) {
    site(accountId: $accountId) {
      addStaticHost(
        siteId: $siteId, 
        input: $input
      ) {
      hostId
    }
  }
}

Variables de GraphQL

{
    "accountId": "26",
    "siteId": 126,
    "input": {
        "primaryManagementIp": "192.168.4.2",
        "secondaryManagementIp": "192.168.4.3",
        "vrid": 100
    }
}

Recursos Relacionados

Artículos relacionados