Press CTRL+K to open search

Cato API - AccountSnapshot > 站点 > 设备

  • 更新于 Jul 30, 2026
  • 发布于 Jul 7, 2026
  • 1 分钟阅读
Prev Next

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 > 站点 > 设备 > 接口。

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 版本在该站点的发布组。

相关文章