AccountSnapshot > 站点

SiteSnapshot 字段包含与账户中的一个或多个站点相关的数据。

SiteSnapshot 字段

SiteSnapshot 字段包含站点及其链接的数据。 使用 IDs 参数指定查询中包含哪些站点。

这些是 SiteSnapshot 字段可以为查询返回的详细信息：

• id - 站点 ID
• connectivityStatus - 连接到 Cato Cloud（数组，包含嵌套字段）
• operationalStatus - 站点或 VPN 用户的状态（数组，包含嵌套字段）
• lastConnected - 站点连接到 PoP 的时间戳
• connectedSince - 站点持续连接到 PoP 的时间
• popName - 站点连接到的 PoP 的名称
• devices - 与站点 Sockets 相关的数据（数组，包含嵌套字段）
• metrics - 实时（基于最近 30 秒）流量指标和站点数据（数组，包含嵌套字段）
• info - 站点的一般实时信息（数组，包含嵌套字段）
• hostCount - 连接到站点的主机数量

ID

ID 字段显示账户的唯一站点内部 ID，该值不在 Cato 管理应用程序中显示。

connectivityStatus

站点 > connectivityStatus 字段显示站点的连接：

• 已连接到 Cato Cloud
• 已断开连接从 Cato Cloud

operationalStatus

站点 > operationalStatus 字段显示站点的状态：

• 活跃 - 通过流量
• 已禁用 - 在 Cato 管理应用程序中已禁用
• 已锁定 - 此站点的许可证已过期，无法进行配置
• 新建 - 在连接到 Cato Cloud 之前创建站点
• pending_user_configuration - 与站点无关
• pending_mfa_configuration - 与站点无关
• pending_code_generation - 与站点无关

lastConnected

lastConnected 字段显示站点最后一次连接到 Cato Cloud 中的 PoP 的时间戳。 此数据通常用于已断开连接的站点。

connectedSince

connectedSince 字段显示站点连接到 PoP 的总时间。

popName

popName 字段显示站点连接到的 PoP 的名称。

设备

DeviceSnapshot 字段包含与站点 sockets（或用于高可用性的两个 sockets）相关的数据。

有关 AccountSnapshot 的 DeviceSnapshot 字段的详细信息，请参阅 Cato API - AccountSnapshot > 站点 > 设备。

指标

指标字段显示站点的实时流量分析。 这些是您可以看到的站点数据：

• 持续时间 - 站点数据的总时间
• 粒度 - 单个指标桶的秒数
• 下行字节 - 总下行流量（从 Cato Cloud 到站点）
• 上行字节 - 总上行流量（从站点到 Cato Cloud）
• 总字节 - 站点的总流量
• 下行丢失 - 下行流量丢失的数据包数量
• 下行丢失百分比 - 下行流量丢失的数据包百分比
• 上行丢失 - 上行流量丢失的数据包数量
• 上行丢失百分比 - 上行流量丢失的数据包百分比
• 下行数据包 - 总下行数据包
• 上行数据包 - 总上行数据包
• 上行抖动 - 上行流量的抖动（数据包之间的时间延迟差异，以毫秒（ms）为单位）
• 下行抖动 - 下行流量的抖动（数据包之间的时间延迟差异，以毫秒（ms）为单位）
• 下行丢弃的数据包 - 下行流量丢弃的数据包总数
• 上行丢弃的数据包 - 上行流量丢弃的数据包总数
• rtt - 从站点到 Cato Cloud 的往返时间

信息

SiteInfo 字段显示关于站点的实时数据，类似于 Cato 管理应用程序中的站点 > 常规窗口。 有关 SiteInfo 的更多信息，请参阅Cato API - AccountMetrics > 站点 > SiteInfo 的说明。

hostCount

hostCount 字段显示当前连接到站点的主机数量，类似于 Cato 管理应用程序中的拓扑窗口。

SiteSnapshot IDs 参数

输入查询返回的数据的站点 ID。