1. API Description

This API is used to create one or more IPv4 CIDR blocks.



  • If you create a subscription CIDR block, the amount required will be pre-deducted. If the balance is insufficient, the request will fail. If you create a pay-as-you-go CIDR block, please ensure your account balance is sufficient before calling this API.

  • Vouchers can be used for fee deduction in instance creation. See Vouchers for more details.

  • This API is an async API. A CIDR block ID list is returned after the creation request is sent. However, it does not mean the creation has been completed. The status of the CIDR block will be CREATING during the creation. You can use DescribeCidrBlocks to query the status of the CIDR block. If the status changes from Creating to Available, it means that the CIDR block has been created successfully; CREATE_FAILED means the CIDR block has been created failed. Any operations on the instances are not allowed while creating.

2. Input Parameters

The following request parameter list only provides API request parameters.

3. Output Parameters

4. Code Example

Create a postpaid IPv4 CIDR block example1 with the netmask of 29 **** in IST-B, belonging to Default Resource Group.

POST /api/v2/bmc HTTP/1.1
Content-Type: application/json
X-ZC-Action: CreateIpv4Block
<Common Request Params>

  "zoneId": "IST-B",
  "name": "example1",
  "chargeType": "POSTPAID",
  "netmask": 29

  "requestId": "T135376EE-7090-4773-B81E-7FB38358B656",
  "response": {
    "requestId": "T135376EE-7090-4773-B81E-7FB38358B656",
    "orderNumber": "orderNum",
    "cidrBlockIds": [

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.​

Last updated