删除对象

本页面介绍了如何从 Cloud Storage 存储分区中删除对象。 如需简要了解对象，请参阅关键术语。

警告：对象删除操作无法撤消。Cloud Storage 旨在为开发者提供极高的灵活性和数据掌控能力，而 Google 会严格控制对于已删除数据的处理和清除。为了防止错误，请参阅控制数据生命周期的选项。

前提条件

前提条件因所使用的工具而异：

控制台

如需使用 Google Cloud Console 完成本指南，您必须拥有适当的 IAM 权限。如果您要删除的对象在不是由您创建的项目中，则可能需要项目所有者为您提供包含必要权限的角色。

如需查看特定操作所需权限的列表，请参阅 Google Cloud Console 的 IAM 权限。

如需查看相关角色的列表，请参阅 Cloud Storage 角色。或者，您也可以创建一个自定义角色，并为其提供具体受限的权限。

命令行

为使用命令行实用程序完成本指南，您必须拥有适当的 IAM 权限。如果您要删除的对象在不是由您创建的项目中，则可能需要项目所有者为您提供包含必要权限的角色。

如需查看特定操作所需权限的列表，请参阅 gsutil 命令的 IAM 权限。

如需查看相关角色的列表，请参阅 Cloud Storage 角色。或者，您也可以创建一个自定义角色，并为其提供具体受限的权限。

代码示例

如需使用 Cloud Storage 客户端库完成本指南，您必须拥有适当的 IAM 权限。如果您要删除的对象在不是由您创建的项目中，则可能需要项目所有者为您提供包含必要权限的角色。除非另有说明，否则客户端库请求通过 JSON API 发出。

如需查看特定操作所需的权限列表，请参阅 JSON 方法的 IAM 权限。

如需查看相关角色的列表，请参阅 Cloud Storage 角色。或者，您也可以创建一个自定义角色，并为其提供具体受限的权限。

REST API

JSON API

如需使用 JSON API 完成本指南，您必须拥有适当的 IAM 权限。如果您要删除的对象在不是由您创建的项目中，则可能需要项目所有者为您提供包含必要权限的角色。

如需查看特定操作所需的权限列表，请参阅 JSON 方法的 IAM 权限。

如需查看相关角色的列表，请参阅 Cloud Storage 角色。或者，您也可以创建一个自定义角色，并为其提供具体受限的权限。

删除对象

注意：如果数据最初存储为 Nearline Storage、Coldline Storage 或 Archive Storage，则删除数据可能会产生检索和提前删除费用。另请注意，如果您为存储桶启用了对象版本控制，则原始对象将保留在存储桶中，直到使用其世代编号明确删除。

完成以下步骤，从一个 Cloud Storage 存储桶中删除对象：

控制台

1. 在 Google Cloud Console 中，转到 Cloud Storage 的浏览器页面。
   

   转到浏览器

2. 在存储桶列表中，点击包含待删除对象的存储桶的名称。

   此时会打开“存储分区详情”页面，其中“对象”标签页已选中。

3. 导航到可能位于文件夹中的对象。

4. 点击要删除的每个对象对应的复选框。

   您还可以点击文件夹对应的复选框，这将删除该文件夹中包含的所有对象。

5. 点击删除按钮。

6. 在出现的对话框中点击删除。

如果您一次删除许多对象，可以点击 Cloud Console 中的通知图标来跟踪删除进度。Cloud Console 可以在后台批量删除高达几百万个对象。

如需了解如何获取有关 Cloud Storage 浏览器中失败操作的详细错误信息，请参阅问题排查。

命令行

gcloud

预览

此产品或功能受《Google Cloud 服务条款》的正式发布预备产品条款的约束。正式发布前的产品和功能可能受到有限的支持，正式发布前产品和功能的更改可能与其他正式发布之前的版本不兼容。 如需了解详情，请参阅发布阶段说明。

使用 Google Cloud CLI 命令 gcloud alpha storage rm：

gcloud alpha storage rm gs://BUCKET_NAME/OBJECT_NAME

其中：

• BUCKET_NAME 是包含待删除对象的存储分区的名称，例如 my-bucket。
• OBJECT_NAME 是待删除对象的名称，例如 pets/dog.png。

如果成功，则响应类似如下示例：

Operation completed over 1 objects.

注意：通过使用--recursive 标志 您可以删除具有相同前缀的对象组，例如名称模拟文件夹结构的对象。例如：gcloud alpha storage rm --recursive gs://my-bucket/dir/

gsutil

使用 gsutil rm 命令：

gsutil rm gs://BUCKET_NAME/OBJECT_NAME

其中：

• BUCKET_NAME 是包含待删除对象的存储分区的名称，例如 my-bucket。
• OBJECT_NAME 是待删除对象的名称，例如 pets/dog.png。

