1. Interface Description
Interface request domain name: vpc.api3.convergecloud.com.
This API (CreateSubnet) is used to create a subnet.
- Before a subnet is created, a VPC must be created first.
- After a subnet is successfully created, the subnet IP range cannot be modified. The subnet IP range must fall under the VPC IP range and can be the same as the VPC IP range (when VPC has and only has one subnet). It is recommended to have the subnet IP range in the VPC IP range, and reserve the IP range for other subnets.
- The smallest subnet mask you can create is 28 (with 16 IP addresses), and the largest subnet mask is 16 (with 65,536 IP addresses).
- Within the same VPC, the IP ranges of multiple subnets must not overlap.
- A subnet will automatically be associated with the default routing table upon creation.* When creating a subnet, you can also bind tags, and the list of tags in the response represents the successfully added tags.
Default interface request rate limit: 100 times per second.
Interface update time: 2025-04-28 20:14:22.
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: CreateSubnet |
| 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 |
| VpcId | Yes | No | String | ID of VPC instance to be operated. It can be accessed through VpcId in the returned value of the DescribeVpcs API. Example: vpc-m3ul053f |
| SubnetName | Yes | No | String | Subnet name, up to 60 bytes in length. Example: demoSubnet |
| CidrBlock | Yes | No | String | Subnet IP range. The subnet IP range must be within the VPC IP range. Subnet IP ranges must not overlap within a same VPC. Example: 10.8.0.0/16 |
| Zone | Yes | No | String | Availability zone ID where the subnet is located. For different subnets, different availability zones are selected for cross-availability zone disaster recovery. Example: ap-region-1 |
| 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 |
|---|---|---|
| Subnet | Subnet | Subnet 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. |
| InvalidParameter | Invalid input parameters. |
| LimitExceeded | Exceeded the limit |
| InvalidParameterValue.Malformed | Invalid input format. |
| ResourceNotFound | The resource does not exist |
| InvalidParameterValue.SubnetRange | Invalid subnet CIDR. |
| InvalidParameterValue.SubnetConflict | There's a subnet CIDR conflict. |
| InvalidParameterValue.LimitExceeded | The parameter value exceeds the limit. |
| MissingParameter | Missing parameters. The request did not carry the required parameter. |