Release an Instance (Release of the POST Request)
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. Only the instance and system disk are released during release by default. You can select whether the associated EIP + data disk that current instance mounts to is released together. They can be released or not released uniformly. One or more mounted data disks can not be released respectively.
Request Structure
POST /v{version}/instance/{instanceId} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
{
"relatedReleaseFlag": relatedReleaseFlag,
"deleteCdsSnapshotFlag":deleteCdsSnapshotFlag
}Request Header Field
There are no other special header fields except the public header field.
Request Parameters
| Parameter Name | Type | Required | Parameter Position | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number |
| instanceId | String | Yes | URL parameter | Instance ID |
| relatedReleaseFlag | boolean | Yes | RequestBody parameter | Whether the associated EIP + data disk that the instance mounts to is released at current time? The false represents No, and the true represents Yes. The deleteCdsSnapshotFlag field is valid only when this field is true. If this field is false, the deleteCdsSnapshotFlag field is invalid. |
| deleteCdsSnapshotFlag | boolean | Yes | RequestBody parameter | Whether the disk snapshot is released? The false represents No, and the true represents Yes. |
Return Header Field
There are no other special header fields except the public header field.
Return Parameters
No specific parameters are returned.
| Error Code | Error Description | HTTP Status Code | Explanations |
|---|---|---|---|
| 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 not prepay. | 403 | The non-prepaid instance can not be released. |
Request Instance
POST /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/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"relatedReleaseFlag": true,
"deleteCdsSnapshotFlag":true
}Return Instance
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