Release Instance
Last Updated：2021-11-12
It releases an individual BCC instance. After the release, all physical resources the instance uses are recovered, and all relevant data is lost and can not be recovered.
- You can only release the postpaid or prepaid instance expired.
- After the release of instance, the mounted CDS disk is uninstalled automatically, while the snapshot based on this CDS disk is retained.
- After the release of instance, the snapshot based on the original system disk is deleted automatically, while the custom image based on the original system disk is retained.
Request Structure
DELETE /v{version}/instance/{instanceId} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
…Request header field
No other special header fields are available, except for common header fields.
Request Parameter
| Parameter name | Type | Required? | Parameter Position | Description |
|---|---|---|---|---|
| version | String | Yes | URL Parameter | API version number |
| instanceId | String | Yes | URL Parameter | Instance ID of virtual machine to release |
Return Header Field
There are no other special header fields except the public header field.
Return Parameter
No specific parameters are returned.
Error Code
| Error Code | Error Description | HTTP status code | Explanation |
|---|---|---|---|
| Instance.ReleaseWhileCreating | Instance can not release during creating. | 403 | The instance can not be released in the Creating status. |
| Instance.ReleaseNotPrepay | Instance can not release if prepay. | 403 | The non-prepaid instance can not be released. |
Request Example
DELETE /v2/instance/i-YufwpQAe HTTP/1.1
Host: bcc.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1deReturn Examples
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS