1. Interface Description
Interface request domain name: vpc.api3.convergecloud.com.
This API (CreateSubnets) is for the batch creation of subnets.
- 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: 20 times per second.
Interface update time: 2020-04-15 04:57:52.
The interface is both signature verification and authentication.
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: CreateSubnets |
| 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 | VPC instance ID, e.g., vpc-6v2ht8q5. Example: vpc-6v2ht8q5 |
| Subnets | Yes | No | Array of SubnetInput | Subnet object list. Example:View |
| Tags | No | No | Array of Tag | Specifies the list of tags for binding. Note: These tags are shared by all subnet objects in the list. Specifying a tag separately for each subnet object is not supported. For example, [{"Key": "city", "Value": "region"}]. Example:View |
3. Output Parameters
| Parameter name | Type | Description |
|---|---|---|
| SubnetSet | Array of Subnet | Newly created subnet list. 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 |
|---|---|
| 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. |