버킷 삭제

이 페이지는 Cloud Storage 버킷을 삭제하는 방법을 설명합니다.

경고: 버킷을 삭제하면 복구할 수 없는 버킷 내의 관리형 폴더도 삭제됩니다. 버킷에 소프트 삭제가 사용 설정된 경우 소프트 삭제 정책에 지정된 보관 기간 동안 버킷 또는 버킷의 개별 객체를 복원할 수 있습니다. 버킷이 조용히 삭제되면 누구나 새 버킷에 버킷 이름을 사용할 수 있습니다. 다른 사람이 이름을 사용하면 더 이상 이름을 사용할 수 없으므로 버킷을 복원할 수 없습니다.

시작하기 전에

Cloud Storage 버킷을 삭제하는 데 필요한 권한을 얻으려면 관리자에게 버킷에 대한 스토리지 관리자(roles/storage.admin) IAM 역할을 부여해 달라고 요청하세요.

이 사전 정의된 역할에는 버킷을 삭제하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 확장하세요.

필수 권한

• storage.buckets.delete
• storage.buckets.list
  • 이 권한은 Google Cloud 콘솔을 사용하여 버킷을 삭제할 때만 필요합니다.
• storage.objects.delete
  • 이 권한은 객체가 삭제하려는 버킷 내에 있는 경우에만 필요합니다.
• storage.objects.list
  • 이 권한은 Google Cloud 콘솔이나 Google Cloud CLI를 사용하여 버킷을 삭제하는 경우에만 필요합니다.

다른 커스텀 역할이나 사전 정의된 역할을 사용하여 이러한 권한을 얻을 수도 있습니다.

버킷에 대한 역할 부여 방법은 버킷에 IAM 사용을 참조하세요.

버킷 삭제

Console

1. Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.
   

   버킷으로 이동

2. 삭제할 버킷의 체크박스를 선택합니다.

3. 삭제를 클릭합니다.

4. 표시되는 오버레이 창에서 버킷과 해당 콘텐츠를 삭제하려는지 확인합니다.

5. 삭제를 클릭합니다.

참고: 버킷에 객체가 많은 경우 삭제 작업이 완료되는 데 평소보다 오래 걸릴 수 있습니다.

Google Cloud 콘솔에서 실패한 Cloud Storage 작업에 대한 자세한 오류 정보를 가져오는 방법은 문제 해결을 참조하세요.

명령줄

버킷 및 버킷 내의 모든 콘텐츠를 삭제하려면 Google Cloud CLI 명령어 gcloud storage rm을 --recursive 플래그와 함께 사용합니다.

gcloud storage rm --recursive gs://BUCKET_NAME

여기서 BUCKET_NAME은 삭제할 버킷의 이름입니다. 예를 들면 my-bucket입니다.

성공하면 응답은 다음 예시와 같습니다.

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

객체 또는 관리 폴더를 실수로 삭제하지 않으려면 버킷이 비어 있는 경우에만 버킷을 삭제하는 gcloud storage buckets delete 명령어를 사용하세요.

참고: 버킷에서 많은 수의 객체를 삭제해야 하면 완료하는 데 시간이 오래 걸리므로 Google Cloud CLI를 사용하지 않는 것이 좋습니다. 대신 Google Cloud Console 또는 객체 수명 주기 관리 기능을 사용하세요. 자세한 내용은 데이터 수명 주기 제어 옵션을 참조하세요.

클라이언트 라이브러리

참고: 클라이언트 라이브러리를 사용하는 경우 버킷을 삭제하려면 먼저 버킷이 비어 있어야 합니다. Python 클라이언트 라이브러리와 같은 일부 클라이언트 라이브러리에서는 강제 삭제 플래그나 함수를 제공합니다.

C++

자세한 내용은 Cloud Storage C++ API 참조 문서를 확인하세요.

Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 클라이언트 라이브러리의 인증 설정을 참조하세요.

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#

자세한 내용은 Cloud Storage C# API 참조 문서를 확인하세요.

Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 클라이언트 라이브러리의 인증 설정을 참조하세요.

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

자세한 내용은 Cloud Storage Go API 참조 문서를 확인하세요.

Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 클라이언트 라이브러리의 인증 설정을 참조하세요.

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

자세한 내용은 Cloud Storage Java API 참조 문서를 확인하세요.

Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 클라이언트 라이브러리의 인증 설정을 참조하세요.

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

자세한 내용은 Cloud Storage Node.js API 참조 문서를 확인하세요.

Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 클라이언트 라이브러리의 인증 설정을 참조하세요.

/**
 * 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

자세한 내용은 Cloud Storage PHP API 참조 문서를 확인하세요.

Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 클라이언트 라이브러리의 인증 설정을 참조하세요.

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

자세한 내용은 Cloud Storage Python API 참조 문서를 확인하세요.

Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 클라이언트 라이브러리의 인증 설정을 참조하세요.

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

자세한 내용은 Cloud Storage Ruby API 참조 문서를 확인하세요.

Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 클라이언트 라이브러리의 인증 설정을 참조하세요.

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

참고: JSON API를 사용하는 경우 버킷을 삭제하려면 먼저 버킷이 비어 있어야 합니다.

1. Authorization 헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.

2. cURL를 사용하여 DELETE 버킷 요청으로 JSON API를 호출합니다.

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

   여기서 BUCKET_NAME은 삭제할 버킷의 이름입니다. 예를 들면 my-bucket입니다.

성공하면 응답에 204 상태 코드가 포함됩니다.

XML API

참고: XML API를 사용하는 경우 버킷을 삭제하려면 먼저 버킷이 비어 있어야 합니다.

1. Authorization 헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.

2. cURL를 사용하여 DELETE 버킷 요청으로 XML API를 호출합니다.

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

   여기서 BUCKET_NAME은 삭제할 버킷의 이름입니다. 예를 들면 my-bucket입니다.

다음 단계

• 버킷 만들기
• 버킷 이동 또는 이름 변경
• 버킷의 객체 나열
• 객체 삭제
• 소프트 삭제된 버킷 복원