--- title: "Cato API - InstantâneoConta > Locais > Dispositivos" slug: "cato-api-accountsnapshot-sites-devices" updated: 2026-07-30T01:43:06Z published: 2026-07-30T01:43:06Z canonical: "knowledge.catonetworks.com/cato-api-accountsnapshot-sites-devices" --- > ## 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. # Cato API - InstantâneoConta > Locais > Dispositivos ## InstantâneoConta > Locais > Dispositivos Este artigo explica os campos e dados do **InstantâneoSite > Site > Dispositivos** relacionados aos sockets de um site. ## Campos DeviceSnapshot Os campos DeviceSnapshot contêm dados para sockets e seus links. A mesma infraestrutura de DeviceSnapshot é usada para usuários de VPN e para sites, e alguns dos campos são relevantes apenas para usuários ou sites. Estes são os detalhes que o campo DeviceSnapshot pode retornar para a consulta: - id - ID interno único da Cato para o Socket - nome - este campo é usado em InstantâneoSite > Usuários > Dispositivos - indicador - este campo é usado em InstantâneoSite > Usuários > Dispositivos - conectado - um valor booleano que indica se o site está conectado à Nuvem Cato - haRole - mostra se este é o Socket primário ou secundário no modo de alta disponibilidade - interfaces - mostra dados em tempo real para os links WAN (tráfego de saída) (array com consultas e campos aninhados) - últimaConexão - timestamp de quando o Socket se conectou ao PoP - últimaDuração - tempo total que o Socket esteve conectado ao PoP - últimoPopID - o ID do PoP ao qual o Socket está conectado - últimoNomePop - o nome do PoP ao qual o Socket está conectado - recentConnections - dados relacionados aos fluxos de tráfego mais recentes completos (array com consultas e campos aninhados) - tipo - mostra o modelo do Socket ou tipo de vSocket - segundosDeAtividade - tempo total que o Socket esteve conectado ao PoP - informaçõesDoSocket - mostra dados relacionados ao Socket, como versão e número de série - estadoDoLinkDasInterfaces - mostra dados em tempo real de todos os links do Socket (array com consultas e campos aninhados) - tipoDeOS - sistema operacional do Socket - versãoDoOS - versão do sistema operacional do Socket - versão - Versão do Socket - númeroDaVersão - Versão principal do Socket - grupoDeLançamento - mostra o grupo de lançamento para o site - tempoExpiraçãoMFA - este campo é usado em InstantâneoSite > Usuários > Dispositivos ## ID O campo ID mostra o ID interno da Cato para o Socket. ## Conectado O campo Conectado é um valor booleano que mostra **true** quando o site está conectado à Nuvem Cato. ## HaRole O campo HaRole contém dados relacionados ao modo de alta disponibilidade para o Socket. O Socket principal está ativo e o secundário está passivo. ## Interfaces Os campos Interfaces mostram dados para as interfaces WAN . O campo usa uma matriz com consultas aninhadas. Para mais informações sobre os campos Dispositivos > Interfaces para o InstantâneoConta, consulte [Cato API - InstantâneoConta > Locais > Dispositivos > Interfaces](/v1/docs/cato-api-accountsnapshot-sites-devices-interfaces). ## ÚltimaConexão O campo ÚltimaConexão é para conexões ativas e mostra o timestamp quando o Socket iniciou a conexão com o PoP. ## ÚltimaDuração O campo ÚltimaDuração mostra o tempo total em que o Socket está conectado ativamente ao PoP. ## ÚltimoPopID O Socket está conectado ao PoP com este ÚltimoPopID. ## ÚltimoNomePop Mostra o nome do PoP ao qual o Socket está conectado. ## Conexões Recentes O campo Dispositivo > ConexõesRecentes mostra dados relacionados ao fluxo de tráfego mais recente. Estes são os detalhes que este campo pode retornar para uma consulta: - duration - quantidade total de tempo para os dados da consulta - interfaceName - Nome para a porta na Aplicação de Gerenciamento Cato - nomeDoDispositivo - Número de série para o Socket - últimaConexão - Mostra o timestamp quando o fluxo iniciou a conexão com o Socket - popID - O ID do PoP ao qual o fluxo de tráfego estava conectado - nomePop - O nome do PoP ao qual o fluxo de tráfego estava conectado - IPRemoto - Endereço IP do ISP para este link - informaçãoIPRemoto - Endereço IP, ISP e informações geográficas relacionadas a este link ## Conexões Recentes > InformaçõesIPRemoto Os campos ConexõesRecentes > InformaçõesIPRemoto mostram dados relacionados ao Endereço IP , ISP e localização física do PoP ao qual o link WAN está conectado. Estes são os detalhes para os campos: - ip - Endereço IP da WAN conectado ao PoP - countryCode - código para a localização física do PoP (baseado na geolocalização do endereço IP) - countryName - país onde o PoP está localizado (baseado na geolocalização do endereço IP) - city - cidade onde o PoP está localizado (baseado na geolocalização do endereço IP) - state - estado onde o PoP está localizado (baseado na geolocalização do endereço IP) - provider - provedor de ISP para a conexão de última milha entre a Cato Cloud e o PoP - latitude - latitude do PoP (baseado na geolocalização do endereço IP) - longitude - longitude do PoP (baseado na geolocalização do endereço IP) ## Tipo O campo tipo mostra o modelo de um dispositivo físico Socket ou o ambiente de nuvem para o vSocket. Estas configurações são configuradas na Aplicação de Gerenciamento Cato (**Configuração > Site > Geral**). ## SegundosDeAtividade O campo segundosDeAtividade mostra o tempo total (em segundos) que este Socket está conectado ao PoP. ## informaçõesSocket O campo **informaçõesSocket** mostra dados sobre o Socket, como número de versão e número de série. Estes são os detalhes para os campos: - id - ID único para Socket (mostrado na Interface Web do Socket em **Sobre > ID do Dispositivo**) - série - número de série para o Socket - éPrincipal - para configurações de HA , quando este valor booleano é verdadeiro, este é o Socket principal - plataforma - Mostra o tipo de Socket: - não_definido - nenhuma plataforma definida para o Socket - VM - valor legador - X1 - valor legador - X1500 - Socket X1500 - NATIVO - valor legador - X1500_BR2 - valor legador - X1700 - Socket X1700 - AWS1500 - vSocket AWS - RPI64 - valor legador - AZ1500 - vSocket Azure - ESX1500 - vSocket VMware ESX - versão - número da versão de hardware que está atualmente instalada no Socket - tempoAtualizaçãoVersão - timestamp de quando o Socket foi atualizado para a versão de hardware atual ## EstadoDoLinkDaInterface O campo estadoDoLinkDasInterfaces mostra o status de todas as portas no Socket. Os dados para esta consulta são similares à aba **Monitor** na Interface Web do Socket. Estes são os detalhes que este campo pode retornar para uma consulta: - ID - o ID para a porta específica do Socket, por exemplo LAN1 ou LAN2 - Ligado - quando este valor booleano é verdadeiro, o link para a porta está ativo - MídiaDentro - quando este valor booleano é verdadeiro, um cabo está conectado à porta do Socket - VelocidadeDoLink - mostra a largura de banda máxima configurada para o link - Duplex - mostra o modo duplex para o link ## TipoDeOS O campo tipoDeOS mostra o sistema operacional do Socket. ## VersãoDoOS O campo versãoDoOS mostra a versão do sistema operacional do Socket. ## Versão O campo versão mostra o Socket que está instalado. ## NúmeroDaVersão O campo númeroDaVersão mostra a versão principal do Socket que está instalada. ## GrupoDeLançamento O campo grupoDeLançamento mostra o grupo de lançamento para novas versões do Socket para este site.