接口请求域名： edgezone.intl.tencentcloudapi.com 。
创建私网实例，一个用户在一个可用区仅支持创建一个私网实例，网络地址由 Network（网络号）和 Mask（掩码位数）两个参数共同决定子网范围。Network 必须是三个 RFC 1918 私有地址段之一的合法网络地址：10.0.0.0/8、172.16.0.0/12 或 192.168.0.0/16，且 host 位必须全为 0（即Network 与 Mask 组合后不能有主机位被置位，例如 10.0.0.1/24 是非法的，应填 10.0.0.0/24）。Mask 的上限统一为 28，下限由所属地址段决定：10.x.x.x 段允许 8～28，172.16.x.x 段允许 12～28，192.168.x.x 段允许 16～28。
默认接口请求频率限制：20次/秒。
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：CreatePrivateNetworkInstance。 |
| Version | 是 | String | 公共参数，本接口取值：2026-04-01。 |
| Region | 是 | String | 公共参数，详见产品支持的 地域列表。 |
| NetworkInstanceName | 是 | String | 新实例名称 |
| ZoneId | 是 | String | 可用区ID |
| Network | 是 | String | 网络地址（host 位必须全为 0），必须落在以下 RFC 1918 私有范围之一：10.0.0.0/8、172.16.0.0/12、192.168.0.0/16 |
| Mask | 是 | Integer | 掩码位数，上限统一为 28，下限随所属私有段而定：10.0.0.0/8 允许 8~28，172.16.0.0/12 允许 12~28，192.168.0.0/16 允许 16~28；需与 Network 共同构成合法网络地址（host 位全为 0） |
| 参数名称 | 类型 | 描述 |
|---|---|---|
| NetworkInstanceId | String | 私网实例ID |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
POST / HTTP/1.1
Host: edgezone.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreatePrivateNetworkInstance
<公共请求参数>
{
"NetworkInstanceName": "test-pri-instance",
"ZoneId": "ap-beijing",
"Network": "10.0.0.0",
"Mask": 24
}
{
"Response": {
"RequestId": "test-req-011",
"NetworkInstanceId": "ein-a1b2c3d4"
}
}
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| FailedOperation.PrivateInstanceDuplicate | 该 AppId 在指定可用区已存在私网实例 |
| InternalError | 内部错误。 |
| InvalidParameter | 参数错误。 |
| InvalidParameterValue.InvalidNetwork | 子网网络地址格式不合法 |
文档反馈