--- title: "Cato API 潜在的重大更改和终止公告" slug: "cato-api-potentially-breaking-changes-and-eol" updated: 2026-11-05T00:11:34Z published: 2026-11-05T00:11:34Z canonical: "knowledge.catonetworks.com/cato-api-potentially-breaking-changes-and-eol" --- > ## 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 模式潜在重大更改和生命周期终止(EoL)公告的通知平台,包含可能需要您更新 API 客户端的信息。 本文中使用的条款在[内容是 Cato API](/v1/docs/what-is-the-cato-api)中进行了说明。 对于任何使用 Cato API 的客户,我们建议您单击 **关注** 以自动接收关于 API 重大更改的本文更新的电子邮件通知。您还可以在[Cato API 更新日志](/v1/docs/cato-api-changelog)中查看有关新建和已更新API的更多信息。 有关 API 的更多信息,请参阅 [Cato Networks GraphQL API 参考](https://api.catonetworks.com/documentation/)。 ## 潜在的破坏性变更 ### 2026-12-1 - API 和速率限制变更 自 2026 年 12 月 1 日起,Cato 正在逐步推出新的 API 网关,其中包括对 API 速率限制的变更。新型号包括: - 基于积分的速率限制:每次操作根据其成本消耗积分,而不是对每次调用等量计数 - 共享账户预算:各个操作从同一账户预算中抽取积分,该账户预算会随时间补充 - 额外的操作预算:某些操作除了共享账户预算外,还拥有自己的预算 - 重试指导:API 响应指示在重试之前等待的时间,或在超出容量时简化或分割请求 **重要:**这不是破坏性变更。您的现有集成不会降级,也不需要采取任何行动。 有关更多信息,请参见[常见问题:即将到来的 API 网关和速率限制变更](/v1/docs/faq-upcoming-api-gateway-and-rate-limiting-changes) ### 2026-08-30 - 严格的模式类型验证 从 2026 年 8 月 30 日起,我们将在整个 API 中实施更严格的类型验证,以符合记录的模式。 API 调用传递的值格式不符合字段文档类型,根据端点不同可能会受到影响。 - **变更内容:**参数必须与其 Schema 定义的类型完全匹配。例如, `Int` 字段仅接受整数值——字符串输入如 `"5"` 将不再被接受。这不仅限于 Int 字段——任何以不匹配其文档类型的格式传递的参数都可能受到影响。 - **您在 2026 年 8 月 30 日之前应该做的:** - 检查您的 API 调用中传递的值格式是否不符合文档的 Schema 类型(例如,字符串形式传递的数值)。 - 更新任何不对齐的调用。 ### 2026-06-21 - API ID 字段:类型由长整型/整型变更为字符串 目前,Cato的API网关可能会将ID字段返回为字符串或长整型(整数)。作为即将进行的基础设施更新的一部分,所有ID字段将始终以字符串形式返回。 - **变更内容:** 以前将ID字段作为数字长整型值返回的API响应(例如,`1000000002`)将始终以字符串形式返回(例如,`"1000000002"`)。 - **受影响的对象:** 对于严格将ID字段处理为长整型/整数类型的API客户端,此变更可能会导致故障。 - **2026年6月21日之前的操作:** 更新您的API客户端代码,以接受ID字段的长整型和字符串两种类型。这样可以确保平稳过渡并在变更生效时防止中断。 ### 2025年8月10日 - 修改addAdmin和updateAdmin API中的电子邮件字段 在2025年8月10日,addAdmin和updateAdmin API中的`电子邮件`字段变成可选(可为空)。此更改支持即将推出的基础架构,以支持包括使用服务主体的脚本和自动化在内的细粒度 API 访问控制。 - 当前和未来的CMA管理员必须始终包括`电子邮件`值 - 仅返回的人类管理员查询不受影响。 - 某些客户端可能需要处理响应负载中的null值,例如addAdminPayload 这通常不是重大更改,但可能会影响假设`email`始终存在的客户端。请查看您的集成以避免问题。 ### 2025年4月27日 - eventsFeed查询API支持获取最新事件 eventsFeed API 使用标记来启用事件提要的迭代拉取。标记字段显示一个标识符,指示提取事件的新迭代的开始。 API 根据唯一的标记字段从队列中读取事件,并在响应中提供下一个标记位置。如果队列中没有新事件,则标记字段为空 另一种事件消费模型是使用直接无代码集成,请参阅[将Cato事件与AWS S3集成](/v1/docs/integrating-cato-events-with-aws-s3)和[将Cato事件与Azure存储账户集成](%%LINK:13539822366493%%)。 **我们更改了什么?** - 以前,当未指定标记时,API返回最旧的可用标记。这要求在达到最新事件之前消费完整的事件队列。 - 从2025年4月27日开始,如果未指定标记,API返回最新标记。这允许API直接提取最新事件。 **这是重大更改吗?** - 对于eventsFeed API的大多数使用案例,没有影响。当标记字段用于查询时,没有更改,事件源的消费逻辑保持不变。 - 如果您有专用的逻辑来消耗队列以到达最近的事件,则不再需要此逻辑。 - 现在,如果未指定输入标记,API提供最新标记。使用此标记调用API会提取最新事件 - API响应包含一个指向最新(队列顶部)位置的标记 - 应更新对应的脚本和自动化进程。 ### 2025年2月9日 - 对于XDR API的变更,limit=0不再受到支持 我们更改了`limit`字段的功能,不再支持`limit=0`,因为这不被认为是最佳实践。为确保持续顺利运行,您需要更新依赖于此参数的任何脚本或查询。相反,您可以设置 1-2000 之间的限制,API 完全支持。 如果您需要检索所有故事,我们建议使用分页方法。 ## 即将宣布的生命周期结束通知。 ## 先前的终止公告 ### 2026年3月18日 - SecondarySocketSerial字段终止支持 `EventFieldName` API中的`secondary_socket_serial`事件字段目前被标记为已弃用,并将于2026年3月18日终止支持。 推荐的替代字段:`socket_serial`。 ### 2025年6月30日 - LastMileBwInput、InterfaceInfo和SocketInterfaceBandwidthInput类型终止支持 以下[字段和类型](https://api.catonetworks.com/documentation/#definition-LastMileBwInput)在`LastMileBWInput` API内部标记为已弃用,并将于2025年6月30日终止支持。 请改用推荐的字段和类型。 | 已废弃类型 | 推荐类型 | | --- | --- | | 下行 | 下行Mbps精度 | | 上行 | 上行Mbps精度 | 以下[字段和类型](https://api.catonetworks.com/documentation/#definition-InterfaceInfo)在`InterfaceInfo` API内部标记为已弃用,并将于2025年6月30日终止支持。 请改用推荐的字段和类型。 | 已弃用类型 | 推荐类型 | | --- | --- | | 下行带宽 | 下行带宽Mbps精度 | | 上行带宽 | 上行带宽Mbps精度 | 以下[字段和类型](https://api.catonetworks.com/documentation/#definition-SocketInterfaceWanInput)在`SocketInterfaceBandwidthInput` API内部标记为已弃用,并将于2025年6月30日终止支持。 请使用推荐的字段和类型。 | 已废弃类型 | 推荐类型 | | --- | --- | | 下行带宽 | 下行带宽Mbps精度 | | 上行带宽 | 上行带宽Mbps精度 | ### 2025年6月8日 - FieldNameInput中的EventFieldName字段终止支持 - `AuditFeed`查询API接受使用`AuditFieldFilterInput`类型的过滤器列表。每个过滤器包括一个由类型定义`FieldNameInput`的`fieldName`,目前包括两个输入字段:`AuditFieldName`和`EventFieldName`。 - 然而,只有`AuditFieldName`是有效和支持的输入字段。为了提高模式清晰度并避免混淆,`EventFieldName` 字段已从模式中移除,日期为2025年6月8日。 - 更新所有使用`auditFeed`过滤器的脚本和查询,以仅使用`AuditFieldName`输入字段。 ### 2025年5月1日 - EventFieldName类型终止支持 以下[字段和类型](https://api.catonetworks.com/documentation/#definition-EventFieldName)在`EventFieldName` API内部标记为已弃用,并将于2025年5月1日终止支持。 请改用推荐的字段和类型。 | 已弃用类型 | 推荐类型 | | --- | --- | | 应用 | 应用程序_id/应用程序_名称 | | 自定义类别 | 自定义类别_id/自定义类别_名称 | | 自定义类别 | 自定义类别_id/自定义类别_名称 | | 目标站点 | 目的站点ID/目的站点名称 | | 设备姿态配置文件 | 设备姿态配置文件 | | 内部ID | 事件ID | | rule | 规则名称 | | 源站点 | 源站点ID/源站点名称 | ### 2025年4月15日 - bgp_peer_description终止支持 `EventFieldName` API 中的 bgp_peer_description 字段已被标记为弃用,并于2025年4月15日进入生命终结(EoL)。 ### 2025年3月1日 - EventFieldName类型终止支持 在`EventFieldName` API中,以下[字段和类型](https://api.catonetworks.com/documentation/#definition-EventFieldName)已标记为已弃用,并于2025年3月1日结束生命周期(EoL)。 请改用推荐的字段和类型。 | 已废弃类型 | 推荐类型 | | --- | --- | | parent_pid | src_process_parent_pid | | pid | src_pid | | process_path | src_process_path | ### 2025年2月23日 - StoryDrillDownFilter值字段终止支持 在`StoryDrillDownFilter` Beta API中,以下[字段](https://api.catonetworks.com/documentation/#definition-StoryDrillDownFilter)已标记为已弃用,并于2025年2月23日结束生命周期(EoL)。 请改用推荐的字段和类型。 | 已废弃类型 | 推荐类型 | | --- | --- | | 值 | 未选择设备属性 | ### 2025年2月11日 - Cato事件数据的一些子类型终止支持 在宣布部分用于Cato客户端相关的事件消费API的子类型值生命周期结束后,以下字段的推出已经暂停,以确保使用爱尔兰CMA位置(cc.catonetworks.com)的账户的正常操作: | 已废弃类型 | 推荐类型 | | --- | --- | | 重新连接 | 已连接或已断开连接 | | 变更 PoP | 已连接或已断开连接 (PoP名称在lastPopName字段中返回。) | - 有关更多信息,请参阅[CMA - 技术指南](/v1/docs/cma-technical-guidelines) ### 2025年1月2日 - 事件子类型终止支持 与 Cato 客户端相关的以下字段和类型已被标记为弃用,并将在 2025 年 1 月 2 日达到生命周期终止(EoL)。 请改用推荐的字段和类型。 | 已废弃类型 | 推荐类型 | 注意事项 | | --- | --- | --- | | VPN永不关闭-绕过 | 始终开启绕过 | VPN永不关闭-绕过子类型值将被替换为值始终开启绕过 | | 重新连接 | 已连接或已断开连接 | 为了增加精细度,已重新连接子类型值将分为两个新的值:已连接和已断开连接 | | 变更 PoP | 已连接或已断开连接 (PoP名称在lastPopName字段中返回) | 为了增加精细度,已更改PoP子类型值将分为两个新的值:已连接和已断开连接 | - 欲了解更多信息,请参阅此文章:[即将结束生命周期的部分Cato事件数据子类型](/v1/docs/upcoming-eol-for-some-subtypes-of-cato-event-data)