--- title: "API de Configuración - Añadir, Actualizar y Eliminar staticHost" slug: "configuration-api-adding-updating-and-removing-statichost" updated: 2026-07-30T02:09:29Z published: 2026-07-30T02:09:29Z canonical: "knowledge.catonetworks.com/configuration-api-adding-updating-and-removing-statichost" --- > ## 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 - Añadir, Actualizar y Eliminar staticHost 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). 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](/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 ## 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](/v1/docs/cato-api-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 ```plaintext mutación addStaticHost ($accountId: ID!, $siteId: ID!, $input:AddStaticHostInput!) {    site(accountId: $accountId) {      addStaticHost(        siteId: $siteId,        input: $input      ) {      hostId    }  } } ``` **Variables de GraphQL** ```plaintext {    "accountId": "26",    "siteId": 126,    "input": {        "primaryManagementIp": "192.168.4.2",        "secondaryManagementIp": "192.168.4.3",        "vrid": 100    } } ``` **Recursos Relacionados** - [Usando la API de Creación de Sitios Cato con Postman](/v1/docs/usar-la-api-de-creación-de-sitios-de-cato-con-postman) - [Scripts de API de Configuración](https://support.catonetworks.com/hc/en-us/articles/8130916998429)