--- title: "Cato API - AccountSnapshot > 站点 > 设备" slug: "cato-api-accountsnapshot-sites-devices" updated: 2026-07-30T03:23:22Z published: 2026-07-30T03:23:22Z 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 - AccountSnapshot > 站点 > 设备 ## AccountSnapshot > 站点 > 设备 本文解释了**SiteSnapshot > 站点> 设备**字段和与站点Sockets相关的数据。 ## DeviceSnapshot 字段 DeviceSnapshot 字段包含 Sockets 和其链接的数据。 相同的 DeviceSnapshot 基础设施用于 VPN 用户和站点,并且某些字段仅与用户或站点相关。 这些是 DeviceSnapshot 字段可以为查询返回的详细信息: - id - Socket 的唯一内部 Cato ID - name - 此字段用于 SiteSnapshot > 用户 > 设备 - identifier - 此字段用于 SiteSnapshot > 用户 > 设备 - connected - 一个布尔值,指示站点是否已连接到 Cato Cloud - haRole - 显示这是高可用模式中的主 Socket 还是备用 Socket - interfaces - 显示 WAN 链接(出站流量)的实时数据(包含嵌套查询和字段的数组) - lastConnected - Socket 连接到 PoP 的时间戳 - lastDuration - Socket 已连接到 PoP 的总时间 - lastPopID - Socket 连接到的 PoP 的 ID - lastPopName - Socket 连接到的 PoP 的名称 - recentConnections - 与最近完成的流量相关的数据 (带嵌套查询和字段的数组) - type - 显示 Socket 型号或 vSocket 类型 - uptimeSeconds - Socket 已连接到 PoP 的总时间(秒) - socketInfo - 显示与 Socket 相关的数据,例如版本和序列号 - interfacesLinkState - 显示所有 Socket 链接的实时数据(包含嵌套查询和字段的数组) - osType - Socket 的操作系统 - osVersion - Socket 操作系统的版本 - version - Socket 版本 - versionNumber - Socket 主要版本 - releaseGroup - 显示站点的发布组 - mfaExpirationTime - 此字段用于 SiteSnapshot > 用户 > 设备 ## ID ID 字段显示 Socket 的内部 Cato ID。 ## Connected 连接字段是一个布尔值,当站点连接到 Cato Cloud 时显示**true**。 ## HaRole HaRole 字段显示与 Socket 的高可用模式相关的数据。 主要 Socket 为主动,备用 Socket 为被动。 ## 接口 接口字段显示 WAN 接口的数据。 该字段使用包含嵌套查询的数组。 有关 AccountSnapshot 的 设备 > 接口字段的更多信息,请参阅 [Cato API - AccountSnapshot > 站点 > 设备 > 接口](/v1/docs/cato-api-accountsnapshot-sites-devices-interfaces)。 ## LastConnected LastConnected 字段用于活跃连接,显示 Socket 发起与 PoP 连接的时间戳。 ## LastDuration LastDuration 字段显示 Socket 与 PoP 活跃连接的总时间。 ## LastPopID Socket 使用此 LastPopID 连接到 PoP。 ## LastPopName 显示 Socket 连接到的 PoP 的名称。 ## RecentConnections 设备 > RecentConnections 字段显示与最近流量流相关的数据。 这些是此字段可以为查询返回的详细信息: - duration - 查询数据的总时间 - interfaceName - Cato 管理应用程序中的端口名称 - deviceName - Socket 的序列号 - lastConnected - 显示流量发起与 Socket 连接的时间戳 - popID - 流量流连接到的 PoP 的 ID - popName - 流量流连接到的 PoP 的名称 - remoteIP - 此链接的 ISP 的 IP 地址 - remoteIPInfo - 此链接的 IP 地址、ISP 和地理信息 ## Recent Connections > RemoteIPInfo RecentConnections > RemoteIPInfo 字段显示与 WAN 链接连接到的 PoP 的 IP 地址、ISP 和物理位置相关的数据。 这些是字段的详细信息: - ip - PoP 的 WAN 连接的 IP 地址 - countryCode - PoP 的物理位置的代码 (基于 IP 地址地理定位) - countryName - PoP 的物理位置所在国家 (基于 IP 地址地理定位) - city - PoP 所在城市 (基于 IP 地址地理定位) - state - PoP 所在州 (基于 IP 地址地理定位) - provider - Cato Cloud 和 PoP 之间最后一公里连接的 ISP 提供商 - latitude - PoP 的纬度 (基于 IP 地址地理定位) - longitude - PoP 的经度 (基于 IP 地址地理定位) ## 类型 类型字段显示物理 Socket 的型号或云环境 vSocket。 这些设置在 Cato 管理应用程序中配置(**配置 > 站点 > 常规**)。 ## UptimeSeconds uptimeSeconds 字段显示此 Socket 已连接到 PoP 的总时间(以秒为单位)。 ## socketInfo **socketInfo** 字段显示关于 Socket 的数据,如版本号和序列号。 这些是字段的详细信息: - id - Socket 的唯一 ID(在 Socket WebUI**关于 > 设备 id**中显示) - 序列号(serial) - Socket的序列号 - isPrimary - 对于 HA 配置,当此布尔值为 true 时,这是主 Socket - platform - 显示 Socket 类型: - not_set - 没有为 Socket 设置平台 - VM - 旧值 - X1 - 旧值 - X1500 - X1500 Socket - NATIVE - 旧值 - X1500_BR2 - 旧值 - X1700 - X1700 Socket - AWS1500 - AWS vSocket - RPI64 - 遗留值 - AZ1500 - Azure vSocket - ESX1500 - VMware ESX vSocket - version - 当前安装在 Socket 上的硬件版本号 - versionUpdateTime - Socket 升级到当前硬件版本的时间戳 ## InterfaceLinkState interfacesLinkState 字段显示 Socket 中所有端口的状态。 此查询的数据与 Socket WebUI 中的**监控**标签相似。 这些是此字段可以为查询返回的详细信息: - ID - 特定 Socket 端口的 ID,例如 LAN1 或 LAN2 - Up - 当此布尔值为 true 时,端口的链接是开启的 - MediaIn - 当此布尔值为 true 时,电缆已连接到 Socket 端口 - LinkSpeed - 显示为链接配置的最大带宽 - Duplex - 显示链接的双工模式 ## OsType osType 字段显示 Socket 的操作系统。 ## OsVersion osVersion 字段显示 Socket 操作系统的版本。 ## 版本 版本字段显示已安装的 Socket。 ## 版本号 版本号字段显示已安装的主要 Socket 版本。 ## ReleaseGroup releaseGroup 字段显示新 Socket 版本在该站点的发布组。