Delete objects  |  Cloud Storage  |  Google Cloud (2024)

Stay organized with collections Save and categorize content based on your preferences.

This page shows you how to delete objects from your buckets inCloud Storage.

Before you begin

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

If you plan on using the Google Cloud console to complete the tasks on thispage, 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 rolein addition to the Storage Object User (roles/storage.objectUser) role.

These roles contain the following permissions, which are required to deleteobjects:

  • storage.objects.delete

  • storage.objects.list

    • This permission is only needed when using the Google Cloud console orgsutil to perform the instructions on this page, or when using the--recursive flag or wildcards in Google Cloud CLI.
  • storage.buckets.list

    • This permission is only needed when using the Google Cloud console toperform the instructions on this page.

You can also get these permissions with otherpredefined roles or custom roles.

For information about granting roles for buckets, seeUse IAM with buckets.

Delete an object

Complete the following steps to delete objects from one of yourCloud 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 on the name of the bucket that containsthe 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 allobjects 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 byclicking the Notifications icon in the Google Cloud console. TheGoogle Cloud console can bulk delete up to several million objectsand does so in the background.

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

Command line

gcloud

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 containingthe object you want to delete. For example, my-bucket.
  • OBJECT_NAME is the name of the object you wantto 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

gsutil

Use the gsutil rm command:

gsutil rm gs://BUCKET_NAME/OBJECT_NAME

Where:

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

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

Operation completed over 1 objects.

Client libraries

C++

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

To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see Set up authentication for a local development environment.

View on GitHub Feedback

namespace gcs = ::google::cloud::storage;[](gcs::Client client, std::string const& bucket_name, std::string const& object_name) { google::cloud::Status status = client.DeleteObject(bucket_name, object_name); if (!status.ok()) throw std::runtime_error(status.message()); std::cout << "Deleted " << object_name << " in bucket " << bucket_name << "\n";}

C#

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

To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see Set up authentication for a local development environment.

View on GitHub Feedback

using Google.Cloud.Storage.V1;using System;public class DeleteFileSample{ public void DeleteFile( string bucketName = "your-unique-bucket-name", string objectName = "your-object-name") { var storage = StorageClient.Create(); storage.DeleteObject(bucketName, objectName); Console.WriteLine($"Deleted {objectName}."); }}

Go

For more information, see the Cloud Storage Go API reference documentation.

To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see Set up authentication for a local development environment.

View on GitHub Feedback

import ("context""fmt""io""time""cloud.google.com/go/storage")// deleteFile removes specified object.func deleteFile(w io.Writer, bucket, object string) error {// bucket := "bucket-name"// object := "object-name"ctx := context.Background()client, err := storage.NewClient(ctx)if err != nil {return fmt.Errorf("storage.NewClient: %w", err)}defer client.Close()ctx, cancel := context.WithTimeout(ctx, time.Second*10)defer cancel()o := client.Bucket(bucket).Object(object)// Optional: set a generation-match precondition to avoid potential race// conditions and data corruptions. The request to delete the file is aborted// if the object's generation number does not match your precondition.attrs, err := o.Attrs(ctx)if err != nil {return fmt.Errorf("object.Attrs: %w", err)}o = o.If(storage.Conditions{GenerationMatch: attrs.Generation})if err := o.Delete(ctx); err != nil {return fmt.Errorf("Object(%q).Delete: %w", object, err)}fmt.Fprintf(w, "Blob %v deleted.\n", object)return nil}

Java

For more information, see the Cloud Storage Java API reference documentation.

To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see Set up authentication for a local development environment.

View on GitHub Feedback

