1. Interface Description
Interface request domain name: vpc.api3.convergecloud.com.
This API is used to create a VPC.
- The smallest IP range a user can create has a subnet mask of 28 (16 IP addresses), and the largest IP range has a subnet mask of 16 (65,536 IP addresses). For VPC IP range planning, see the VPC IP range planning documentation.
- The number of VPC resources that can be created in the same region is limited. For details, see VPC Usage Limits. If you need to increase the limit, contact online customer service.
- Tags can be bound to the VPC during its creation. The tag list in the response represents the successfully added tags.
Default interface request rate limit: 100 times per second.
Interface update time: 2025-04-28 20:19:16.
The interface only verifies the signature but does not authenticate.
2. Input Parameters
The following list of request parameters only lists interface request parameters and some public parameters, For a complete list of public parameters see public request parameters.
| Parameter name | Required | Allow NULL | Type | Description |
|---|---|---|---|---|
| Action | Yes | No | String | Public parameter, The value of this interface: CreateVpc |
| Version | Yes | No | String | Public parameter, The value of this interface: 2017-03-12 |
| Region | No | No | String | Public parameter,Regional information A list of supported geographies is available through the DescribeRegions interface |
| VpcName | Yes | No | String | VPC name, up to 60 bytes in length. Example: demoVPC |
| CidrBlock | Yes | No | String | VPC CIDR, limited to three private IP ranges: 10.0.0.0/16, 172.16.0.0/16, and 192.168.0.0/16. Example: 10.8.0.0/16 |
| EnableMulticast | No | No | String | Whether to enable multicast. True: Enable; False: Disable. Example: true |
| DnsServers | No | No | Array of String | DNS address, up to 4. Example: ['11.10.1.13', '11.10.1.11'] |
| DomainName | No | No | String | Domain name Example: cloud.com |
| Tags | No | No | Array of Tag | Specifies the list of tags for binding. For example, [{"Key": "city", "Value": "region"}]. Example:View |
3. Output Parameters
| Parameter name | Type | Description |
|---|---|---|
| Vpc | Vpc | VPC object. Example:View |
| RequestId | String | Unique request id, Each request will return. The RequestId of the request needs to be provided when locating the problem. |
4. Error Code
The following lists only the error codes related to the interface business logic, For other error codes, see public ErrorCode.
| Error Code | Description |
|---|---|
| InvalidParameterValue | The parameter value is invalid. |
| LimitExceeded | Exceeded the limit |
| InvalidParameterValue.Malformed | Invalid input format. |
| ResourceNotFound | The resource does not exist |
| InvalidParameterValue.LimitExceeded | The parameter value exceeds the limit. |
| MissingParameter | Missing parameters. The request did not carry the required parameter. |