Delete a snapshot by calling the DeleteSnapshot interface.

precautions

Only snapshots with the status "available" or "error" can be deleted. Snapshots with the status "creating" or "rolling back" can not be deleted.

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.

Go to debug

request parameters

Below are only the request parameters specific to this interface and some common parameters. For more information, see common parameters.

Action string required Example value: DeleteSnapshot

The action to be performed: DeleteSnapshot.

Version string required Example value: 2020-04-01

The version of the API is: 2020-04-01.

ClientToken string Optional Example value: 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.

SnapshotId string required Example value: snap-bp1s5fnvk4gn2****

ID of the snapshot to be deleted.

Response parameters

This interface does not have any specific response parameters. For more information, see the response structure.

Request example

Back to example

error code

The following table lists error codes related to the business logic of this API. For common error codes, refer to the common error codes documentation.

Status code	error code	error message	Create Volume
400	IncorrectSnapshotStatus	The specified snapshot status is invalid.	The specified snapshot status is invalid.
400	SnapshotCRRCopying	The specified snapshot is being replicated and cannot be deleted.	The snapshot is being replicated across regions and cannot be deleted.
400	SnapshotExporting	The specified snapshot is being exported and cannot be deleted.	The specified snapshot is being exported and cannot be deleted.
400	SnapshotInCreatingVolume	The specified snapshot is being used to create a volume.	The snapshot is being used to create a volume.
403	SnapshotForbiddenDelete	The specified snapshot cannot be deleted individually under the snapshot consistency group,please delete the snapshot consistency group first.	You are not allowed to delete a snapshot in a consistency group individually. Please delete the entire consistency group first.
403	SnapshotJobQuotaExceed	The number of snapshot task exceeds the limit.	The number of snapshot tasks exceeds the limit.
403	SnapshotBindingImageForbiddenDelete	The snapshot is bound to a mirror and cannot be deleted.	This snapshot is attached to an image and cannot be deleted.
404	SnapshotNotFound	The specified snapshot does not exist.	The specified snapshot does not exist.
500	InternalError	An internal error has occurred.	Internal error. Try again. If multiple attempts fail, submit a ticket.

Elastic Compute Service