本接口用于创建自定义私有网络。
下表列出了接口特定的请求参数以及公共请求参数 Action 和 Version。 其他公共参数,请参见公共参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | CreateCustomVPCInstance | 接口名称。当前 API 的名称为 CreateCustomVPCInstance。 |
Version | String | 是 | 2021-04-30 | 接口版本。当前 API 的版本为 2021-04-30。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
vpc_name | String | 是 | vpc_dev | 私有网络的名称。命名规则如下:
|
cluster_name | String | 是 | **cm03 | 私有网络所属的节点。 |
segment | String | 是 | 10.0.0.0/8 | 私有网络的网段。 推荐您使用RFC标准定义的私有网段10.0.0.0/8、172.16.0.0/12、192.168.0.0/16及其子网。 |
desc | String | 是 | vpc_dev | 私有网络的描述信息。您最多可以输入80个字符。 |
subnets | Object[] | 是 | - | 子网的信息。 |
project | String | 否 | default | 私有网络所属的项目。 |
Tags | Object[] | 否 | - | 私有网络的标签。 |
下表仅列出本接口特有的返回参数。更多信息请参见返回结果。
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
vpc_instance | Object | - | 私有网络的信息。 |
POST https://veenedge.volcengineapi.com/?Action=CreateCustomVPCInstance&Version=2021-04-30 &<其他公共参数> { "vpc_name": "vpc_dev", "cluster_name": "**cm03", "segment": "10.0.0.0/8", "desc": "dev01", "subnets": [ { "name": "subnet_dev", "cidr": "10.1.0.0/16", "desc": "dev01" } ] }
{ "ResponseMetadata": { "RequestId": "20240307213043BDBD589330F4C493****", "Action": "CreateCustomVPCInstance", "Version": "2021-04-30", "Service": "veenedge", "Region": "cn-north-1" }, "Result": { "vpc_instance": { "account_identity": 210006****, "user_identity": 0, "vpc_identity": "vpc-twqb9w****", "vpc_name": "vpc_dev", "vpc_ns": "ns-210006****", "cluster_vpc_id": 24**, "cluster": { "cluster_name": "**cm03", "country": "CN", "region": "EastChina", "province": "ZJ", "city": "330100", "isp": "CMCC", "level": "2", "alias": "**移动03" }, "status": "modifying", "is_default": false, "desc": "dev01", "sub_nets": [ { "account_identity": 210006****, "user_identity": 0, "subnet_identity": "subnet-b8h28fnz9lx****", "cidr_ip": "10.1.0.0", "cidr_mask": 16, "name": "subnet_dev", "desc": "dev01", "status": "modifying", "create_time": 1709818243, "update_time": 1709818243 } ], "local_account_vgw_num": 0, "cross_account_vgw_num": 0, "is_custom": true, "segment": "10.0.0.0/8", "create_time": 1709818244, "update_time": 1709818244 } } }
如果响应正文中包含 Error 字段,则表示 API 请求失败。关于错误码的更多信息,参见错误码。