How to Delete a File from Google Cloud Storage Easily

To delete a file from Google Cloud Storage, use the gsutil rm command or the Cloud Storage client libraries' delete() method on the file object. This removes the file permanently from the specified bucket.

Syntax

There are two main ways to delete a file from Google Cloud Storage:

• Command line: Use gsutil rm gs://[BUCKET_NAME]/[FILE_NAME] to delete a file.
• Client library (Python example): Use bucket.blob(file_name).delete() to remove the file programmatically.

Replace [BUCKET_NAME] with your storage bucket name and [FILE_NAME] with the file's path.

bash

gsutil rm gs://my-bucket/my-file.txt

Output

Removing gs://my-bucket/my-file.txt...

Example

This Python example shows how to delete a file named example.txt from a bucket called my-bucket using the Google Cloud Storage client library.

python

from google.cloud import storage

# Initialize client
client = storage.Client()

# Reference the bucket
bucket = client.bucket('my-bucket')

# Reference the file/blob
blob = bucket.blob('example.txt')

# Delete the file
blob.delete()

print('File example.txt deleted from my-bucket.')

Output

File example.txt deleted from my-bucket.

Common Pitfalls

Common mistakes when deleting files include:

• Using the wrong bucket or file name, which causes errors or deletes the wrong file.
• Not having proper permissions; you need storage.objects.delete permission.
• Trying to delete a file that does not exist, which results in a NotFound error.

Always verify the file path and permissions before deleting.

python

from google.cloud import storage

client = storage.Client()
bucket = client.bucket('wrong-bucket')  # Incorrect bucket
blob = bucket.blob('example.txt')

try:
    blob.delete()
except Exception as e:
    print(f'Error: {e}')

# Correct usage
bucket = client.bucket('my-bucket')
blob = bucket.blob('example.txt')
blob.delete()

Output

Error: 404 Not Found

Quick Reference

Summary tips for deleting files from Google Cloud Storage:

• Use gsutil rm for quick command-line deletion.
• Use client libraries for programmatic control and automation.
• Ensure you have the right permissions to delete files.
• Double-check bucket and file names to avoid mistakes.

Key Takeaways

Use gsutil rm or client library delete() to remove files from Cloud Storage.

Always verify bucket and file names before deleting to avoid errors.

Ensure you have storage.objects.delete permission to delete files.

Deleting a non-existent file causes a NotFound error.

Client libraries allow automated and controlled file deletion.