設定資料擷取政策 (PUT 政策) - Amazon S3 Glacier
描述請求回應範例相關章節

此頁面僅適用於使用保管庫和 2012 年起原始 REST API 的 S3 冰川服務的現有客戶。

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

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

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

描述

此操作會在 PUT 請求中指定的 AWS 區域設定然後制定資料擷取政策。您能夠為 AWS 帳戶 在每個 AWS 區域設定一個政策。政策是在成功的 PUT 操作幾分鐘內制定的。

設定政策操作不會影響擷取任務，其在制定政策之前便已在進行中。如需有關資料擷取政策的詳細資訊，請參閱 S3 Glacier 資料擷取政策。

請求

語法

若要設定資料擷取政策，請如以下語法範例所示傳送 HTTP PUT 請求到資料擷取政策 URI。

PUT /AccountId/policies/data-retrieval HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01
			
{
  "Policy":
    {
      "Rules":[
         {
             "Strategy": String,
             "BytesPerHour": Number          
         }
       ]
    }
}

注意

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

請求參數

此操作不使用請求參數。

請求標頭

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

請求主體

請求內文包含以下 JSON 欄位。

BytesPerHour

最多可在一小時內擷取的位元組數。

此欄位只有在策略欄位的值為 BytesPerHour 時才需要。若策略欄位未設定為 BytesPerHour 而您設定了此欄位，您的 PUT 操作會被拒絕。

類型：數字

必要：是，如果策略欄位設定為 BytesPerHour。否則為否。

有效值：最低整數值 1。最大整數值為 2^63 - 包含 1。

規則

政策規則。雖然這是清單類型，但目前必須僅有一個規則，其中包含策略欄位和可選的 BytesPerHour 欄位。

類型：陣列

必要：是

策略

要設定的資料擷取政策的類型。

類型：字串

必要：是

有效值：BytesPerHour|FreeTier|None。BytesPerHour 相當於在主控台中選擇最大擷取率。FreeTier 相當於在主控台中選擇僅限免費方案。None 相當於在主控台中選擇無擷取政策。如需在主控台中選擇資料擷取政策的詳細資訊，請參閱 S3 Glacier 資料擷取政策。

回應

語法

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

回應標頭

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

回應內文

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

錯誤

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

範例

範例請求

以下範例傳送策略欄位設定為 BytesPerHour 的 HTTP PUT 請求。

PUT /-/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
			
{
  "Policy":
    {
      "Rules":[
         {
             "Strategy":"BytesPerHour",
             "BytesPerHour":10737418240       
          }
       ]
    }
}

以下範例傳送策略欄位設定為 FreeTier 的 HTTP PUT 請求。

PUT /-/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
			
{
  "Policy":
    {
      "Rules":[
         {
             "Strategy":"FreeTier"   
          }
       ]
    }
}

以下範例傳送策略欄位設定為 None 的 HTTP PUT 請求。

PUT /-/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
			
{
  "Policy":
    {
      "Rules":[
         {
             "Strategy":"None"   
          }
       ]
    }
}

回應範例

如果請求成功，則 Amazon S3 Glacier (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:02:00 GMT