DestroyPort

1. API Description

This API (DestroyPort) is used to destroy Port

Notes

• This operation is irreversible. Once successful, the port will be permanently released -- proceed with caution.

• Only ports in the recycle bin support this operation.

• This is an asynchronous API. After the destroy-port request is successfully submitted and a request ID is returned, the destroy operation is not completed immediately. During this period the port status will be DESTROYING. You can check the result by calling DescribePorts -- if the port status changes from DESTROYING to DESTROYED, the port was destroyed successfully and will no longer be returned in the list. Do not perform any operation on the port while it is being destroyed.

2. Input Parameters

The following request parameter list only provides API request parameters.

Parameter Name	Required	Type	Description
portId	Yes	String	Port ID.

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

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

Request:
{
  "portId": "your-port-id"
}

Response:
{
  "requestId": "T3811A0E7-C250-40A2-96AD-08AD759E1BC2",
  "response": {
    "requestId": "T3811A0E7-C250-40A2-96AD-08AD759E1BC2"
  }
}

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