Delete objects (original) (raw)

To get the permissions that you need to delete objects, ask your administrator to grant you the Storage Object User (roles/storage.objectUser) IAM role for the bucket that contains the objects you want to delete.

If you plan on using the Google Cloud console to complete the tasks on this page, ask your administrator to grant you the Storage Admin (roles/storage.admin) role instead of the Storage Object User (roles/storage.objectUser) role, or the Viewer (roles/viewer) basic role in addition to the Storage Object User (roles/storage.objectUser) role.

These roles contain the permissions required to delete objects. To see the exact permissions that are required, expand the Required permissionssection:

Complete the following steps to delete objects from one of your Cloud Storage buckets:

Console

1. In the Google Cloud console, go to the Cloud Storage Buckets page.
   Go to Buckets
2. In the list of buckets, click the name of the bucket that contains the objects you want to delete.
   The Bucket details page opens, with the Objects tab selected.
3. Navigate to the objects, which may be located in a folder.
4. Click the checkbox for each object you want to delete.
   You can also click the checkbox for folders, which will delete all objects contained in that folder.
5. Click the Delete button.
6. Click Delete in the dialog that appears.

If you delete many objects at once, you can track deletion progress by clicking the Notifications icon in the Google Cloud console. The Google Cloud console can bulk delete up to several million objects and does so in the background.

To learn how to get detailed error information about failed Cloud Storage operations in the Google Cloud console, seeTroubleshooting.

Command line

Use the Google Cloud CLI command gcloud storage rm:

gcloud storage rm gs://BUCKET_NAME/OBJECT_NAME

Where:

• BUCKET_NAME is the name of the bucket containing the object you want to delete. For example, my-bucket.
• OBJECT_NAME is the name of the object you want to delete. For example, pets/dog.png.

If successful, the response is similar to the following example:

Removing objects: Removing gs://example-bucket/file.txt... Completed 1/1

Client libraries

C++

For more information, see theCloud Storage C++ API reference documentation.

To authenticate to Cloud Storage, set up Application Default Credentials. For more information, seeSet up authentication for client libraries.

C#

For more information, see theCloud Storage C# API reference documentation.

To authenticate to Cloud Storage, set up Application Default Credentials. For more information, seeSet up authentication for client libraries.

Go

For more information, see theCloud Storage Go API reference documentation.

To authenticate to Cloud Storage, set up Application Default Credentials. For more information, seeSet up authentication for client libraries.

Java

For more information, see theCloud Storage Java API reference documentation.

To authenticate to Cloud Storage, set up Application Default Credentials. For more information, seeSet up authentication for client libraries.

Node.js

For more information, see theCloud Storage Node.js API reference documentation.

To authenticate to Cloud Storage, set up Application Default Credentials. For more information, seeSet up authentication for client libraries.

PHP

For more information, see theCloud Storage PHP API reference documentation.

To authenticate to Cloud Storage, set up Application Default Credentials. For more information, seeSet up authentication for client libraries.

Python

For more information, see theCloud Storage Python API reference documentation.

To authenticate to Cloud Storage, set up Application Default Credentials. For more information, seeSet up authentication for client libraries.

Ruby

For more information, see theCloud Storage Ruby API reference documentation.

To authenticate to Cloud Storage, set up Application Default Credentials. For more information, seeSet up authentication for client libraries.

REST APIs

JSON API

1. Have gcloud CLI installed and initialized, which lets you generate an access token for the Authorization header.
2. Use cURL to call the JSON API with a DELETErequest:
   curl -X DELETE \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
   Where:
   • BUCKET_NAME is the name of the bucket containing the object you want to delete. For example,my-bucket.
   • OBJECT_NAME is the URL-encoded name of the object you want to delete. For example, pets/dog.png, URL-encoded as pets%2Fdog.png.

XML API

1. Have gcloud CLI installed and initialized, which lets you generate an access token for the Authorization header.
2. Use cURL to call the XML API with aDELETE Object request:
   curl -X DELETE \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
   Where:
   • BUCKET_NAME is the name of the bucket containing the object you want to delete. For example,my-bucket.
   • OBJECT_NAME is the URL-encoded name of the object you want to delete. For example, pets/dog.png, URL-encoded as pets%2Fdog.png.

If you want to bulk delete a hundred thousand or more objects, avoid usinggcloud storage, as the process takes a long time to complete. Instead, consider one of the following options: