--- title: "Configuração API - addSocketSite" slug: "configuration-api-addsocketsite" updated: 2026-07-30T01:47:36Z published: 2026-07-30T01:47:36Z canonical: "knowledge.catonetworks.com/configuration-api-addsocketsite" --- > ## 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. # Configuração API - addSocketSite 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 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: ```plaintext 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](/v1/docs/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 ```plaintext mutação addSocketSite ($accountId: ID!, $input: AddSocketSiteInput!) {    site(accountId: $accountId) {        addSocketSite (input: $input) {            siteId        }    } } ``` **Variáveis do GraphQL** ```plaintext {    "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](/v1/docs/usando-o-api-de-criação-de-sites-Cato-com-o-postman)