--- title: "API de Configuração - Adicionando, Atualizando, e Removendo staticHost" slug: "configuration-api-adding-updating-and-removing-statichost" updated: 2026-07-30T01:47:44Z published: 2026-07-30T01:47:44Z 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 Configuração - Adicionando, Atualizando, e Removendo staticHost Recomendamos fortemente que, antes de começar a usar a Cato API, revise a [Política de Suporte para a Cato API](/v1/docs/support-policy-for-the-cato-api). Este artigo explica como usar a API Cato para gerenciar hosts definidos para um site com esses comandos: - addStaticHost - updateStaticHost - removeStaticHost ## Visão geral de staticHost Use as APIs de mutação staticHost para adicionar, atualizar e remover hosts de um site na sua conta e definir as seguintes configurações para o host: - Nome do Host - Endereço IP do host - Endereço MAC (opcional - usado para reservar uma atribuição de IP DHCP para o host) Para contas de revendedores, você pode criar chaves de API separadas dentro de cada conta de cliente que está configurando as configurações com a API da Cato. ### Localizando o siteID para um Site O ID do site não é exibido no Aplicativo de Gerenciamento Cato, você pode localizar o ID do site: - Usando a consulta de API entityLookup (veja [Cato API - EntityLookup](/v1/docs/cato-api-entitylookup)), use o `tipo` com o valor **site** Você também pode usar o parâmetro `search` com o valor como o nome do site, e a consulta retorna o ID do site - Número na URL para o Aplicativo de Gerenciamento Cato, quando você selecionou um site (Network > Sites > {site name}). Por exemplo, o ID do site é 12345 para a seguinte URL: https://cc.catonetworks.com/#/26/sites/12345/networkAnalytics ## Detalhes para os Argumentos addStaticHost e updateStaticHost Os mesmos argumentos são usados para criar ou atualizar um host por trás de um site usando a API de configuração Cato. Para `addStaticHost`, os argumentos são obrigatórios a menos que marcado como opcional. Para `updateStaticHost`, inclua os argumentos para as configurações do host que você está atualizando. - hostId - Para `updateStaticHost`, insira o ID do host que você está atualizando Para `addStaticHost`, esse ID é gerado quando o novo host é criado - nome - Nome do Host atrás do site - ip - Endereço IP do host atrás do site - macAddress - (opcional) Endereço MAC do host atrás do site O endereço MAC do host é usado para reserva DHCP para hosts com endereço IP estático ### StaticHost hostId O `hostId` é o ID interno Cato para a entidade do host. O `networkRangeId` pode ser recuperado usando a API de leitura [entityLookup](/v1/docs/cato-api-entitylookup), use o `tipo` com o valor **host** ### StaticHost nome Use o argumento `nome` para definir o Nome do Host. ### StaticHost ip Use o argumento `ip` para definir o endereço IP do host. ### StaticHost macAddress (Opcional) Use o argumento `macAddress` para definir o endereço MAC do host para reserva DHCP. Para contas que usam Cato como o servidor DHCP, o endereço IP dos hosts definidos com um endereço MAC é reservado e não pode ser atribuído a um host diferente. Certifique-se de que o endereço IP para o host não esteja dentro da faixa DHCP para um segmento de rede definido para o site. ## removeStaticHost Use a API `removeStaticHost` para deletar um host que está definido para um site. Você só precisa usar o `hostId` com esta API. ## Script Exemplo do Postman ```plaintext mutation addStaticHost ($accountId: ID!, $siteId: ID!, $input:AddStaticHostInput!) {    site(accountId: $accountId) {      addStaticHost(        siteId: $siteId,        input: $input      ) {      hostId    }  } } ``` **Variáveis do GraphQL** ```plaintext {    "accountId": "26",    "siteId": 126,    "input": {        "primaryManagementIp": "192.168.4.2",        "secondaryManagementIp": "192.168.4.3",        "vrid": 100    } } ``` **Recursos Relacionados** - [Usando a API de Criação de Site da Cato com Postman](/v1/docs/usando-a-api-de-criação-de-site-cato-com-postman) - [Scripts da API de Configuração](https://support.catonetworks.com/hc/en-us/articles/8130916998429)