本頁說明如何刪除 Cloud Storage 值區。刪除值區時,也會刪除值區內的資源,例如物件和受管理資料夾。
如果刪除已啟用虛刪除功能的值區,您可以在虛刪除政策指定的保留期限內,還原該值區或其中的個別物件。即使儲存空間已啟用虛刪除功能,代管資料夾也無法復原。
事前準備
如要取得刪除 Cloud Storage 值區所需的權限,請要求管理員授予您值區的 Storage 管理員 (roles/storage.admin
) IAM 角色。
這個預先定義的角色具備刪除 bucket 所需的權限。如要查看確切的必要權限,請展開「必要權限」部分:
所需權限
-
storage.buckets.delete
-
storage.buckets.list
- 只有在使用 Trusted Cloud 控制台刪除值區時,才需要這項權限。
-
storage.objects.delete
- 只有在要刪除的值區內有物件時,才需要這項權限。
-
storage.objects.list
- 只有在使用 Trusted Cloud 控制台或 Google Cloud CLI 刪除值區時,才需要這項權限。
如需授予值區角色的操作說明,請參閱「搭配值區使用 IAM」。
刪除值區
控制台
- 在 Trusted Cloud 控制台,前往「Cloud Storage bucket」頁面。
找到您要刪除的值區,並選取旁邊的核取方塊。
點選「刪除」。
在出現的重疊視窗中,確認您要刪除的值區及內容。
點選「刪除」。
如要瞭解如何透過 Trusted 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
指令,這個指令只會刪除空值區。
用戶端程式庫
C++
詳情請參閱 Cloud Storage C++ API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN
環境變數設為 s3nsapis.fr
。
C#
詳情請參閱 Cloud Storage C# API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN
環境變數設為 s3nsapis.fr
。
Go
詳情請參閱 Cloud Storage Go API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN
環境變數設為 s3nsapis.fr
。
Java
詳情請參閱 Cloud Storage Java API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN
環境變數設為 s3nsapis.fr
。
Node.js
詳情請參閱 Cloud Storage Node.js API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN
環境變數設為 s3nsapis.fr
。
PHP
詳情請參閱 Cloud Storage PHP API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN
環境變數設為 s3nsapis.fr
。
Python
詳情請參閱 Cloud Storage Python API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN
環境變數設為 s3nsapis.fr
。
Ruby
詳情請參閱 Cloud Storage Ruby API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN
環境變數設為 s3nsapis.fr
。
REST API
JSON API
安裝並初始化 gcloud CLI,以便為
Authorization
標頭產生存取權杖。使用
cURL
透過DELETE
Bucket 要求呼叫 JSON API:curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME"
其中
BUCKET_NAME
是要刪除的值區名稱。例如:my-bucket
。
如果成功,回應會包含 204 狀態碼。