此頁面僅適用於使用 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 儲存類別和使用 S3 Glacier 儲存類別的長期資料儲存。 Amazon S3 這些儲存類別使用 Amazon S3 API，可在所有區域中使用，並且可以在 Amazon S3 主控台中管理。它們提供儲存成本分析、Storage Lens、進階選用加密功能等功能。

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

此頁面僅適用於使用 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 儲存類別和使用 S3 Glacier 儲存類別的長期資料儲存。 Amazon S3 這些儲存類別使用 Amazon S3 API，可在所有區域中使用，並且可以在 Amazon S3 主控台中管理。它們提供儲存成本分析、Storage Lens、進階選用加密功能等功能。

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

建立保存庫 (PUT 保存庫)

描述

此作業將使用指定的名稱建立新的保存庫。  保存庫的名稱在 的 AWS 區域內必須是唯一的 AWS 帳戶。您可以為每個帳戶建立最多 1,000 個保存庫。如需建立更多保存庫的詳細資訊，請前往 Amazon S3 Glacier 產品詳細資訊頁面。

命名保存庫時必須使用以下準則。

這個作業是等冪的，您可以多次傳送相同的請求，並且在 Amazon S3 Glacier (S3 Glacier) 第一次建立指定的保存庫之後，不會再有任何影響。

請求

語法

若要建立保存庫，請將 HTTP PUT 請求傳送到要建立的保存庫 URI 。

PUT /AccountId/vaults/VaultName HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01

請求參數

此操作不使用請求參數。

請求標頭

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

請求主體

此操作的請求內文必須為空 (0 位元組)。

回應

語法

HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location

回應標頭

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

回應內文

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

錯誤

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

範例

範例請求

以下範例傳送 HTTP PUT 請求來建立名為 examplevault 的保存庫。

PUT /-/vaults/examplevault HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Content-Length: 0
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 建立保存庫，並在 Location 標頭中傳回保存庫的相對 URI 路徑。無論帳戶 ID 或連字號 ('Location') 是否在請求中指定，帳戶 ID 一律會顯示在 - 標頭中。

HTTP/1.1 201 Created
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
Location: /111122223333/vaults/examplevault

相關章節

另請參閱

如需在語言特定的 Amazon 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：