CreateSubnet

CreateSubnet

1. API Description

This API is used to create a subnet under a VPC.

Note

  • The quantity of subnets you can create under one VPC is limited. The IP range of the subnet under a VPC should be a subset of the VPC IP range.

  • IP ranges of subnets under the same VPC cannot be overlapped.

  • Call DescribeSubnetRegions to query regions supporting subnet creation.

2. Input Parameters

The following request parameter list only provides API request parameters.

Parameter Name
Required
Type
Description

vpcId

Yes

String

VPC ID.

regionId

Yes

String

Region ID.

stackType

Yes

String

Subnet IP stack type. The optional values are as follows: IPv4, IPv4_IPv6, IPv6

ipv6Type

No

String

Subnet IPv6 type. The optional values are as follows: Public, Private

name

Yes

String

Subnet name to be displayed.

This parameter must start and end with a number or a letter, containing 2 to 63 characters. Only letters, numbers, - and periods (.) are supported.

cidrBlock

Yes

String

CIDR block of the subnet.

3. Output Parameters

Parameter Name
Type
Description

requestId

String

The unique request ID, which is returned for each request. RequestId is required for locating a problem.

subnetId

String

Subnet ID.

4. Code Example

Create a subnet under a VPC.

POST /api/v2/zec HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: CreateSubnet
<Common Request Params>

Request:
{
  "vpcId": "xxxx",
  "regionId": "xxx",
  "stackType": "IPv4_IPv6",
  "ipv6Type": "Public",
  "name": "XXX",
  "cidrBlock": "10.0.0.0/8",
}

Response:
{
  "requestId": "TBFC01FCF-6439-4530-ADBC-16809F0C3E8F",
  "response": {
    "requestId": "TBFC01FCF-6439-4530-ADBC-16809F0C3E8F",
    "subnetId": "xxxx"
  }
}

5. Developer Resources

Zenlayer Cloud API 2.0 integrates SDKs to make it easier for you to call APIs. More programming languages will be supported.

6. Error Codes

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.​

HTTP Status Code
Error Code
Description

404

OPERATION_FAILED_RESOURCE_NOT_FOUND

VPC does not exist.

400

INVALID_PARAMETER_SUBNET_IPV6_TYPE_NOT_FOUND

ipv6Type does not exist.

400

INVALID_PARAMETER_SUBNET_CIDR_NOT_FOUND

cidrBlock does not exist.

400

INVALID_PARAMETER_SUBNET_CIDR_NEED_EMPTY

cidrBlock should be empty.

400

OPERATION_DENIED_DEFAULT_VPC

Operations are not supported for the default VPC.

400

OPERATION_DENIED_SUBNET_TYPE_NOT_SUPPORT_IPV6

IPv6 is not supported for the subnet.

400

INVALID_REGION_NOT_ON_SALE

Not for sale in the region.

400

OPERATION_DENIED_SUBNET_CIDR_CONFLICT

IP ranges of subnets under the same VPC are overlapped.

Last updated