Menghapus bucket

Halaman ini menunjukkan cara menghapus bucket Cloud Storage.

Peringatan: Menghapus bucket juga akan menghapus folder terkelola dalam bucket, yang tidak dapat dipulihkan. Jika bucket mengaktifkan penghapusan sementara, Anda dapat memulihkan bucket atau objek individual dari bucket selama durasi retensi yang ditentukan dalam kebijakan penghapusan sementara. Setelah bucket dihapus secara sementara, siapa pun dapat menggunakan nama bucket untuk bucket baru. Jika orang lain menggunakan nama tersebut, Anda tidak akan dapat memulihkan bucket karena namanya tidak lagi tersedia untuk digunakan.

Sebelum memulai

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

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 konsol Google Cloud.
• storage.objects.delete
  • Izin ini hanya diperlukan jika objek ada dalam bucket yang ingin Anda hapus.
• storage.objects.list
  • Izin ini hanya diperlukan untuk menghapus bucket menggunakan konsol Google Cloud atau Google Cloud CLI.

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

Untuk mengetahui petunjuk cara memberikan peran untuk bucket, lihat Menggunakan IAM dengan bucket.

Menghapus bucket

Konsol

1. Di Konsol Google Cloud, buka halaman Bucket 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 Konsol Google Cloud, lihat Pemecahan masalah.

Command line

Untuk menghapus bucket, beserta semua konten dalam bucket, 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. Contoh, my-bucket.

Jika berhasil, responsnya akan terlihat seperti contoh berikut:

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

Jika Anda 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 harus menghapus objek dalam jumlah besar di bucket, hindari penggunaan Google Cloud CLI, karena operasi memerlukan waktu lama untuk diselesaikan. Sebagai gantinya, gunakan Konsol Google Cloud atau fitur Object Lifecycle Management. Untuk mengetahui informasi selengkapnya, lihat Opsi untuk mengontrol siklus proses data.

Library klien

Catatan: Saat menggunakan library klien, bucket harus kosong sebelum Anda dapat menghapusnya. Beberapa library klien, seperti library klien Python, menyediakan tanda atau fungsi penghapusan paksa.

C++

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

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk 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, lihatDokumentasi referensi Cloud Storage C# API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk 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, lihatDokumentasi referensi Cloud Storage Go API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk 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, lihatDokumentasi referensi Cloud Storage Java API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk 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, lihatDokumentasi referensi Cloud Storage Node.js API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk 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, lihatDokumentasi referensi Cloud Storage PHP API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk 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, lihatDokumentasi referensi Cloud Storage Python API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk 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, lihatDokumentasi referensi Cloud Storage Ruby API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk 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

REST API

JSON API

Catatan: Saat menggunakan JSON API, bucket Anda harus kosong sebelum Anda dapat menghapusnya.

1. Menginstal dan melakukan inisialisasi gcloud CLI , yang memungkinkan Anda membuat token akses untuk header Authorization.

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

   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. Contoh, my-bucket.

Jika berhasil, respons akan berisi kode status 204.

XML API

Catatan: Saat menggunakan XML API, bucket Anda harus kosong sebelum Anda dapat menghapusnya.

1. Menginstal dan melakukan inisialisasi gcloud CLI , 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. Contoh, my-bucket.

Langkah berikutnya

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