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

Recomendamos encarecidamente que antes de empezar a usar la API de Cato, revise la Política de Soporte Técnico Siempre Activa 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 con la cual está configurando la configuración a través de la API de Cato.

Localización del siteID para un Sitio

El ID del sitio no se muestra en la Aplicación de Gestión de Cato, puede localizar el ID del sitio:

Usando la consulta API entityLookup (ver API de Cato - EntityLookup), utilice el tipo con el valor site

También puede 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 seleccionó un sitio (Network > Sites > {nombre del sitio}). 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 ejemplo de Postman

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

Variables GraphQL

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

Recursos Relacionados