Delete instance
Describe
Frees the instance resource based on the name of the incoming instance. The physical resources used by the instance after the release are reclaimed, including disks and snapshots, and all related data is lost and permanently unrecoverable.
The instance state must be Stopped for the delete operation to take place. After deletion, the status of the instance is Deleted, indicating that the resource has been disposed and the deletion is complete.
When an instance is deleted, the disk that is mounted on the instance with the Deletewithinstance property of True is deleted, and the snapshots of those disks are retained as old, and the automatic snapshot retains the automatic snapshot based on the Deleteautosnapshot property of the disk and, if False, If true, the automatic snapshot is deleted.
When an instance is deleted, all related data is lost and permanently unrecoverable.
When an instance is deleted, the instance is safely controlled when the lock state of "Lockreason" is marked in the instance's operationlocks, even if the Deletewithinstnace property of the independent ordinary cloud disk is False. The system ignores this property and releases the normal cloud disk that is mounted on the instance.
Request parameters
name |
type |
whether you must |
Description |
Action |
String |
Is |
System specified parameters, values: deleteinstance |
Instanceid |
String |
Is |
Instance ID |
return parameters
All public return parameters, as detailed in the public return parameters
Error code
error code |
Description |
Http status code |
semantics |
missingparameter |
the input parameter "Instanceid" that are mandatory for proces Sing this request isn't supplied. |
400 |
missing Instanceid value |
incorrectinstancestatus |
the current status of the resource does not support this operation. |
403 |
This is not supported by the current state of the resource |
chargetypeviolation |
the operation is not permitted due to charge type of the instance. |
403 |
|
internalerror |
the request processing has failed due to some error. |
500 |
internal error |
dependencyviolation.slbconfiguring |
specified operation is denied as the Insta NCE is being used by another product. |
400 |
instance is SLB referenced, and SLB is configuring |
Example
Request sample
Https://ecs.aliyuncs.com/?Action=DeleteInstance
&instanceid=i-instance1
&< Public Request Parameters >
Return sample
XML format
928e2273-5715-46b9-a730-238dc996a533
JSON format
{
"RequestID": "928e2273-5715-46b9-a730-238dc996a533"
}