「中止文件庫鎖定」(DELETE 鎖定政策) - Amazon S3 Glacier
描述請求回應範例相關章節另請參閱

此頁面僅適用於使用文件庫的 S3 Glacier 服務的現有客戶，並且是 2012 年RESTAPI起的原始客戶。

如果您正在尋找存檔儲存解決方案，我們建議您使用 Amazon S3 中的 S3 Glacier 儲存類別、S3 冰川即時擷取、S3 冰川彈性擷取和 S3 Glacier Deep Archive。若要進一步了解這些儲存選項，請參閱 Amazon S3 使用者指南中的 S3 Glacier 儲存類別和使用 S3 Glacier 儲存類別的長期資料儲存。這些儲存類別使用 Amazon S3API，可在所有區域使用，並且可以在 Amazon S3 主控台中管理。它們提供了諸如存儲成本分析，存儲鏡頭，高級可選加密功能等功能。

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

「中止文件庫鎖定」(DELETE 鎖定政策)

描述

如果文件庫鎖定不是 Locked 狀態，此操作會停止文件庫鎖定程序。如果在請求此操作時，文件庫鎖定處於 Locked 狀態，則該操作將傳回 AccessDeniedException 錯誤。停止文件庫鎖定程序，會將文件庫鎖定政策從指定的文件庫中移除。

透過呼叫 InProgress，文件庫鎖定進入 啟動文件庫鎖定 (POST 鎖定政策) 狀態。透過呼叫 Locked，文件庫鎖定進入 完成文件庫鎖定 (POST lockId) 狀態。您可以透過呼叫 取得文件庫鎖定 (GET 鎖定政策) 來取得文件庫鎖定的狀態。如需文件庫鎖定程序的詳細資訊，請參閱S3 Glacier 文件庫鎖定。如需文件庫鎖定政策的詳細資訊，請參閱保存庫鎖定政策。

此為等冪操作。如果文件庫鎖定處於 InProgress 狀態或者沒有與文件庫關聯的政策，則可以多次成功呼叫此操作。

請求

若要刪除文件庫鎖定政策，請將 HTTP DELETE 請求傳送到文件庫 lock-policy 子資源的 URI。

語法

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

注意

此 AccountId 值是 AWS 帳戶 ID。此值必須符合與用於簽署請求之憑證關聯的 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選擇性使用 '-' (連字號)，在這種情況下，Amazon S3 會使用與用於簽署請求之憑證關聯的 AWS 帳戶 ID。如果您要指定帳戶 ID，請勿在 ID 中包含任何連字號 ('-')。

請求參數

此操作不使用請求參數。

請求標頭

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

請求主體

此操作沒有請求內文。

回應

如果成功刪除該政策，S3 Glacier 將傳回 HTTP 204 No Content 回應。

語法

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

回應標頭

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

回應內文

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

錯誤

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

範例

以下範例示範如何停止文件庫鎖定程序。

範例請求

在這個範例中，將 DELETE 請求傳送到名為 examplevault 的文件庫的 lock-policy 子資源。

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

回應範例

如果政策成功刪除，則 S3 Glacier 會如以下範例所示傳回 HTTP 204 No Content 回應。

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

另請參閱

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