Hapus bucket?

Halaman ini menunjukkan cara menghapus bucket Cloud Storage.

Peringatan: Menghapus bucket juga akan menghapus folder terkelola di dalam bucket, yang tidak dapat dipulihkan, dan objek di dalam bucket, yang hanya dapat dipulihkan jika bucket mengaktifkan penghapusan untuk sementara dan hanya dalam durasi retensi penghapusan sementara bucket. Namun, setelah bucket dihapus, siapa pun dapat menggunakan nama bucket ini untuk bucket baru. Jika nama ini digunakan oleh orang lain, Anda tidak akan dapat memulihkan bucket karena namanya tidak lagi dapat digunakan.

Sebelum memulai

Guna 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 yang telah ditentukan 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 di 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 lainnya atau peran standar.

Untuk mengetahui petunjuk mengenai cara memberikan peran untuk bucket, baca artikel 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 objek di 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 bucket berisi folder terkelola, Anda dapat menghapus bucket beserta semua folder dan objek terkelola di dalamnya menggunakan perintah Google Cloud CLI gcloud alpha storage rm dengan flag --recursive:

  gcloud alpha 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, jangan gunakan flag --recursive dalam perintah. Jika Anda mengecualikan flag ini, perintah tersebut hanya akan menghapus bucket jika bucket kosong.

Catatan: Jika Anda harus menghapus objek dalam jumlah besar di bucket, hindari menggunakan gcloud, karena operasi ini 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 Anda menggunakan library klien, bucket harus kosong sebelum Anda dapat menghapusnya. Beberapa library klien, seperti library klien Python, menyediakan fungsi atau flag hapus paksa.

C++

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

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

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 mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

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 mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

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 mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

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 mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

/**
 * 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 mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

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 mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

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 mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

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 Anda menggunakan JSON API, bucket harus kosong sebelum Anda dapat menghapusnya.

1. Telah menginstal dan melakukan inisialisasigcloud CLI, agar dapat membuat token akses untuk header Authorization.

   Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di 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 Anda menggunakan XML API, bucket harus kosong sebelum dapat menghapusnya.

1. Telah menginstal dan melakukan inisialisasigcloud CLI, agar dapat membuat token akses untuk header Authorization.

   Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di 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 selanjutnya

• Membuat bucket.
• Memindahkan atau mengganti nama bucket.
• Menghapus objek.