--- title: "API de Configuração - updateSiteGeneralDetails" slug: "configuration-api-updatesitegeneraldetails" updated: 2026-07-30T01:47:37Z published: 2026-07-30T01:47:37Z canonical: "knowledge.catonetworks.com/configuration-api-updatesitegeneraldetails" --- > ## 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 - updateSiteGeneralDetails 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 updateSiteGeneralDetails Use a API de mutação updateSiteGeneralDetails para atualizar as seguintes configurações na seção **Geral** para um site no Aplicativo de Gerenciamento Cato (Network > Sites > {site name} > Configuração do Site > Geral) - Nome - Descrição - Tipo - Fuso horário - País - Estado - Endereço ### Localizando o accountId para Sua Conta Este ID da Conta não é mostrado no Aplicativo de Gerenciamento Cato, em vez disso, é o número na URL para o Aplicativo 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    } } ``` ### 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 ID do site é 12345 para a seguinte URL: https://cc.catonetworks.com/#/26/sites/12345/networkAnalytics ## Detalhes para os Argumentos de updateSiteGeneralDetails Estes são os argumentos para atualizar as seguintes configurações Gerais para um site usando a API de configuração Cato. Os argumentos são obrigatórios, a menos que marcados como opcionais: - name - Nome do site - siteType - Tipo de site na sua organização, por exemplo, Centro de Dados na Nuvem - descrição - (opcional) Descrição do site - localização do site - Dados sobre a localização física do site ### updateSiteGeneralDetails Nome Atualize o nome do site. ### updateSiteGeneralDetails siteType 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 ### updateSiteGeneralDetails descrição (Opcional) O `descrição` é um campo de texto livre opcional para descrever o site. ### updateSiteGeneralDetails local do site 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 mutation updateSiteGeneralDetails ($accountId: ID!, $siteID: ID!, $input: UpdateSiteGeneralDetailsInput!) {    site(accountId: $accountId) {        updateSiteGeneralDetails (siteId: $siteID, input: $input) {            siteId        }    } } ``` **Variáveis do GraphQL** ```plaintext {    "accountId": "",    "siteID": "",    "input": {        "name": "MySite",        "description": "Meu primeiro DC usando a API",        "siteType": "DATACENTER",        "siteLocation": {            "countryCode": "FR",            "timezone": "Europe/Paris"        }    } } ``` **Recursos Relacionados** - [Usando a API de Criação de Site da Cato com Postman](/v1/docs/usando-a-cato-site-creation-api-com-postman) - [Scripts da API de Configuração](https://support.catonetworks.com/hc/en-us/articles/8130916998429)