購買佈建容量 (POST 佈建的容量) - Amazon Glacier
請求回應範例相關章節

此頁面僅適用於使用 Vaults 和 2012 年原始 REST API 的 Amazon Glacier 服務的現有客戶。

如果您要尋找封存儲存解決方案，建議您在 Amazon Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 Amazon Glacier 儲存類別。 Amazon S3 若要進一步了解這些儲存選項，請參閱 Amazon Glacier 儲存類別。

自 2025 年 12 月 15 日起，Amazon Glacier （原始獨立保存庫型服務） 將不再接受新客戶，不會影響現有客戶。Amazon Glacier 是一項獨立服務，具有自己的 APIs，可將資料存放在保存庫中，並與 Amazon S3 和 Amazon S3 Glacier 儲存類別不同。您現有的資料將在 Amazon Glacier 中無限期保持安全且可存取。不需要遷移。對於低成本、長期的封存儲存， AWS 建議採用 Amazon S3 Glacier 儲存類別，透過 S3 儲存貯體型 APIs、完整 AWS 區域 可用性、降低成本 AWS 和服務整合，提供卓越的客戶體驗。如果您想要增強功能，請考慮使用我們的解決方案指南，將資料從 Amazon S3 Glacier 保存庫傳輸至 Amazon S3 Glacier 儲存類別，以遷移至 Amazon S3 Glacier 儲存類別。 AWS Amazon Glacier Amazon S3

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

購買佈建容量 (POST 佈建的容量)

這個操作為 AWS 帳戶購買一個佈建容量單位。

佈建容量單位會持續一個月，從購買的日期和時間開始，即為開始日期。單位會在過期日期當天過期，即開始日期到最接近的秒數的正好一個月。

如果開始日期是在某個月的第 31 天，過期日期則是下個月的最後一天。例如，如果開始日期是 8 月 31 日，過期日期則是 9 月 30 日。如果開始日期是 1 月 31 日，過期日期則是 2 月 28 日。

佈建容量有助於確保快速擷取在需要時有可用的擷取容量。容量的每個單位都確保每五分鐘至少可以執行三個快速擷取，並提供最多 150 MB/s 的擷取傳輸量。如需佈建之容量的詳細資訊，請參閱「封存擷取選項」。

注意

每個限制兩個佈建容量單位 AWS 帳戶。

請求

若要購買 的佈建容量單位，請將 HTTP POST請求 AWS 帳戶 傳送至佈建容量 URI。

語法

POST /AccountId/provisioned-capacity HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01

注意

AccountId 值為 AWS 帳戶 ID。此值必須與用來簽署請求的登入資料相關聯的 AWS 帳戶 ID 相符。您可以指定 AWS 帳戶 ID 或選擇性地指定單一 '-' （連字號），在這種情況下，Amazon Glacier 會使用與用來簽署請求之登入資料相關聯的 AWS 帳戶 ID。如果您要指定帳戶 ID，請勿在 ID 中包含任何連字號 ('-')。

請求參數

請求標頭

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

請求主體

此操作沒有請求內文。

回應

如果操作請求成功，則服務會傳回 HTTP 201 Created 回應。

語法

HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-capacity-id: CapacityId

回應標頭

成功的回應除了所有作業通用的回應標頭之外，還包含下列回應標頭。如需常見回應標頭的詳細資訊，請參閱常見回應標頭。

名稱 描述

x-amz-capacity-id

此 ID 是用來識別佈建容量單位。

類型：字串

回應內文

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

錯誤

除了所有 Amazon Glacier 操作常見的可能錯誤之外，此操作還包含下列錯誤。如需 Amazon Glacier 錯誤的資訊和錯誤代碼清單，請參閱 錯誤回應。

代碼 說明 HTTP 狀態碼 類型
LimitExceededException 如果給定的請求超過帳戶的佈建容量單位的限制，則傳回。 400 Bad Request 用戶端

範例

以下範例購買帳戶的佈建容量。

範例請求

以下範例傳送 HTTP POST 請求以購買佈建容量單位。

POST /123456789012/provisioned-capacity 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
Content-Length: length
x-amz-glacier-version: 2012-06-01

回應範例

如果請求成功，Amazon Glacier (Amazon Glacier) 會傳回HTTP 201 Created回應，如下列範例所示。

HTTP/1.1 201 Created
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
x-amz-capacity-id: zSaq7NzHFQDANTfQkDen4V7z