Configuração API - addSocketSite – Base de Conhecimento

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
Descrição
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 no Aplicativo de Gerenciamento da Cato, em vez disso é o número na URL para o Aplicativo de Gerenciamento da Cato. Por exemplo, o ID da conta é 26 para a seguinte URL: https://cc.catonetworks.com/#!/26/topology.

Insira esse 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 marcado como opcional:

name - Nome do site
connectionType - Socket físico ou vSocket para este site
siteType - Tipo de site na sua organização, por exemplo, Data Center na Nuvem
description - (opcional) Descrição do site
nativeNetworkRange - Faixa de IP para LAN nativa atrás do site, no formato CIDR
siteLocation - 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 tipo de site é um argumento enum que define o tipo de site que determina qual ícone é usado para o site na tela de Monitoramento > Topologia no Aplicativo de Gerenciamento da Cato.

Estas são as opções:

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 localização do site definem os seguintes detalhes físicos para o site. O countryCode é relevante para o número de licenças de sites que estão disponíveis para uma Região específica na sua conta.

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

Estes são os argumentos localização do site:

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 de tempo para a 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 de rua para o site físico

Script de Exemplo Postman

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

Variáveis 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

Usando a API de Criação de Site da Cato com Postman

Configuração API - addSocketSite