Press CTRL+K to open search

配置 API - 更新站点一般详情

  • 更新于 Jul 30, 2026
  • 发布于 Jul 7, 2026
  • 1 分钟阅读
Prev Next

我们强烈建议您在开始使用Cato API之前，请查看Cato API支持政策。

更新站点一般详情概览

使用 updateSiteGeneralDetails 变更 API 更新以下设置在 Cato 管理应用程序的 常规 部分中（网络 > 站点 > {site name} > 站点配置 > 常规）

  • 名称

  • 描述

  • 类型

  • 时区

  • 国家

  • 州

  • 地址

定位您的账户 ID

此账户ID不显示在Cato管理应用程序中，而是网址中为Cato管理应用程序的号码。 例如，以下网址的账户ID为26： https://cc.catonetworks.com/#!/26/topology。

在站点创建 API 的accountId参数中输入此 ID，例如：

site(accountId: 26) {
    addSocketSite(input: $addSocketSite) { 
        siteId 
    } 
}

定位站点的站点 ID

站点 ID 不会显示在 Cato 管理应用程序中，您可以定位站点 ID：

  • 使用 entityLookup API 查询（请参阅Cato API - EntityLookup），使用类型，值为site

    您还可以使用 search 参数，将值设为站点名称，查询返回站点 ID

  • Cato 管理应用程序的 URL 中的编号，当您选择了一个站点时（网络 > 站点 > {site name}）。 例如，以下网址的站点ID是12345： https://cc.catonetworks.com/#/26/sites/12345/networkAnalytics。

更新站点一般详情参数的详情

这些是使用 Cato 配置 API 更新站点的一般设置参数。 除非标记为可选，否则参数是必需的：

  • name - 站点的名称

  • siteType - 组织中站点的类型，例如云数据中心

  • description - （可选）站点的描述

  • siteLocation - 站点物理位置的数据

更新站点一般详情的名称

更新站点的名称。

更新站点一般详情的站点类型

siteType是一个枚举参数，定义站点的类型，用于确定 Cato 管理应用程序中监控 > 拓扑屏幕中使用哪个图标。

这些是选项：

  • BRANCH - 物理或虚拟站点

  • HEADQUARTERS - 公司总部的物理站点

  • CLOUD_DC - 云数据中心的虚拟站点

  • DATACENTER - 数据中心的物理站点

更新站点一般详情的描述（可选）

description是一个可选的自由文本字段，用于描述站点。

更新站点一般详情的站点位置

siteLocation参数定义站点的以下物理详情。 countryCode 与您账户中特定区域可用的站点许可证数量相关。

您可以使用 entityLookup API 查询以检索这些参数的值，请参阅Cato API - EntityLookup。

这些是siteLocation参数：

  • countryCode - 站点所在国家的两字母代码（ISO 3166-1 alpha-2）

    对于 entityLookup，使用类型，值为国家

  • stateCode - （可选）对于适用国家，站点所在的州

    对于 entityLookup，使用类型，值为国家州

  • timezone - 站点的时区，用于设置 Socket 和 vSocket 升级的维护窗口时间框架

    对于 entityLookup，使用类型，值为时区

  • address - （可选）物理站点的街道地址

示例Postman脚本

mutation updateSiteGeneralDetails ($accountId: ID!, $siteID: ID!, $input: UpdateSiteGeneralDetailsInput!) {
    site(accountId: $accountId) {
        updateSiteGeneralDetails (siteId: $siteID, input: $input) {
            siteId
        }
    }
}

GraphQL变量

{
    "accountId": "",
    "siteID": "",
    "input": {
        "name": "MySite",
        "description": "我使用 API 的第一个数据中心",
        "siteType": "DATACENTER",
        "siteLocation": {
            "countryCode": "FR",
            "timezone": "Europe/Paris"
        }
    }
}

相关资源

相关文章