Menghapus bucket

Halaman ini menunjukkan cara menghapus bucket Cloud Storage.

Jika Anda menghapus bucket yang mengaktifkan penghapusan sementara, Anda dapat memulihkan bucket atau objek individual dari bucket selama durasi retensi yang ditentukan dalam kebijakan penghapusan sementara. Folder terkelola tidak dapat dipulihkan, meskipun bucket mengaktifkan penghapusan sementara.

Peringatan: Setelah bucket dihapus, siapa pun dapat menggunakan kembali nama bucket untuk bucket baru dan berpotensi menerima data atau permintaan yang ditujukan untuk bucket asli yang dihapus. Untuk mempelajari cara mengurangi risiko ini, lihat Pertimbangan nama bucket. Perhatikan bahwa bucket yang dihapus sementara tidak dapat dipulihkan jika namanya digunakan kembali.

Sebelum memulai

Untuk mendapatkan izin yang diperlukan untuk menghapus bucket Cloud Storage, minta administrator Anda untuk memberi Anda peran IAM Storage Admin (roles/storage.admin) di bucket.

Peran bawaan ini berisi izin yang diperlukan untuk menghapus bucket. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

• storage.buckets.delete
• storage.buckets.list
  • Izin ini hanya diperlukan saat menghapus bucket menggunakan Google Cloud konsol.
• storage.objects.delete
  • Izin ini hanya diperlukan jika ada objek dalam bucket yang ingin Anda hapus.
• storage.objects.list
  • Izin ini hanya diperlukan untuk menghapus bucket menggunakan Google Cloud konsol atau Google Cloud CLI.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk mengetahui petunjuk tentang cara memberikan peran untuk bucket, lihat Menetapkan dan mengelola kebijakan IAM di bucket.

Menghapus bucket

Konsol

Saat Anda menghapus bucket menggunakan Google Cloud konsol, resource dalam bucket juga akan dihapus, seperti objek, folder terkelola, dan cache yang dibuat dengan Rapid Cache.

1. Di Google Cloud konsol, buka halaman Buckets Cloud Storage.
   

   Buka Buckets

2. Pilih kotak centang bucket yang ingin Anda hapus.

3. Klik Delete.

4. Di jendela overlay yang muncul, konfirmasi bahwa Anda ingin menghapus bucket dan isinya.

5. Klik Delete.

Catatan: Jika Anda memiliki objek dalam jumlah besar di bucket, operasi penghapusan mungkin memerlukan waktu lebih lama dari biasanya untuk diselesaikan.

Untuk mempelajari cara mendapatkan informasi error mendetail tentang operasi Cloud Storage yang gagal di Google Cloud konsol, lihat Pemecahan masalah.

Command line

Untuk menghapus bucket, beserta semua konten di dalamnya, gunakan perintah Google Cloud CLI gcloud storage rm dengan flag --recursive:

gcloud storage rm --recursive gs://BUCKET_NAME

Dengan BUCKET_NAME adalah nama bucket yang akan dihapus. Contohnya, my-bucket.

Jika berhasil, responsnya akan terlihat seperti contoh berikut:

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

Jika ingin menghindari penghapusan objek atau folder terkelola secara tidak sengaja, gunakan perintah gcloud storage buckets delete, yang hanya menghapus bucket jika bucket kosong.

Catatan: Jika Anda perlu menghapus objek dalam jumlah besar di bucket, hindari penggunaan Google Cloud CLI, karena operasi memerlukan waktu lama untuk diselesaikan. Sebagai gantinya, gunakan salah satu opsi berikut:

• Menggunakan Google Cloud konsol.
• Membuat tugas operasi batch penyimpanan.
• Mengonfigurasi Object Lifecycle Management.

Untuk mengetahui informasi selengkapnya tentang cara melindungi data Anda dari penghapusan yang tidak disengaja, lihat Opsi untuk mengontrol siklus proses data.

Library klien

Catatan: Saat Anda menggunakan library klien, bucket harus kosong agar dapat dihapus. Beberapa library klien, seperti library klien Python, menyediakan flag atau fungsi penghapusan paksa.

C++

Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi Cloud Storage C++ API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

namespace gcs = ::google::cloud::storage;
[](gcs::Client client, std::string const& bucket_name) {
  google::cloud::Status status = client.DeleteBucket(bucket_name);
  if (!status.ok()) throw std::runtime_error(status.message());

  std::cout << "The bucket " << bucket_name << " was deleted successfully.\n";
}

C#

Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi Cloud Storage C# API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

using Google.Cloud.Storage.V1;
using System;

public class DeleteBucketSample
{
    public void DeleteBucket(string bucketName = "your-unique-bucket-name")
    {
        var storage = StorageClient.Create();
        storage.DeleteBucket(bucketName);
        Console.WriteLine($"The bucket {bucketName} was deleted.");
    }
}

Go

Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi Cloud Storage Go API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

