You need to enable JavaScript to run this app.
Elastic Compute Service

Elastic Compute Service

Copy page
Download PDF
Volumes
DeleteVolume - Delete volume
Copy page
Download PDF
DeleteVolume - Delete volume
Use the DeleteVolume API to remove a pay-as-you-go data volume.​
Debugging​
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
​
request parameters​
Below are unique request parameters for this API and some common parameters. For more information, see Common Parameters.​
Action string required Example value: DeleteVolume​
Operation to perform, value: DeleteVolume.​
​
Version string required Example value: 2020-04-01​
The version of the API is: 2020-04-01.​
​
ClientToken string Optional Example: 123e4567-e89b-12d3-a456-42665544****​
Used to ensure the idempotency of the request. This string is generated by your client to ensure uniqueness between different requests. ClientToken is a case-sensitive string with no more than 64 ASCII characters.​
​
VolumeId string required Example: vol-3tiefmkskq3vj0x0****​
ID of the volume to be deleted.​
​
​
​
Response Parameters​
This API does not have unique response parameters. For more information, see Response Structure.​
Request example​
​
GET /?Action=DeleteVolume&Version=2020-04-01&VolumeId=vol-3tir92lne23vj0x1**** HTTP/1.1​
Host: open.volcengineapi.com​
Region: cn-beijing​
ServiceName: storage_ebs​
​
Back to example​
​
{​
"ResponseMetadata": {​
"RequestId": "21ec0c83-2c65-4cb5-a6x3-631c4368****",​
"Action": "DeleteVolume",​
"Version": "2020-04-01",​
"Service": "storage_ebs",​
"Region": "cn-beijing"​
},​
"Result": {}​
}​
​
error code​
The table below lists error codes related to this interface and business logic. For common error codes, see the public error codes documentation.​
​
Status code​
error code​
error message​
Create Volume​
400​
MissingVolumeID​
The specified parameter VolumeId is missing.​
Missing volume ID.​
404​
VolumeNotFound​
The specified volume does not exist.​
Volume not found.​
412​
ErrorTradeError​
Trade error message: {{param1}}. Billing request ID: {{param2}}. Error code: {{param3}}.​
Trade error message: {{param1}}. Billing request ID: {{param2}}. Error code: {{param3}}.​
412​
VolumeStatusForbidDelete​
Deletion not allowed for volumes in this state.​
Deletion of volumes in this state is not allowed.​
412​
LocalVolumeCannotDelete​
Local volume cannot be deleted.​
Deletion is not supported for local volumes.​
500​
DeleteVolumeExistsSessions​
Sessions exist for the deleted volume.​
The deleted volume has sessions.​
​
​
Last updated: 2026.01.09 18:19:56