DeleteCIDR

1. API Description

This API is used to return a CIDR block.

Note

• Use this API to return a CIDR block that is no longer required. A pay-as-you-go CIDR block will stop billing after it is returns.

• You cannot return a subscription CIDR block using this API, which will be returned when subscription expires.

• You cannot return the CIDR block if the IP in it is assigned to an instance. Please unassign all the instances before returning the CIDR block.

• The returned IPv4 CIDR block will be released directly.

• Operations on CIDR blocks in recycle bin or in CREATING status are not supported.

• Operations on CIDR block in CREATE_FAILED status will delete the CIDR block directly. For prepaid CIDR blocks, all payment amounts will be refunded.

2. Input Parameters

The following request parameter list only provides API request parameters.

Parameter Name	Required	Type	Description
cidrBlockId	Yes	String	ID of the CIDR block. You can find the cidrBlockId in the response by calling CIDRDetails.

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.

4. Code Example

Example

Return a CIDR block.

POST / HTTP/1.1
Host: console.harmonynetworks.net/api/v2/bmc
Content-Type: application/json
X-ZC-Action: DeleteCIDR
<Common Request Params>

Request:
{
  "cidrBlockId": "cidrBlockId"
}

Response:
{
  "requestId": "TC9E90021-5016-455C-B2F4-9D640EF63176",
  "response": {
    "requestId": "TC9E90021-5016-455C-B2F4-9D640EF63176"
  }
}

5. 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
403	OPERATION_DENIED_CIDRBLOCK_SUBSCRIPTION	Return on prepaid CIDR blocks not supported.
403	OPERATION_DENIED_INSTANCE_EXIST	Return on CIDR blocks with instances assigned not supported.