删除对象

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

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

如需从一个 Cloud Storage 存储分区中删除对象，请执行以下操作：

控制台

1. 在 Google Cloud Console 中打开 Cloud Storage 浏览器。
   打开 Cloud Storage 浏览器

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

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

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

4. 点击要删除的对象旁边的复选框。

5. 点击删除按钮。

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

注意：您也可以按照这些步骤删除文件夹。删除某一文件夹时，该文件中包含的所有对象也会一同删除。

gsutil

使用 gsutil rm 命令：

gsutil rm gs://[BUCKET_NAME]/[OBJECT_NAME]

其中：

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

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

Operation completed over 1 objects.

注意：您可以使用 ** 通配符删除具有相同前缀的对象组。请注意，如果您在删除命令中使用 -a 标志，则 ** 通配符只会删除对象的非当前版本。

代码示例

C++

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

在 GitHub 上查看 反馈

namespace gcs = google::cloud::storage;
[](gcs::Client client, std::string bucket_name, std::string 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 上查看 反馈

private void DeleteObject(string bucketName, IEnumerable<string> objectNames)
{
    var storage = StorageClient.Create();
    foreach (string objectName in objectNames)
    {
        storage.DeleteObject(bucketName, objectName);
        Console.WriteLine($"Deleted {objectName}.");
    }
}

Go

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

在 GitHub 上查看 反馈

ctx := context.Background()

ctx, cancel := context.WithTimeout(ctx, time.Second*10)
defer cancel()
o := client.Bucket(bucket).Object(object)
if err := o.Delete(ctx); err != nil {
	return err
}

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.
 */
// const bucketName = 'Name of a bucket, e.g. my-bucket';
// const filename = 'File to delete, e.g. file.txt';

// Imports the Google Cloud client library
const {Storage} = require('@google-cloud/storage');

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

async function deleteFile() {
  // Deletes the file from the bucket
  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.
 * @param array $options
 *
 * @return void
 */
function delete_object($bucketName, $objectName, $options = [])
{
    $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("Blob {} deleted.".format(blob_name))

Ruby

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

在 GitHub 上查看 反馈

# bucket_name = "Your Google Cloud Storage bucket name"
# file_name   = "Name of file in Google Cloud Storage to delete"

require "google/cloud/storage"

storage = Google::Cloud::Storage.new
bucket  = storage.bucket bucket_name
file    = bucket.file file_name

file.delete

puts "Deleted #{file.name}"

REST API

JSON API

1. 从 OAuth 2.0 Playground 获取授权访问令牌。将 Playground 配置为使用您自己的 OAuth 凭据。

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。

XML API

1. 从 OAuth 2.0 Playground 获取授权访问令牌。将 Playground 配置为使用您自己的 OAuth 凭据。

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。

后续步骤

• 了解对象版本控制。
• 了解对象生命周期管理。
• 删除存储分区。