--- title: "API de Configuração - updateHa" slug: "configuration-api-updateha" updated: 2026-07-30T01:47:46Z published: 2026-07-30T01:47:46Z canonical: "knowledge.catonetworks.com/configuration-api-updateha" --- > ## 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 - updateHa 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). ## Visão Geral do updateHa Use a mutação API `updateHa` para atualizar as seguintes configurações na seção **Socket** para um site com configuração de Alta Disponibilidade (HA) de Socket no Cato Management Application (Network > Sites > {site name} > Site Configuration > Socket): - Endereço IP de gerenciamento para o Socket primário e secundário - VRID - ID para mensagens VRRP que identifica quando o Socket primário está indisponível e quando está funcional novamente > [!NOTE] > Nota: > > Você só pode executar a API `updateHa` após ambos os sockets serem atribuídos a um site, e ele estiver configurado como um site HA de Socket usando o Aplicativo de Gerenciamento 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 site ID - Número na URL para o Aplicativo de Gerenciamento Cato, quando você selecionou um site (Network > Sites > {site name}). Por exemplo, o site ID é 12345 para a seguinte URL: https://cc.catonetworks.com/#/26/sites/12345/networkAnalytics ## Detalhes para os Argumentos de updateHa Estes são os argumentos para atualizar as configurações de HA Socket para um site usando a API de configuração do Cato. Todos os argumentos `updateHaInput` são opcionais: - primaryManagementIp - Endereço IP de gerenciamento para o Socket primário - secondaryManagementIp - Endereço IP de gerenciamento para o Socket secundário - VRID - Identificador de roteador virtual para as mensagens VRRP ### updateHaInput primaryManagementIp Atualize o endereço IP de gerenciamento para o Socket primário. Você pode usar este endereço IP para acessar o Socket WebUI para o Socket primário. ### updateHaInput secondaryManagementIp Atualize o endereço IP de gerenciamento para o Socket secundário. Você pode usar este endereço IP para acessar o Socket WebUI para o Socket secundário. ### updateHaInput vrid Atualize o VRID (Identificador de Roteador Virtual) para as mensagens VRRP entre os Sockets primário e secundário. O VRID padrão é 100. ## Script Exemplo do Postman ```plaintext mutação updateHa ($accountId: ID!, $siteId: ID!, $input: UpdateHaInput!) {    site(accountId: $accountId) {        updateHa (siteId: $siteId, input: $input) {            siteId        }    } } ``` **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-o-Cato-Site-Creation-API-com-Postman) - [Scripts da API de Configuração](https://support.catonetworks.com/hc/en-us/articles/8130916998429)