如果成功，则响应类似如下示例：

Operation completed over 1 objects.

注意：通过使用-r 标志 您可以删除具有相同前缀的对象组，例如名称模拟文件夹结构的对象。例如：gsutil rm -r gs://my-bucket/dir/

代码示例

C++

如需了解详情，请参阅 Cloud Storage C++ API 参考文档。

在 GitHub 上查看 反馈

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#

如需了解详情，请参阅 Cloud Storage C# API 参考文档。

在 GitHub 上查看 反馈

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

如需了解详情，请参阅 Cloud Storage Go API 参考文档。

在 GitHub 上查看 反馈

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: %v", 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 upload 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: %v", err)
	}
	o = o.If(storage.Conditions{GenerationMatch: attrs.Generation})

	if err := o.Delete(ctx); err != nil {
		return fmt.Errorf("Object(%q).Delete: %v", object, err)
	}
	fmt.Fprintf(w, "Blob %v deleted.\n", object)
	return nil
}

Java

如需了解详情，请参阅 Cloud Storage Java API 参考文档。

在 GitHub 上查看 反馈

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();
    storage.delete(bucketName, objectName);

    System.out.println("Object " + objectName + " was deleted from " + bucketName);
  }
}

Node.js

如需了解详情，请参阅 Cloud Storage Node.js API 参考文档。

在 GitHub 上查看 反馈

/**
 * 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 library
const {Storage} = require('@google-cloud/storage');

// Creates a client
const storage = new Storage();

async function deleteFile() {
  await storage.bucket(bucketName).file(fileName).delete();

  console.log(`gs://${bucketName}/${fileName} deleted`);
}

deleteFile().catch(console.error);

PHP

如需了解详情，请参阅 Cloud Storage PHP API 参考文档。

在 GitHub 上查看 反馈

use Google\Cloud\Storage\StorageClient;

/**
 * Delete an object.
 *
 * @param string $bucketName The name of your Cloud Storage bucket.
 * @param string $objectName The name of your Cloud Storage object.
 */
function delete_object($bucketName, $objectName)
{
    // $bucketName = 'my-bucket';
    // $objectName = 'my-object';

    $storage = new StorageClient();
    $bucket = $storage->bucket($bucketName);
    $object = $bucket->object($objectName);
    $object->delete();
    printf('Deleted gs://%s/%s' . PHP_EOL, $bucketName, $objectName);
}

Python

如需了解详情，请参阅 Cloud Storage Python API 参考文档。

在 GitHub 上查看 反馈

from google.cloud import storage

def 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)
    blob.delete()

    print(f"Blob {blob_name} deleted.")

Ruby

如需了解详情，请参阅 Cloud Storage Ruby API 参考文档。

在 GitHub 上查看 反馈

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 API

JSON API

注意：发送到 JSON API 的每个删除请求只能包含一个要删除的对象。

1. 从 OAuth 2.0 Playground 获取授权访问令牌。将 Playground 配置为使用您自己的 OAuth 凭据。 如需了解相关说明，请参阅 API 身份验证。

2. 使用 cURL，通过 DELETE 请求调用 JSON API：

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

   其中：

   • OAUTH2_TOKEN 是您在第 1 步中生成的访问令牌的名称。
   • BUCKET_NAME 是包含待删除对象的存储分区的名称，例如 my-bucket。
   • OBJECT_NAME 是要删除的对象的网址编码名称。例如，pets/dog.png 的网址编码为 pets%2Fdog.png。

XML API

注意：发送到 XML API 的每个删除请求只能包含一个删除对象。

1. 从 OAuth 2.0 Playground 获取授权访问令牌。将 Playground 配置为使用您自己的 OAuth 凭据。 如需了解相关说明，请参阅 API 身份验证。

2. 使用 cURL，通过 DELETE Object 请求调用 XML API：

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

   其中：

   • OAUTH2_TOKEN 是您在第 1 步中生成的访问令牌的名称。
   • BUCKET_NAME 是包含待删除对象的存储分区的名称，例如 my-bucket。
   • OBJECT_NAME 是要删除的对象的网址编码名称。例如，pets/dog.png 的网址编码为 pets%2Fdog.png。

批量删除对象

如果您要批量删除十万个或更多对象，切勿使用 gsutil，因为此过程需要很长时间才能完成。请改用 Google Cloud Console（可删除高达几百万个对象）或对象生命周期管理（可删除任意数量的对象）。

如需使用对象生命周期管理批量删除存储桶中的对象，请针对存储桶设置生命周期配置规则，其中条件为 Age 设置为 0 天，操作设置为 delete。

后续步骤

• 了解对象版本控制功能。
• 了解对象生命周期管理功能。
• 了解如何删除存储桶。