Press CTRL+K to open search

Configuração API - addSocketSite

  • Atualizado em Jul 30, 2026
  • Publicado em Jul 1, 2026
  • 3 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 addSocketSite

Use a API de mutação addSocketSite para criar um novo site Socket na sua conta e definir as seguintes configurações para o site:

  • Nome

  • Description

  • Tipo

  • Tipo de Conexão

  • Fuso horário

  • País

  • Estado

  • Endereço

  • Faixa Nativa

O site é criado com configurações de largura de banda padrão, 25 Mbps Downstream e 25 Mbps Upstream, e é criado sem uma licença atribuída a ele.

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 accountId para sua conta

Este ID da Conta não é mostrado na Aplicação de Gerenciamento Cato, em vez disso, é o número na URL para a Aplicação de Gerenciamento Cato. Por exemplo, o ID da Conta é 26 para a seguinte URL: https://cc.catonetworks.com/#!/26/topologia.

Digite este ID no argumento accountId para a API de criação de site, por exemplo:

site(accountId: 26) {
    addSocketSite(input: $addSocketSite) { 
        siteId 
    } 
}

Detalhes para os Argumentos do addSocketSite

Estes são os argumentos para criar um novo site Socket usando a API de configuração da Cato. Os argumentos são obrigatórios, a menos que marcados como opcionais:

  • name - Nome do site

  • connectionType - Socket físico ou vSocket para este site

  • siteType - Tipo de site na sua organização, por exemplo, Centro de Dados na Nuvem

  • descrição - (opcional) Descrição do site

  • nativeNetworkRange - Faixa de IP para LAN nativa atrás do site, no formato CIDR

  • localização do site - Dados sobre a localização física do site

Nome AddSocketSite

Defina o nome do site Socket que você está criando.

Tipo de Conexão AddSocketSite

O tipo de conexão é um argumento enum que define o tipo de Socket físico ou virtual para o site.

Estas são as opções:

  • SOCKET_X1500 - Socket X1500 ou X1500B para um site físico

  • SOCKET_X1600 - Socket X1600 para um site físico

  • SOCKET_X1700 - Socket X1700 ou X1700B para um site físico

  • SOCKET_ESX - vSocket para um site virtual VMware

  • SOCKET_AWS - vSocket para um site virtual AWS

  • SOCKET_AZURE - vSocket para um site virtual Azure

Tipo de Site AddSocketSite

O siteType é um argumento enum que define o tipo de site que determina qual ícone é usado para o site na tela Monitoring > Topologia no Aplicativo de Gerenciamento Cato.

Essas são as opções:

  • BRANCH - Sites físicos ou virtuais

  • HEADQUARTERS - Sites físicos para sedes corporativas

  • CLOUD_DC - Sites virtuais para centros de dados baseados em nuvem

  • DATACENTER - Sites físicos para centros de dados

Descrição AddSocketSite (Opcional)

O descrição é um campo de texto livre opcional para descrever o site.

Faixa de Rede Nativa AddSocketSite

Defina a faixa de IP para a faixa nativa LAN para o site no argumento faixa de rede nativa no formato IPSubnet. A faixa nativa usa CIDR para o sub-rede, e blocos CIDR /32 não são suportados.

Localização do Site AddSocketSite

Os argumentos siteLocation definem os seguintes detalhes físicos para o site. O countryCode é relevante para o número de licenças de site que estão disponíveis para uma Região específica na sua conta.

Você pode usar a consulta de API entityLookup para recuperar valores para estes argumentos, veja Cato API - EntityLookup.

Estes são os argumentos siteLocation:

  • countryCode - Código de duas letras (ISO 3166-1 alpha-2) para o país onde o site está localizado

    Para entityLookup, use o tipo com o valor country

  • stateCode - (Opcional) Para os países aplicáveis, o estado onde o site está localizado

    Para entityLookup, use o tipo com o valor countryState

  • timezone - Fuso horário para o site, usado para definir o período da Janela de Manutenção para atualizações de Socket e vSocket

    Para entityLookup, use o tipo com o valor timezone

  • endereço - (Opcional) Endereço da rua para o site físico

Script Exemplo do Postman

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

Variáveis do GraphQL

{
    "accountId": "26",
    "input": {
        "name": "SampleUsSite2",
        "description": "Meu primeiro site de API",
        "siteType": "BRANCH",
        "connectionType": "SOCKET_X1500",
        "nativeNetworkRange": "10.0.0.0/24",
        "siteLocation": {
            "countryCode": "US",
            "timezone": "US/Central",
            "stateCode": "US-AL"
        }
    }
}

Recursos Relacionados

Artigos relacionados