此頁面僅適用於使用文件庫的 S3 Glacier 服務的現有客戶,並且是 2012 年RESTAPI起的原始客戶。
如果您正在尋找存檔儲存解決方案,我們建議您使用 Amazon S3 中的 S3 Glacier 儲存類別、S3 冰川即時擷取、S3 冰川彈性擷取和 S3 Glacier Deep Archive。若要進一步了解這些儲存選項,請參閱 Amazon S3 使用者指南中的 S3 Glacier 儲存類
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
取得資料擷取政策 (GET 政策)
描述
此操作傳回在 GET
請求中指定的 AWS 帳戶 和 AWS 區域的目前資料擷取政策。如需有關資料擷取政策的詳細資訊,請參閱 S3 Glacier 資料擷取政策。
請求
要傳回目前的資料擷取政策、傳送 HTTP GET
請求到資料擷取政策 URI 如下語法範例。
語法
GET /
AccountId
/policies/data-retrieval 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 中包含任何連字號 ('-')。
請求參數
此操作不使用請求參數。
請求標頭
此操作僅使用所有操作常見的請求標頭。如需常見請求標頭的資訊,請參閱 常見請求標題。
請求主體
此操作沒有請求內文。
回應
語法
HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: length { "Policy": { "Rules":[ { "BytesPerHour": Number, "Strategy": String } ] } }
回應標頭
此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊,請參閱 常見回應標頭。
回應內文
回應內文包含以下 JSON 欄位。
- BytesPerHour
-
最多可在一小時內擷取的位元組數。
只有當策略欄位的值為
BytesPerHour
時,此欄位才會出現。類型:數字
- 規則
-
政策規則。雖然這是清單類型,但目前只會有一個規則,其中包含策略欄位和可選的 BytesPerHour 欄位。
類型:陣列
- 策略
-
資料擷取政策的類型。
類型:字串
有效值:
BytesPerHour
|FreeTier
|None
。BytesPerHour
相當於在主控台中選擇最大擷取率。FreeTier
相當於在主控台中選擇僅限免費方案。None
相當於在主控台中選擇無擷取政策。如需在主控台中選擇資料擷取政策的詳細資訊,請參閱 S3 Glacier 資料擷取政策。
錯誤
如需 Amazon S3 Glacier 例外和錯誤訊息的詳細資訊,請參閱錯誤回應。
範例
以下範例示範如何取得資料擷取政策。
範例請求
在這個範例中,將 GET
請求傳送到政策位置的 URI。
GET /-/policies/data-retrieval 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
回應範例
成功的回應以 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: 85 { "Policy": { "Rules":[ { "BytesPerHour":10737418240, "Strategy":"BytesPerHour" } ] } }
相關章節