--- title: "配置 API - addSocketSite" slug: "configuration-api-addsocketsite" updated: 2026-07-30T03:27:46Z published: 2026-07-30T03:27:46Z canonical: "knowledge.catonetworks.com/configuration-api-addsocketsite" --- > ## 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 - addSocketSite 我们强烈建议您在开始使用Cato API之前,请查看[Cato API支持政策](/v1/docs/support-policy-for-the-cato-api)。 ## addSocketSite 概述 使用 addSocketSite 变更 API 在您的账户中创建一个新的 Socket 站点,并为该站点定义以下设置: - Name - 说明 - 威胁类型 - 连接类型 - 时区 - 国家 - 州 - 地址 - 本地范围 该站点将使用默认的带宽设置创建,即下行25 Mbps和上行25 Mbps,并且未分配许可证。 对于经销商账户,您可以在配置 Cato API 的设置时,在每个客户的账户中创建单独的 API 密钥。 ### 定位您的账户 ID 此账户 ID 不显示在 Cato 管理应用程序 中,而是网址中 Cato 管理应用程序 的号码。 例如,以下网址中的账户 ID 是 26: https://cc.catonetworks.com/#!/26/topology。 在站点创建 API 的`accountId`参数中输入此 ID,例如: ```plaintext site(accountId: 26) {    addSocketSite(input: $addSocketSite) {        siteId    } } ``` ## addSocketSite 参数详情 这些是使用 Cato 配置 API 创建一个新的 Socket 站点的参数。 除非标记为可选,否则参数是必需的: - name - 站点的名称 - connectionType - 该站点的物理 Socket 或 vSocket - siteType - 组织中站点的类型,例如云数据中心 - description - (可选)站点的描述 - nativeNetworkRange - 站点后本地 LAN 的 IP 范围,以 CIDR 格式 - siteLocation - 站点物理位置的数据 ### AddSocketSite 名称 定义您正在创建的 Socket 站点的名称。 ### AddSocketSite 连接类型 `connectionType` 是一个枚举参数,用于定义站点的物理或虚拟 Socket 类型。 这些是选项: - SOCKET_X1500 - 物理站点的 X1500 或 X1500B Socket - SOCKET_X1600 - 物理站点的 X1600 Socket - SOCKET_X1700 - 物理站点的 X1700 或 X1700B Socket - SOCKET_ESX - 虚拟 VMware 站点的 vSocket - SOCKET_AWS - 虚拟 AWS 站点的 vSocket - SOCKET_AZURE - 虚拟 Azure 站点的 vSocket ### AddSocketSite 站点类型 `siteType`是一个枚举参数,定义站点的类型,用于确定 Cato 管理应用程序中监控 > 拓扑屏幕中使用哪个图标。 这些是选项: - BRANCH - 物理或虚拟站点 - HEADQUARTERS - 公司总部的物理站点 - CLOUD_DC - 云数据中心的虚拟站点 - DATACENTER - 数据中心的物理站点 ### AddSocketSite 描述(可选) `description`是一个可选的自由文本字段,用于描述站点。 ### AddSocketSite 本地网络范围 定义站点的 LAN 本地范围的 IP 范围,在 `nativeNetworkRange` 参数中以 IPSubnet 格式。 本地范围使用 CIDR 用于子网,/32 CIDR 区块不被支持。 ### AddSocketSite 站点位置 `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 变更 addSocketSite ($accountId: ID!, $input: AddSocketSiteInput!) {    site(accountId: $accountId) {        addSocketSite (input: $input) {            siteId        }    } } ``` **GraphQL变量** ```plaintext {    "accountId": "26",    "input": {        "name": "SampleUsSite2",        "description": "My first API site",        "siteType": "BRANCH",        "connectionType": "SOCKET_X1500",        "nativeNetworkRange": "10.0.0.0/24",        "siteLocation": {            "countryCode": "US",            "timezone": "US/Central",            "stateCode": "US-AL"        }    } } ``` **相关资源** - [使用卡托站点创建API与Postman](/v1/docs/使用Cato网站创建API与Postman)