Press CTRL+K to open search

API de Configuração - updateHa

  • Atualizado em Jul 30, 2026
  • Publicado em Jul 1, 2026
  • 2 minuto(s) lido(s)
Prev Next

Recomendamos fortemente que, antes de começar a usar a Cato API, revise a Política de Suporte para a 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

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), 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

mutação updateHa ($accountId: ID!, $siteId: ID!, $input: UpdateHaInput!) {
    site(accountId: $accountId) {
        updateHa (siteId: $siteId, input: $input) {
            siteId
        }
    }
}

Variáveis do GraphQL

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

Recursos Relacionados

Artigos relacionados