import (
	"context"
	"fmt"
	"io"
	"time"

	"cloud.google.com/go/storage"
)

// deleteBucket deletes the bucket.
func deleteBucket(w io.Writer, bucketName string) error {
	// bucketName := "bucket-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*30)
	defer cancel()

	bucket := client.Bucket(bucketName)
	if err := bucket.Delete(ctx); err != nil {
		return fmt.Errorf("Bucket(%q).Delete: %w", bucketName, err)
	}
	fmt.Fprintf(w, "Bucket %v deleted\n", bucketName)
	return nil
}

Java

Untuk mengetahui informasi selengkapnya, lihat Cloud Storage Java API dokumentasi referensi.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

import com.google.cloud.storage.Bucket;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageOptions;

public class DeleteBucket {
  public static void deleteBucket(String projectId, String bucketName) {
    // The ID of your GCP project
    // String projectId = "your-project-id";

    // The ID of the bucket to delete
    // String bucketName = "your-unique-bucket-name";

    Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService();
    Bucket bucket = storage.get(bucketName);
    bucket.delete();

    System.out.println("Bucket " + bucket.getName() + " was deleted");
  }
}

Node.js

Untuk mengetahui informasi selengkapnya, lihat Cloud Storage Node.js API dokumentasi referensi.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

/**
 * TODO(developer): Uncomment the following lines before running the sample.
 */
// The ID of your GCS bucket
// const bucketName = 'your-unique-bucket-name';

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

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

async function deleteBucket() {
  await storage.bucket(bucketName).delete();
  console.log(`Bucket ${bucketName} deleted`);
}

deleteBucket().catch(console.error);

PHP

Untuk mengetahui informasi selengkapnya, lihat Cloud Storage PHP API dokumentasi referensi.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

use Google\Cloud\Storage\StorageClient;

/**
 * Delete a Cloud Storage Bucket.
 *
 * @param string $bucketName The name of your Cloud Storage bucket.
 *        (e.g. 'my-bucket')
 */
function delete_bucket(string $bucketName): void
{
    $storage = new StorageClient();
    $bucket = $storage->bucket($bucketName);
    $bucket->delete();
    printf('Bucket deleted: %s' . PHP_EOL, $bucket->name());
}

Python

Untuk mengetahui informasi selengkapnya, lihat Cloud Storage Python API dokumentasi referensi.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

from google.cloud import storage


def delete_bucket(bucket_name):
    """Deletes a bucket. The bucket must be empty."""
    # bucket_name = "your-bucket-name"

    storage_client = storage.Client()

    bucket = storage_client.get_bucket(bucket_name)
    bucket.delete()

    print(f"Bucket {bucket.name} deleted")

Ruby

Untuk mengetahui informasi selengkapnya, lihat Cloud Storage Ruby API dokumentasi referensi.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

def delete_bucket bucket_name:
  # The ID of your GCS bucket
  # bucket_name = "your-unique-bucket-name"

  require "google/cloud/storage"

  storage = Google::Cloud::Storage.new
  bucket  = storage.bucket bucket_name, skip_lookup: true

  bucket.delete

  puts "Deleted bucket: #{bucket.name}"
end

Rust

use google_cloud_storage::client::StorageControl;

pub async fn sample(client: &StorageControl, bucket_id: &str) -> anyhow::Result<()> {
    client
        .delete_bucket()
        .set_name(format!("projects/_/buckets/{bucket_id}"))
        .send()
        .await?;
    println!("successfully deleted bucket {bucket_id}");
    Ok(())
}

REST API

JSON API

Catatan: Saat Anda menggunakan JSON API, bucket harus kosong agar dapat dihapus.

1. Instal dan lakukan inisialisasi gcloud CLI yang terinstal dan terinisialisasi, yang memungkinkan Anda membuat token akses untuk header Authorization.

2. Gunakan cURL untuk memanggil JSON API dengan DELETE Bucket permintaan:

   curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"

   Dengan BUCKET_NAME adalah nama bucket yang akan dihapus. Contohnya, my-bucket.

Jika berhasil, respons akan berisi kode status 204.

XML API

Catatan: Saat Anda menggunakan XML API, bucket harus kosong agar dapat dihapus.

1. Instal dan lakukan inisialisasi gcloud CLI yang terinstal dan terinisialisasi, yang memungkinkan Anda membuat token akses untuk header Authorization.

2. Gunakan cURL untuk memanggil XML API dengan permintaan Bucket DELETE:

   curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://storage.googleapis.com/BUCKET_NAME"

   Dengan BUCKET_NAME adalah nama bucket yang akan dihapus. Contohnya, my-bucket.

Langkah berikutnya

• Membuat bucket.
• Memindahkan atau mengganti nama bucket.
• Membuat daftar objek di bucket.
• Menghapus objek.
• Memulihkan bucket yang dihapus sementara.