--- title: "配置 API - updateHa" slug: "configuration-api-updateha" updated: 2026-07-30T03:27:57Z published: 2026-07-30T03:27:57Z canonical: "knowledge.catonetworks.com/configuration-api-updateha" --- > ## 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. # 配置 API - updateHa 我们强烈建议您在开始使用Cato API之前,请查看[Cato API支持政策](/v1/docs/support-policy-for-the-cato-api)。 ## updateHa 概述 使用 `updateHa` 变更 API 更新 Cato管理应用程序中的具备 Socket 高可用 (HA) 配置的站点的 **Socket** 部分中的以下设置 (网络 > 站点 > {site name} > 站点配置 > Socket): - 主要和次要 Socket 的管理 IP 地址 - VRID - 用于标识主 Socket 何时关闭和何时功能正常的 VRRP 信息的 ID > [!NOTE] > 注意: > > 您只能在两个 Sockets 都分配给一个站点,并使用 Cato 管理应用程序配置为 Socket HA 站点后,运行 `updateHa` API。 ### 定位站点的站点 ID 站点 ID 未显示在 Cato 管理应用程序中,您可以定位站点 ID: - 使用 entityLookup API 查询(请参阅[Cato API - EntityLookup](/v1/docs/cato-api-entitylookup)),使用`类型`,值为**site** 您还可以使用 `search` 参数,将值设为站点名称,查询返回站点 ID - Cato 管理应用程序的 URL 中的数字,当您选择了一个站点时 (网络 > 站点 > {site name})。 例如,以下网址的站点 ID 是 12345: https://cc.catonetworks.com/#/26/sites/12345/networkAnalytics ## updateHa 参数细节 这些是使用 Cato 配置 API 更新站点的 HA Socket 设置的参数。 所有 `updateHaInput` 参数都是可选的: - primaryManagementIp - 主 Socket 的管理 IP 地址 - secondaryManagementIp- 次 Socket 的管理 IP 地址 - VRID - 用于 VRRP 信息的虚拟路由标识符 ### updateHaInput primaryManagementIp 更新主 Socket 的管理 IP 地址。 您可以使用此 IP 地址访问主 Socket 的 WebUI。 ### updateHaInput secondaryManagementIp 更新次 Socket 的管理 IP 地址。 您可以使用此 IP 地址访问次 Socket 的 WebUI。 ### updateHaInput vrid 更新主 Socket 和次 Socket 之间的 VRRP 信息的 VRID(虚拟路由标识符)。 默认 VRID 为 100。 ## 示例Postman脚本 ```plaintext mutation updateHa ($accountId: ID!, $siteId: ID!, $input: UpdateHaInput!) { site(accountId: $accountId) { updateHa (siteId: $siteId, input: $input) { siteId } } } ``` **GraphQL变量** ```plaintext { "accountId": "26", "siteId": 126, "input": { "primaryManagementIp": "192.168.4.2", "secondaryManagementIp": "192.168.4.3", "vrid": 100 } } ``` **相关资源** - [使用卡托站点创建API与Postman](/v1/docs/使用Postman与Cato站点创建API) - [配置 API 脚本](https://support.catonetworks.com/hc/en-us/articles/8130916998429)