此頁面僅適用於使用 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 儲存類別
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
取得文件庫存取政策 (GET 存取政策)
描述
此作業會擷取保存庫上設定的 access-policy 子資源，如需設定此子資源的詳細資訊，請參閱 設定保存庫存取政策 (PUT 存取政策)。如果文件庫上沒有設定存取政策，則該操作會傳回 404 Not
found 錯誤。如需保存庫存取政策的詳細資訊，請參閱「保存庫存取政策」。
請求
若要傳回目前文件庫存取政策，請將 HTTP GET 請求傳送到文件庫的 access-policy 子資源的 URI。
語法
GET /AccountId/vaults/vaultName/access-policy HTTP/1.1 Host: glacier.Region.amazonaws.com Date:DateAuthorization:SignatureValuex-amz-glacier-version: 2012-06-01
注意
AccountId 值是擁有保存庫的帳戶 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選擇性地指定單一 '-' （連字號），在這種情況下，Amazon S3 Glacier 會使用與用來簽署請求之登入資料相關聯的 AWS 帳戶 ID。如果您使用帳號 ID，請勿在 ID 中包含任何連字號 ('-')。
請求參數
此操作不使用請求參數。
請求標頭
此操作僅使用所有操作常見的請求標頭。如需常見請求標頭的資訊，請參閱 常見請求標題。
請求主體
此操作沒有請求內文。
回應
在回應中，Amazon S3 Glacier (S3 Glacier) 會在回應內文中以 JSON 格式傳回保存庫存取政策。
語法
HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: length { "Policy": "string" }
回應標頭
此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊，請參閱 常見回應標頭。
回應內文
回應內文包含以下 JSON 欄位。
- 政策
-
保存庫存取政策做為 JSON 字串，使用 "\" 做為逸出字元。
類型：字串
錯誤
如需 Amazon S3 Glacier 例外和錯誤訊息的詳細資訊，請參閱錯誤回應。
範例
以下範例示範如何取得文件庫存取政策。
範例請求
在這個範例中，將 GET 請求傳送到保存庫的 access-policy 子資源的 URI。
GET /-/vaults/examplevault/access-policy 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
回應範例
如果請求成功，S3 Glacier 會在回應的內文中傳回作為 JSON 字串的保存庫存取政策。傳回的 JSON 字串使用 "\" 做為逸出字元，如 設定保存庫存取政策 (PUT 存取政策) 範例中所示。不過，以下範例顯示傳回的 JSON 字串，無需逸出字元即可讀取。
HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: length
{
"Policy": "
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "allow-time-based-deletes",
"Principal": {
"AWS": "999999999999"
},
"Effect": "Allow",
"Action": "glacier:Delete*",
"Resource": [
"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault"
],
"Condition": {
"DateGreaterThan": {
"aws:CurrentTime": "2018-12-31T00:00:00Z"
}
}
}
]
}
"
}相關章節
另請參閱
如需在語言特定的 Amazon 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
