刪除文件庫 (DELETE 文件庫) - Amazon S3 Glacier
描述請求回應範例相關章節另請參閱

此頁面僅適用於使用 Vaults 和 2012 年原始 REST API 的 S3 Glacier 服務的現有客戶。

如果您要尋找封存儲存解決方案，建議您在 Amazon S3、S3 Glacier S3 Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 S3 Glacier 儲存類別。若要進一步了解這些儲存選項，請參閱《Amazon S3 使用者指南》中的使用 S3 Glacier 儲存類別的 S3 Glacier 儲存類別和長期資料儲存。 Amazon S3 這些儲存類別使用 Amazon S3 API，可在所有區域使用，並且可在 Amazon S3 主控台中管理。它們提供 Storage Cost Analysis、Storage Lens、進階選用加密功能等功能。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

刪除文件庫 (DELETE 文件庫)

描述

這個作業會刪除保存庫。只有在保存庫中沒有按照上次庫存進行封存，並且自上次清點以來沒有再寫入保存庫時，Amazon S3 Glacier (S3 Glacier) 才會刪除保存庫。如果無法滿足這些條件，則保存庫刪除將失敗 (即無法刪除保存庫)，S3 Glacier 將傳回錯誤。

您可以使用提供保存庫資訊的 描述保存庫 (GET 保存庫) 作業，包括在保存庫中的封存數量，但是，該資訊是根據 S3 Glacier 上次產生的保存庫庫存。

此為等冪操作。

注意

當您刪除文件庫，附加到文件庫的文件庫存取政策也會被刪除。如需保存庫存取政策的詳細資訊，請參閱「保存庫存取政策」。

請求

若要刪除文件庫，請將 DELETE 請求傳送至文件庫資源 URI。

語法

DELETE /AccountId/vaults/VaultName HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

注意

此AccountId值是擁有保存庫的帳戶 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選用單一 '-' （連字號），在這種情況下，Amazon S3 Glacier 會使用與用來簽署請求之登入資料相關聯的 AWS 帳戶 ID。如果您使用帳號 ID，請勿在 ID 中包含任何連字號 ('-')。

請求參數

此操作不使用請求參數。

請求標頭

此操作僅使用所有操作常見的請求標頭。如需常見請求標頭的資訊，請參閱 常見請求標題。

請求主體

此操作沒有請求內文。

回應

語法

HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date

回應標頭

此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊，請參閱 常見回應標頭。

回應內文

此作業不會傳回任何回應內文。

錯誤

如需 Amazon S3 Glacier 例外和錯誤訊息的詳細資訊，請參閱錯誤回應。

範例

範例請求

以下範例刪除名為「examplevault」的文件庫。此範例請求是對於要刪除的資源 (文件庫) 的 URI 之 DELETE 請求。

DELETE /-/vaults/examplevault HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

回應範例

HTTP/1.1 204 No Content
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT

另請參閱

如需在語言特定的 Amazon 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：