Releases a pay-as-you-go instance or an expired subscription Elastic Compute Service (ECS) instance.
Operation description
-
After an instance is released, all the physical resources used by the instance are reclaimed by Alibaba Cloud. Data stored on the instance is deleted permanently and cannot be restored.
-
Disk settings may affect their behavior when the instances they are attached to are released. Take note of the following items:
- If
DeleteWithInstance
is set to false, the disks are retained as pay-as-you-go disks. - If
DeleteWithInstance
is set to true, the disks are released along with the instance. - If
DeleteAutoSnapshot
is set to false, automatic snapshots of the disks are retained. - If
DeleteAutoSnapshot
is set to true, automatic snapshots of the disks are released. - Manual snapshots of the disks are retained.
- If the response contains
{"OperationLocks": {"LockReason" : "security"}}
, the instance is locked for security reasons. In this case, even if theDeleteWithInstance
parameter is set tofalse
for the data disks that are attached to the instance, the parameter is ignored and the data disks are released along with the instance. For more information, see API behavior when an instance is locked for security reasons.``
- If
Debugging
Authorization information
There is currently no authorization information disclosed in the API.
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
InstanceId | string | Yes | The ID of the instance. | i-bp1g6zv0ce8oghu7**** |
Force | boolean | No | Specifies whether to forcefully release the instance in the
Default value: false. | false |
TerminateSubscription | boolean | No | Specifies whether to release an expired subscription instance. Default value: false. | false |
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | DependencyViolation.SLBConfiguring | Specified operation is denied as your instance is using by another product. | The instance is referenced by an SLB instance that is being configured. |
400 | DependencyViolation.RouteEntry | Specified instance is used by route entry. | Custom route entries exist in the VPC and the VPC cannot be deleted. |
400 | InvalidParameter | The input parameter InstanceId is invalid. | The specified InstanceId parameter is invalid. |
403 | IncorrectInstanceStatus | The current status of the resource does not support this operation. | The resource is in a state that does not support the current operation. |
403 | InstanceLockedForSecurity | The specified operation is denied as your instance is locked for security reasons. | - |
403 | ChargeTypeViolation | The operation is not permitted due to charge type of the instance. | The operation is not supported while the instance is using the current billing method. |
403 | IncorrectInstanceStatus.Initializing | The specified instance status does not support this operation. | The specified instance cannot be released at this time. Try again later. |
403 | IncorrectInstanceStatus | The specified instance is still attached by volumes. | The specified instance has data volumes. |
403 | InvalidOperation.DeletionProtection | %s | The operation is invalid. Disable release protection for the instance first. |
403 | InvalidOperation.DeletionProtection | The operation is not allowed due to deletion protection. | - |
403 | InvalidOperation.EniLinked | %s | The operation is invalid because the current ENI of the instance is associated with other ENIs. You must disassociate the ENI from the other ENIs before you can unbind the ENI from the instance. |
404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | The specified instance does not exist. |
500 | InternalError | The request processing has failed due to some unknown error. | An internal error has occurred. Try again later. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
2024-02-01 | The Error code has changed. The request parameters of the API has changed | see changesets | ||||||||||||||
| ||||||||||||||||
2023-07-17 | The Error code has changed | see changesets | ||||||||||||||
|