Skip to main content

Delete an Object

You can delete one or more objects directly from QStorage. This section explains how to delete objects from a QStorage bucket.

Deleting a Single Object​

# Delete a single object
qcli s3api rm s3://bucket-name/file.txt

# Delete an object with a specific version ID (if versioning is enabled)
qcli s3api rm s3://bucket-name/file.txt --version-id version-id

Deleting Multiple Objects​

You can delete multiple objects in a single request, which is useful for efficiently deleting a large number of objects.

# Delete all objects with a specific prefix
qcli s3api rm s3://bucket-name/prefix/ --recursive

# Delete all objects in a bucket
qcli s3api rm s3://bucket-name/ --recursive

Deleting Objects in a Versioned Bucket​

If you have enabled versioning on your bucket, deleting an object doesn't permanently remove it. Instead, QStorage adds a delete marker, which becomes the current version of the object. To permanently delete a versioned object, you must delete all versions of the object.

# Delete a specific version of an object
qcli s3api rm s3://bucket-name/file.txt --version-id version-id

# Delete all versions of all objects in a bucket
qcli s3api rm s3://bucket-name/ --recursive --versions

Success​

The response you should see upon Object deletion is a list of files deleted:

delete: s3://qstorage-demo-bucket/file.txt

Considerations When Deleting Objects​

  1. Permissions: Ensure you have the necessary permissions to delete objects.

  2. Versioning: If versioning is enabled, understand the implications of deleting objects.

  3. Deletion Costs: There are no additional costs for deleting objects in QStorage.

  4. Irreversible Operation: Deleting objects is generally irreversible, especially if versioning is not enabled.

  5. Multipart Uploads: If you have incomplete multipart uploads, you should abort them to avoid storage charges.