import com.google.cloud.storage.Blob;import com.google.cloud.storage.Storage;import com.google.cloud.storage.StorageOptions;public class DeleteObject { public static void deleteObject(String projectId, String bucketName, String objectName) { // The ID of your GCP project // String projectId = "your-project-id"; // The ID of your GCS bucket // String bucketName = "your-unique-bucket-name"; // The ID of your GCS object // String objectName = "your-object-name"; Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService(); Blob blob = storage.get(bucketName, objectName); if (blob == null) { System.out.println("The object " + objectName + " wasn't found in " + bucketName); return; } // Optional: set a generation-match precondition to avoid potential race // conditions and data corruptions. The request to upload returns a 412 error if // the object's generation number does not match your precondition. Storage.BlobSourceOption precondition = Storage.BlobSourceOption.generationMatch(blob.getGeneration()); storage.delete(bucketName, objectName, precondition); System.out.println("Object " + objectName + " was deleted from " + bucketName); }}

Node.js

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

To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see Set up authentication for a local development environment.

View on GitHub Feedback

/** * TODO(developer): Uncomment the following lines before running the sample. */// The ID of your GCS bucket// const bucketName = 'your-unique-bucket-name';// The ID of your GCS file// const fileName = 'your-file-name';// Imports the Google Cloud client libraryconst {Storage} = require('@google-cloud/storage');// Creates a clientconst storage = new Storage();// Optional:// Set a generation-match precondition to avoid potential race conditions// and data corruptions. The request to delete is aborted if the object's// generation number does not match your precondition. For a destination// object that does not yet exist, set the ifGenerationMatch precondition to 0// If the destination object already exists in your bucket, set instead a// generation-match precondition using its generation number.const deleteOptions = { ifGenerationMatch: generationMatchPrecondition,};async function deleteFile() { await storage.bucket(bucketName).file(fileName).delete(deleteOptions); console.log(`gs://${bucketName}/${fileName} deleted`);}deleteFile().catch(console.error);

PHP

For more information, see the Cloud Storage PHP API reference documentation.

To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see Set up authentication for a local development environment.

View on GitHub Feedback

use Google\Cloud\Storage\StorageClient;/** * Delete an object. * * @param string $bucketName The name of your Cloud Storage bucket. * (e.g. 'my-bucket') * @param string $objectName The name of your Cloud Storage object. * (e.g. 'my-object') */function delete_object(string $bucketName, string $objectName): void{ $storage = new StorageClient(); $bucket = $storage->bucket($bucketName); $object = $bucket->object($objectName); $object->delete(); printf('Deleted gs://%s/%s' . PHP_EOL, $bucketName, $objectName);}

Python

For more information, see the Cloud Storage Python API reference documentation.

To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see Set up authentication for a local development environment.

View on GitHub Feedback

from google.cloud import storagedef delete_blob(bucket_name, blob_name): """Deletes a blob from the bucket.""" # bucket_name = "your-bucket-name" # blob_name = "your-object-name" storage_client = storage.Client() bucket = storage_client.bucket(bucket_name) blob = bucket.blob(blob_name) generation_match_precondition = None # Optional: set a generation-match precondition to avoid potential race conditions # and data corruptions. The request to delete is aborted if the object's # generation number does not match your precondition. blob.reload() # Fetch blob metadata to use in generation_match_precondition. generation_match_precondition = blob.generation blob.delete(if_generation_match=generation_match_precondition) print(f"Blob {blob_name} deleted.")

Ruby

For more information, see the Cloud Storage Ruby API reference documentation.

To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see Set up authentication for a local development environment.

View on GitHub Feedback

def delete_file bucket_name:, file_name: # The ID of your GCS bucket # bucket_name = "your-unique-bucket-name" # The ID of your GCS object # file_name = "your-file-name" require "google/cloud/storage" storage = Google::Cloud::Storage.new bucket = storage.bucket bucket_name, skip_lookup: true file = bucket.file file_name file.delete puts "Deleted #{file.name}"end

REST APIs

JSON API

  1. Get an authorization access token from theOAuth 2.0 Playground.Configure the playground to use your own OAuth credentials. For instructions, seeAPI authentication.
  2. Use cURL to call the JSON API with a DELETErequest:

    curl -X DELETE \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"

    Where:

    • OAUTH2_TOKEN is the name of the accesstoken you generated in Step 1.
    • BUCKET_NAME is the name of the bucketcontaining the object you want to delete. For example,my-bucket.
    • OBJECT_NAME is the URL-encoded name ofthe object you want to delete. For example, pets/dog.png,URL-encoded as pets%2Fdog.png.

XML API

  1. Get an authorization access token from theOAuth 2.0 Playground.Configure the playground to use your own OAuth credentials. For instructions, seeAPI authentication.
  2. Use cURL to call the XML API with aDELETE Object request:

    curl -X DELETE \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"

    Where:

    • OAUTH2_TOKEN is the name of the accesstoken you generated in Step 1.
    • BUCKET_NAME is the name of the bucketcontaining the object you want to delete. For example,my-bucket.
    • OBJECT_NAME is the URL-encoded name ofthe object you want to delete. For example, pets/dog.png,URL-encoded as pets%2Fdog.png.

Delete objects in bulk

  • If you want to bulk delete a hundred thousand or more objects, avoid usinggcloud storage or gsutil, as the process takes a long time to complete.Instead, use the Google Cloud console, which can delete up to several millionobjects, or Object Lifecycle Management, which can delete any number ofobjects.

    • To bulk delete objects in your bucket using Object Lifecycle Management,set a lifecycle configuration rule on your bucket where thecondition has Age set to 0 days and the action is set to delete.
  • When using certain client libraries or when using the JSON API directly, youcan batch your deletion requests to reduce the number of HTTPconnections you need to make.

What's next

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2023-12-19 UTC.

As an expert in cloud storage solutions, I can provide a comprehensive overview of the concepts covered in the article.

Overview: Cloud Storage is a service that allows you to store and retrieve data on Google Cloud Platform. It provides scalable, secure, and highly available storage infrastructure for your applications.

Solutions: The article covers various solutions related to Cloud Storage, including:

  • Object Deletion: Explains how to delete objects from Cloud Storage buckets using the Google Cloud Console, gcloud command-line tool, and client libraries.

  • Permission Management: Describes the required IAM roles (Storage Object User, Storage Admin, and Viewer) for deleting objects and managing permissions.

  • Bulk Deletion: Recommends using the Google Cloud console or Object Lifecycle Management for bulk deletion of objects.

Products: The primary product discussed is Google Cloud Storage, which offers different storage classes, including multi-regional, dual-regional, and regional storage.

Pricing: Details on pricing for Google Cloud Storage are not explicitly mentioned in this snippet. However, pricing typically involves factors like storage class, data transfer, and operations.

Resources: The article provides resources such as guides, reference documentation, samples, and support information for users to effectively utilize Cloud Storage.

Docs: Documentation is available for various tasks, including managing buckets, uploading and downloading objects, configuring access control, enabling features like versioning and object holds, and ensuring data encryption.

Support: Information about troubleshooting, managing access, monitoring data, and implementing protection, backup, and recovery mechanisms is included.

Concepts in the Code Samples: The code samples demonstrate how to delete objects using various programming languages and Google Cloud client libraries, such as C++, C#, Go, Java, Node.js, PHP, Python, and Ruby.

REST APIs: The article covers how to delete objects using JSON and XML APIs, involving steps like obtaining authorization access tokens and using cURL commands.

Bulk Deletion Techniques: It advises against using gcloud storage or gsutil for bulk deletion and recommends using the Google Cloud console or Object Lifecycle Management. Batch deletion requests are also mentioned.

Next Steps: The article concludes by suggesting further learning about Object Versioning, Object Lifecycle Management, and how to delete a bucket.

In summary, this article serves as a comprehensive guide for users of Google Cloud Storage, covering a range of topics from basic operations to advanced features and best practices.

Delete objects  |  Cloud Storage  |  Google Cloud (2024)

FAQs

How do I delete objects from Google cloud storage? ›

Delete an object
  1. In the Google Cloud console, go to the Cloud Storage Buckets page. ...
  2. In the list of buckets, click the name of the bucket that contains the objects you want to delete. ...
  3. Navigate to the objects, which may be located in a folder.
  4. Click the checkbox for each object you want to delete. ...
  5. Click the Delete button.

How do I delete all files from Google cloud storage? ›

Clean up storage through Google One
  1. On your Android device, open the Google One app .
  2. At the bottom, tap Storage. Free up account storage.
  3. Select the category you want to manage.
  4. Select the files you want to remove. To sort files, at the top, tap Filter . ...
  5. After you select your files, at the top, tap Delete .

Is Google cloud storage an object storage? ›

Cloud Storage is a service for storing objects in Google Cloud. An object is an immutable piece of data consisting of a file of any format. You store objects in containers called buckets. All buckets are associated with a project, and you can group your projects under an organization.

What is Google Cloud Storage object? ›

Object storage is a data storage architecture for storing unstructured data, which sections data into units—objects—and stores them in a structurally flat data environment. Each object includes the data, metadata, and a unique identifier that applications can use for easy access and retrieval.

How do I delete all photos from Google cloud storage? ›

On a mobile browser, long press the first photo and keeping the screen pressed stroke down to select a batch then move to trash. Medium size batches are best rather than trying to select all at once. On a computer, point at the item(s) you want to delete. At the top left, click Select .

Can you permanently delete files stored in the cloud? ›

Delete files permanently from Creative Cloud

Sign in to the Creative Cloud website. In the side navigation, select Deleted. Left sidebar view of the Creative Cloud interface showing the Deleted option. Select the files or folders that you want to permanently remove from the cloud, and then select Permanently delete.

Can you delete all data from Google? ›

Google Chrome

Open Chrome on your Android device, tap the three dots in the top right, and select History. Tap clear browsing data and make sure Browsing history is checked. Then, select your desired time range (tap All time to delete all data), and tap Clear data.

Why is Google storage still full after deleting? ›

Resolution. Once you have deleted your data from Google, they will be sent to your Trash. Data in Trash will be automatically deleted after 30 days. However, data in Trash still count against your storage limit, so you should empty your Trash after deleting it.

What is the difference between Google storage and Cloud Storage? ›

The way they work and how users access them is different. Google Cloud Storage is an object-based data store, while Google Drive Enterprise is a file-based data store. This distinction can be important based on usage needs.

What is the difference between file storage and object storage? ›

When comparing file storage vs object storage, for instance, there is no hierarchy of folders or directories. Instead, objects are stored in a flat data environment, or storage pool. Objects can be stored on-premises, but are more typically stored in the cloud, so organizations and teams can access data from anywhere.

What is an example of object storage? ›

Object storage use cases

For example, it can assist you in the following ways: Deliver rich media. Define workflows by leveraging industry-leading solutions for managing unstructured data. Reduce your costs for globally distributed rich media.

How much cloud storage is free on Google? ›

Each Google Account includes 15 GB of storage, which is shared across Gmail, Google Drive, and Google Photos. To add to your storage quota, you can purchase a Google One membership, where available. Occasionally, you may receive more storage from a special promotion or related purchase.

Does Google have unlimited cloud storage? ›

Every Google Account comes with 15 GB of storage for Google Drive, Gmail, and Google Photos. When you subscribe to Google One, your total storage increases to 100 GB or more depending on the plan you choose.

What is the minimum storage duration for Google cloud? ›

Google Cloud Nearline Storage

It can also store backups and archival data. Nearline Storage costs less than Standard Storage but comes with a minimum storage duration of 30 days. There is also a retrieval fee to access Nearline Storage data.

How do I manage storage on Google cloud? ›

To know how much space you have left on a computer, go to google.com/settings/storage.
  1. If you use Google Drive for work or school, you can check if your administrator set an individual storage limit.
  2. If you're close to or over your limit, you can: Permanently delete files to clear space. Get more storage:

How do I delete a dataset in Google cloud? ›

The following example deletes a dataset named mydataset :
  1. In the Google Cloud console, go to the BigQuery page. Go to BigQuery.
  2. In the query editor, enter the following statement: DROP SCHEMA IF EXISTS mydataset; By default, this only works to delete an empty dataset. ...
  3. Click play_circle Run.

Top Articles
Latest Posts
Article information

Author: The Hon. Margery Christiansen

Last Updated:

Views: 6118

Rating: 5 / 5 (50 voted)

Reviews: 81% of readers found this page helpful

Author information

Name: The Hon. Margery Christiansen

Birthday: 2000-07-07

Address: 5050 Breitenberg Knoll, New Robert, MI 45409

Phone: +2556892639372

Job: Investor Mining Engineer

Hobby: Sketching, Cosplaying, Glassblowing, Genealogy, Crocheting, Archery, Skateboarding

Introduction: My name is The Hon. Margery Christiansen, I am a bright, adorable, precious, inexpensive, gorgeous, comfortable, happy person who loves writing and wants to share my knowledge and understanding with you.