--- title: "Cato API 更新日志" slug: "cato-api-changelog" updated: 2026-10-19T23:17:23Z published: 2026-10-19T23:17:23Z canonical: "knowledge.catonetworks.com/cato-api-changelog" --- > ## 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 更新日志 本文是关于对 Cato GraphQL API 架构的最新和计划更改的通知平台。它包含新闻和更新,强调新的功能,如新发布的 API 和自动化工具。 有关可能需要您更新 API 客户端的更改的信息,请参阅 [Cato API 可能会中断的更改和生命周期结束](/v1/docs/cato-api-potentially-breaking-changes-and-eol)。 本文中使用的条款在[内容是 Cato API](/v1/docs/what-is-the-cato-api)中进行了说明。 对于使用 Cato API 的任何客户,我们建议您点击 **关注**,以自动接收有关 API 更改的更新通知。 有关 API 的更多信息,请参阅 [Cato Networks GraphQL API 参考](https://api.catonetworks.com/documentation/)。 ## 新闻和更新 ### 已更新的私有访问策略 API 的连接来源 - 2026年10月18日 **变更:** 更新的 API **功能标题:** 将私有访问权限策略连接来源与互联网和WAN防火墙API对齐 私有访问策略 API (Beta)替代了已弃用的`connectionOrigin`字段(`PrivateAccessPolicyOriginEnum`),并用`connectionsOriginList`(`ConnectionOriginsEnum`)。这个变更适用于`policy.privateAccess.addRule`, `policy.privateAccess.updateRule`的规则更新,以及查询响应中返回的规则。 - `站点`, `远程客户端`, `远程扩展`, 和 `远程浏览器` 保持不变。扩展和浏览器来源仍然取决于账户的可用性 - 使用空列表而不是 `任何` 来匹配任何连接来源 - `远程` 和 `远程门户` 在新建字段中不支持 - 两个字段目前已被接受并自动同步,因此现有集成继续工作。包含冲突值的请求会返回错误 弃用的字段和枚举将在未来的重大变更中被移除。 对于 Terraform, `连接来源` 属性及其值保持不变。提供商发布的升级将在移除前发布。移除后,较旧的提供商版本将不支持私有访问策略计划/应用操作。访问权限策略执行不受影响 ### 附加用户操作 **变更:** 更新的 API **功能标题:** 通过外部工作流程和身份管理系统简化的用户管理 该 API 支持启用用户 (`enableUser`) 和禁用用户 (`disableUser`)。 ## 以往API新闻和更新 ### 用于分组 AppStats API 结果的增强分析 - 2026年6月21日 **变更:** 更新的 API **功能标题:**提升的分析能力用于分组的 AppStats 和事件 API 结果 当查询 AppStats 或事件 API 数据并按某个维度进行分组时,例如国家或设备类型,您可以选择将没有该维度值的记录显示为空组。这有助于确保API查询的一致总计,并在CMA仪表板和报告中显示以前隐藏的数据。 - 新的查询级布尔参数:`IncludeEmptyDimension`,对现有 API 脚本没有影响 - 适用于API查询和在CMA中显示的数据 ### 为 DEM 客户提供 appStats API 的新增字段 - 2026年4月19日 **变更:** 更新的 API **功能标题:** 应用程序体验指标的 appStats API 更新 应用程序体验指标的appStats API新建字段允许程序化访问用户、主机和应用程序性能数据: - `experience_score_level` - 体验评分指标的汇总 - `ttfb` - 首字节时间,衡量服务器响应能力 - `tls_latency` - 建立TLS连接的时间 - `tcp_latency` - TCP连接设置时间 - `http_latency` - 端到端HTTP请求延迟时间 - `http_error_rate` - HTTP错误率 **注意:** 这些字段仅适用于拥有 DEM 许可证的客户。 ### 为 Webhooks、邮件列表和订阅群组提供新增 Mutation APIs - 2026年3月29日 **变更:** 新建的 API **特性标题:** API支持管理Webhook、邮件列表和订阅组 - 使用以下API分配、替换、更新和删除站点许可证,通过API支持单一和汇总许可证 有关在CMA中通知管理的详细信息,请参阅[通知](/v1/docs/notifications)知识库文章 - - 使用`createWebhook`、`updateWebhook`、`deleteWebhook`、`webhook`、`webhookList`和`testWebhook`管理Webhook集成 - 使用`createMailingList`、`updateMailingList`、`deleteMailingList`、`mailingList`和`mailingListList`管理邮件列表 - 将Webhook和邮件列表合并到“订阅组”中,使用`createSubscriptionGroup`、`updateSubscriptionGroup`、`deleteSubscriptionGroup`、`subscriptionGroup`和`subscriptionGroupList` ### 分流策略 API 更新 - 2026年1月18日 **变更:** 更新的 API **功能标题:** 更新 SplitTunnelPolicyMutations - 以下 API 已变更,以更准确地与 Cato 管理应用程序中的功能行为对齐。 - **这些变更适用于分流策略的所有变更:** - `Exclude` - 变更为RouteAllToCatoExcept - `Include` - 变更为RouteOnlySelected - `Coverage` - 变更为ConnectionMode - `dnsExclusion` - 变更为dnsSuffix 这些 API 现已作为 Beta 提供。 ### 为站点带宽许可证添加 Mutation APIs - 2025年8月11日 **变更:** 新建的 API **功能标题:** API 支持管理站点带宽许可证 - 使用以下API分配、替换、更新和删除站点许可证,通过API支持单一和汇总许可证 - **Mutation APIs:** - `assignSiteBwLicense` - 将许可证分配给站点 - `updateSiteBwLicense` - 对于汇总许可证,更新站点带宽 - `replaceSiteBwLicense` - 在不影响停机时间的情况下更换站点许可证 - `removeSiteBwLicense` - 从站点移除许可证 这些 API 现已作为 Beta 提供。 ### 为应用目录和 DLP 内容类型添加查询 API - 2025年5月19日 **变更:** 新建的 API **功能标题:** API 支持查询应用程序目录和 DLP 内容类型 - 应用程序目录 - 查询应用程序的数据,包括合规性、安全性和 CASB 活动: - `catalogApplicationList` - 所有应用和数据 - `catalogApplication` - 单一应用 - DLP 内容 - 查询 DLP 数据内联保护规则的内容类型 - `contentTypeGroupList` 这些 API 现已作为 Beta 提供。 ### 添加 HA 次要 vSocket 的 Mutation API - 2025年3月2日 **变更:** 新建的 API **功能标题:** HA 配置的辅助 vSocket 的 API 支持 - 使用[以下API](https://api.catonetworks.com/documentation/#mutation-sites.addBgpPeer)设置故事判定、变更状态和添加备注 - **Mutation APIs:** - `addSecondaryAwsVSocketInput` 对于具有HA配置的AWS vSocket,添加辅助vSocket - `AddSecondaryAzureVSocketInput` 对于具有HA配置的AWS vSocket,添加辅助vSocket 这些 API 现已作为 Beta 提供。 ### 添加 XDR Mutation API - 2025年1月12日 **变更:** 新建的 API **功能标题:** XDR 故事和评论的 API 支持 - 使用[以下API](https://api.catonetworks.com/documentation/#mutation-xdr.addStoryComment)设置故事判定、变更状态和添加备注 - **Mutation APIs:** - `addStoryComment` 提交评论帮助跟踪故事调查 - `analystFeedback` 管理故事操作,例如故事判定、类型和分类。 - `deleteStoryComment` 使用评论ID删除已发布的评论 这个 API 目前可作为 Beta 版本使用。 ### 最后一英里带宽支持 Kbps - 2025年1月12日 **变更:** API 的增强 **功能标题:** 设置站点带宽值,精确到一个小数点 (例如 1.5 Mbps),以获得更细致的准确性 - 使用[以下API](https://api.catonetworks.com/documentation/#mutation-sites.addSocketSite)设置故事判定、变更状态和添加备注 - **受影响的 API 类型:** - `LastMileBwInput` - `InterfaceInfo` - `SocketInterfaceBandwidthInput` 这些 API 类型目前可作为 Beta 版本使用。 ### 对 IPsec IKEv2 站点的 accountSnapshot 和 accountMetrics 的变更 - 2025年1月12日 **更改:** `Primary` 值更新为 `Primary 1` **功能标题:** IPsec IKEv2 站点的 API 支持 随着 Jan 12, 2025 支持活动/活动配置的逐步发布,从 accountSnapshot 和 accountMetrics 查询中检索到 value 的 `InterfaceId` 字段的更改。 | 旧值 | 新建值 | 注意 | | --- | --- | --- | | 主要 | Primary1 | 此更改让我们支持多个主隧道 | ### 新建 BGP 对等 API - 2024年12月23日 **变更:** 新建的 API **功能标题:** BGP 对等的 API 支持 - 使用以下API简化[配置](https://api.catonetworks.com/documentation/#mutation-sites.addBgpPeer)和[监控](https://api.catonetworks.com/documentation/#query-site.bgpPeer)站点的BGP对等 - **Mutation APIs:** - `addBgpPeer` 为站点添加新建BGP对等 - `updateBgpPeer` 更新现有BGP对等配置的设置 - `removeBgpPeer` 删除站点的BGP对等配置 - **查询 API:** - `bgpPeer` 检索有关特定BGP对等的信息 - `siteBgpStatus` 显示当前BGP状态,包括会话详细信息和路由信息 这个 API 目前可作为 Beta 版本使用。