--- title: "Cato API - AccountSnapshot > Usuários" slug: "cato-api-accountsnapshot-users" updated: 2026-07-30T01:43:07Z published: 2026-07-30T01:43:07Z canonical: "knowledge.catonetworks.com/cato-api-accountsnapshot-users" --- > ## 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 - AccountSnapshot > Usuários ## AccountSnapshot > Usuários O campo UserSnapshot contém dados relacionados aos usuários de VPN na conta. Quando você executa uma consulta para todos os usuários na conta (o argumento ID está vazio), a chamada de API retorna dados dos usuários que estão atualmente conectados à VPN e à Nuvem Cato. Se você usar o argumento ID para executar uma consulta de usuários específicos, a chamada de API retorna dados desses usuários mesmo quando eles não estão conectados à VPN. ## Campos de UserSnapshot Os campos UserSnapshot contêm dados para usuários de VPN conectados e suas conexões com a Nuvem Cato. Use o argumento IDs para especificar quais usuários de VPN estão incluídos na consulta. Estes são os detalhes que os campos UserSnapshot podem retornar para a consulta: - id - ID do usuário de VPN - connectivityStatus - conectividade com a Nuvem Cato (array com campos aninhados) - operationalStatus - status para um site ou usuário de VPN (array com campos aninhados) - name - nome do usuário de VPN - deviceName - nome do computador ou dispositivo - uptime - tempo de conexão do Cliente à Nuvem Cato (em segundos) - lastConnected - data/hora em que o usuário de VPN se conectou ao PoP - version - Versão do software do Cliente (string) - versionNumber - Versão do software do Cliente (INT) - popID - ID do PoP ao qual o Cliente está conectado - popName - nome do PoP ao qual o usuário de VPN está conectado - RemoteIP - Endereço IP do Cliente - RemoteIPInfo - Endereço IP, ISP e informações geográficas relacionadas ao Cliente - internalIP - Endereço IP do PoP ao qual o Cliente está conectado - osType - sistema operacional do dispositivo no qual o Cliente está rodando - osVersion - versão do sistema operacional para o dispositivo - devices - dados relacionados ao Cliente (array com campos aninhados) - connectedInOffice - mostra se o Cliente está conectado à VPN usando o Modo Office - info - informações gerais sobre o usuário de VPN (array com campos aninhados) - recentConnections - dados relacionados às conexões de VPN mais recentes completadas (array com consultas e campos aninhados) ## ID Mostra o ID interno único do usuário de VPN para a conta, este valor não é mostrado na Aplicação de Gerenciamento Cato. ## connectivityStatus O campo Usuários > connectivityStatus mostra a conectividade para um usuário de VPN - **conectado** à Nuvem Cato - **desconectado** da Nuvem Cato ## operationalStatus O campo Usuários > operationalStatus mostra o status do usuário de VPN - ativo - passando tráfego - desativado - desativado na Aplicação de Gerenciamento Cato - bloqueado - conta para este usuário de VPN está bloqueada - novo - não relevante para usuários de VPN - pending_user_configuration - aguardando o usuário de VPN confirmar a conta - pending_mfa_configuration - aguardando o usuário de VPN configurar as Configurações de Proteção de Endpoint - pending_code_generation - aguardando o usuário de VPN inserir o código de registro ## Nome O campo nome mostra o nome do usuário de VPN na Aplicação de Gerenciamento Cato. ## Nome do Dispositivo O campo deviceName mostra o nome do computador ou dispositivo que está conectado à Nuvem Cato. ## uptime O campo uptime mostra a quantidade total de tempo, em segundos, que o usuário de VPN está conectado à Nuvem Cato. ## lastConnected Para um usuário de VPN que não está conectado à Nuvem Cato, o campo lastConnected mostra o carimbo de hora da última vez que o Cliente se conectou à Nuvem Cato. ## versão O campo version mostra a versão do Cliente como o tipo STRING. ## versionNumber O campo versionNumber mostra a versão do Cliente como o tipo INT. ## PopID O campo Usuários > PoPID mostra o ID do PoP ao qual o Cliente está conectado. ## PopName O campo Usuários > PoPName mostra o nome do PoP ao qual o Cliente está conectado. ## RemoteIP O campo Usuários > RemoteIP mostra o endereço IP do Cliente. ## RemoteIPInfo Os campos Usuários > RemoteIPInfo mostram dados relacionados ao endereço IP, ISP e localização física do PoP ao qual o Cliente 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 ) ## InternalIP O campo Usuários > internalIP mostra o endereço IP do PoP ao qual o Cliente está conectado. ## osType O campo osType mostra o sistema operacional do dispositivo em que o Cliente está instalado. ## osVersion O campo osVersion mostra a versão do sistema operacional do dispositivo em que o Cliente está instalado. ## Dispositivos Os campos Usuários > DeviceSnapshot mostram métricas e dados do dispositivo que está conectado à Cato Cloud. Alguns campos em DeviceSnapshot são repetidos para lhe proporcionar maior flexibilidade com os dados. Além disso, a mesma infraestrutura DeviceSnapshot é usada para usuários de VPN e para sites, e alguns campos são relevantes apenas para usuários ou sites. Estes são os dados que você pode ver: - id - ID interno único da Cato para o dispositivo - name - nome do dispositivo - identifier - identificador único para o dispositivo - connected - um valor booleano que indica se o Cliente está conectado à Cato Cloud - haRole - este campo é usado em SiteSnapshot > Site > Dispositivos - interfaces - mostra dados em tempo real para o Cliente (array com consultas e campos aninhados) Para mais sobre os campos Interfaces para DeviceSnapshot, veja [Cato API - AccountSnapshot > Sites > Dispositivos > Interfaces](/v1/docs/cato-api-accountsnapshot-sites-devices-interfaces). - lastConnected - marca de tempo quando o Cliente se conectou à Cato Cloud - lastDuration - quantidade total de tempo que o Cliente esteve conectado à Cato Cloud - connectedSince - mostra a marca de tempo de quanto tempo o Cliente está ativamente conectado à Cato Cloud - lastPopName - o nome do PoP ao qual o Cliente está conectado - lastPopID - o ID do PoP ao qual o Cliente está conectado - recentConnections - dados relacionados aos fluxos de tráfego mais recentes completos (array com consultas e campos aninhados) Para mais sobre os campos recentConnections para DeviceSnapshot, veja [Cato API - AccountSnapshot > Sites > Dispositivos](/v1/docs/cato-api-accountsnapshot-sites-devices). - type - mostra o tipo de dispositivo - uptimeSeconds - mostra o número de segundos que este Cliente esteve ativo - socketInfo - este campo é usado em SiteSnapshot > Site > Dispositivos - interfacesLinkState - este campo é usado em SiteSnapshot > Site > Dispositivos - osType - sistema operacional do dispositivo no qual o Cliente está rodando - osVersion - versão do sistema operacional para o dispositivo - version - versão do software do Cliente, por exemplo, 4.4.1234 (string) - versionNumber - versão major do software do Cliente, por exemplo, 4 (INT) - releaseGroup - mostra o status de liberação para o Cliente, como GA ou EA - mfaExpirationTime - Mostra o tempo restante antes do token MFA expirar ## connectedInOffice O campo connectedInOffice é um valor booleano e, quando **true**, mostra que o Cliente está conectado à rede usando Modo Escritório. ## Informações Os campos UserInfo mostram informações básicas sobre o usuário de VPN , de forma sucinta. Estes são os detalhes para os campos: - name - nome do usuário de VPN - status - status do Cliente como tipo STRING - email - endereço de e-mail do usuário de VPN - creationTime - marca de tempo quando o usuário de VPN foi criado na conta - phoneNumber - número de telefone para o usuário de VPN - origin - mostra como o usuário de VPN foi adicionado à conta: - regular - adicionado manualmente na Aplicação de Gerenciamento Cato - LDAP - adicionado com sincronização LDAP - authMethod - Configurações de Autenticação Multifatorial (MFA) para este usuário de VPN : - None - o usuário de VPN não requer MFA para autenticar no Cliente - MFA - o usuário de VPN requer MFA para autenticar no Cliente ## Conexões Recentes O campo Usuários > RecentConnections mostra dados relacionados às conexões de Cliente mais recentes com a Cato Cloud. 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 - deviceName - Nome do dispositivo no qual o Cliente está instalado - lastConnected - Mostra a marca de tempo quando o Cliente iniciou a conexão à Cato Cloud - popID - O ID do PoP ao qual o Cliente estava conectado - popName - O nome do PoP ao qual o Cliente estava conectado - remoteIP - Endereço IP do Cliente - remoteIPInfo - endereço IP, ISP e informações geográficas relacionadas ao PoP ao qual o fluxo de tráfego estava conectado ## Snapshot > IDs de Usuários Argumento Digite os IDs de usuários de VPN para os dados que a consulta retorna. Quando este argumento está vazio, a consulta retorna todos os usuários de VPN conectados à Cato Cloud.