取得資料擷取政策 (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"
          }
       ]
    }
}

相關章節

• 設定資料擷取政策 (PUT 政策)

• 啟動任務 (POST 任務)