--- title: "配置 API - 更新站点一般详情" slug: "configuration-api-updatesitegeneraldetails" updated: 2026-07-30T03:27:47Z published: 2026-07-30T03:27:47Z canonical: "knowledge.catonetworks.com/configuration-api-updatesitegeneraldetails" --- > ## 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 - 更新站点一般详情 我们强烈建议您在开始使用Cato API之前,请查看[Cato API支持政策](/v1/docs/support-policy-for-the-cato-api)。 ## 更新站点一般详情概览 使用 updateSiteGeneralDetails 变更 API 更新以下设置在 Cato 管理应用程序的 **常规** 部分中(网络 > 站点 > {site name} > 站点配置 > 常规) - 名称 - 描述 - 类型 - 时区 - 国家 - 州 - 地址 ### 定位您的账户 ID 此账户ID不显示在Cato管理应用程序中,而是网址中为Cato管理应用程序的号码。 例如,以下网址的账户ID为26: https://cc.catonetworks.com/#!/26/topology。 在站点创建 API 的`accountId`参数中输入此 ID,例如: ```plaintext site(accountId: 26) {    addSocketSite(input: $addSocketSite) {        siteId    } } ``` ### 定位站点的站点 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。 ## 更新站点一般详情参数的详情 这些是使用 Cato 配置 API 更新站点的一般设置参数。 除非标记为可选,否则参数是必需的: - name - 站点的名称 - siteType - 组织中站点的类型,例如云数据中心 - description - (可选)站点的描述 - siteLocation - 站点物理位置的数据 ### 更新站点一般详情的名称 更新站点的名称。 ### 更新站点一般详情的站点类型 `siteType`是一个枚举参数,定义站点的类型,用于确定 Cato 管理应用程序中监控 > 拓扑屏幕中使用哪个图标。 这些是选项: - BRANCH - 物理或虚拟站点 - HEADQUARTERS - 公司总部的物理站点 - CLOUD_DC - 云数据中心的虚拟站点 - DATACENTER - 数据中心的物理站点 ### 更新站点一般详情的描述(可选) `description`是一个可选的自由文本字段,用于描述站点。 ### 更新站点一般详情的站点位置 `siteLocation`参数定义站点的以下物理详情。 `countryCode` 与您账户中特定**区域**可用的站点许可证数量相关。 您可以使用 entityLookup API 查询以检索这些参数的值,请参阅[Cato API - EntityLookup](/v1/docs/cato-api-entitylookup)。 这些是`siteLocation`参数: - countryCode - 站点所在国家的两字母代码(ISO 3166-1 alpha-2) 对于 entityLookup,使用`类型`,值为**国家** - stateCode - (可选)对于适用国家,站点所在的州 对于 entityLookup,使用`类型`,值为**国家州** - timezone - 站点的时区,用于设置 Socket 和 vSocket 升级的维护窗口时间框架 对于 entityLookup,使用`类型`,值为**时区** - address - (可选)物理站点的街道地址 ## 示例Postman脚本 ```plaintext mutation updateSiteGeneralDetails ($accountId: ID!, $siteID: ID!, $input: UpdateSiteGeneralDetailsInput!) {    site(accountId: $accountId) {        updateSiteGeneralDetails (siteId: $siteID, input: $input) {            siteId        }    } } ``` **GraphQL变量** ```plaintext {    "accountId": "",    "siteID": "",    "input": {        "name": "MySite",        "description": "我使用 API 的第一个数据中心",        "siteType": "DATACENTER",        "siteLocation": {            "countryCode": "FR",            "timezone": "Europe/Paris"        }    } } ``` **相关资源** - [使用卡托站点创建API与Postman](/v1/docs/using-the-cato-site-creation-api-with-postman) - [配置 API 脚本](https://support.catonetworks.com/hc/en-us/articles/8130916998429)