--- title: "Cato API - AccountSnapshot > 站点" slug: "cato-api-accountsnapshot-sites" updated: 2026-07-30T03:23:19Z published: 2026-07-30T03:23:19Z canonical: "knowledge.catonetworks.com/cato-api-accountsnapshot-sites" --- > ## 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 字段包含与账户中一个或多个站点相关的数据。 ## SiteSnapshot 字段 SiteSnapshot 字段包含站点及其链接的数据。 使用 IDs 参数指定查询中包含哪些站点。 以下是 SiteSnapshot 字段可以为查询返回的详细信息: - id - 站点 ID - connectivityStatus - 到 Cato Cloud 的连接状态(带有嵌套字段的数组) - operationalStatus - 站点或 VPN 用户的状态(带有嵌套字段的数组) - lastConnected - 站点连接到 PoP 的时间戳 - connectedSince - 站点连续连接到 PoP 的时间 - popName - 站点连接到的 PoP 名称 - devices - 与站点的 Sockets 相关的数据(包含嵌套字段的数组) - info - 关于站点的实时信息(包含嵌套字段的数组) - hostCount - 连接到站点的主机数量 ## ID ID 字段显示账户中的唯一站点内部 ID,这个值在 Cato 管理应用程序中不显示。 ## connectivityStatus 站点 > 连接状态字段显示站点的连接性: - **已连接** 到 Cato 云 - **已断开** 从 Cato 云 ## operationalStatus 站点 > 运营状态字段显示站点状态: - active - 正在传递流量 - disabled - 在 Cato 管理应用程序中禁用 - locked - 此站点的许可证已过期,无法配置 - new - 你创建站点后到连接到 Cato Cloud 之前的状态 - pending_user_configuration - 与站点无关 - pending_mfa_configuration - 与站点无关 - pending_code_generation - 与站点无关 ## lastConnected lastConnected 字段显示站点最后一次连接到 Cato Cloud 中的 PoP 的时间戳。 此数据通常用于已从 Cato Cloud 断开连接的站点。 ## connectedSince connectedSince 字段显示站点连接到 PoP 的总时长。 ## popName popName 字段显示站点连接到的 PoP 名称。 ## 设备 DeviceSnapshot 字段包含与站点的 Socket 相关的数据(或用于高可用性的两个 Socket)。 有关 AccountSnapshot 的 DeviceSnapshot 字段的更多信息,请参见 [Cato API - AccountSnapshot > 站点 > 设备](/v1/docs/cato-api-accountsnapshot-sites-devices)。 ## 信息 SiteInfo 字段显示关于站点的实时数据,类似于 Cato 管理应用程序中的 **站点 > 常规** 窗口。 有关 SiteInfo 的更多信息,请参阅 [Cato API - AccountMetrics > 站点 > SiteInfo](/v1/docs/cato-api-accountmetrics-sites-siteinfo)的说明。 ## hostCount hostCount 字段显示当前连接到站点的主机数量,类似于 Cato 管理应用程序中的拓扑窗口。 ## SiteSnapshot IDs 参数 输入查询返回的数据的站点 ID。