此頁面僅適用於使用 Vault 和 REST API 2012 年原始版本的 S3 Glacier 服務的現有客戶。
如果您要尋找封存儲存解決方案，建議您在 Amazon S3、S3 Glacier S3 Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 S3 Glacier 儲存類別。若要進一步了解這些儲存選項，請參閱 Amazon S3
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
上傳封存 (POST 封存)
描述
此操作將封存新增到文件庫。如需成功上傳，您的資料要長期保留。Amazon S3 Glacier (S3 Glacier) 會在回應中，傳回此回應之 x-amz-archive-id 標頭中的封存 ID。您應該儲存傳回的封存 ID，以便稍後可以存取封存。
您必須提供正在上傳的資料的 SHA256 樹狀雜湊。如需有關運算 SHA256 樹雜湊的資訊，請參閱 運算檢查總和。
注意
使用 API 時，只有「上傳封存」(POST 封存) 動作才需要 SHA256 樹雜湊。使用 AWS CLI 時不需要此雜湊。
當上傳封存時，您可以選擇指定多達 1,024 可列印 ASCII 字元的封存說明。當您擷取封存或取得文件庫庫存時，S3 Glacier 會傳回封存說明。S3 Glacier 不以任何方式解釋說明。封存說明不需要是唯一的。您不能使用說明來擷取或排序封存清單。
除了選填的封存說明外，S3 Glacier 不支援封存的任何額外中繼資料。封存 ID 是一個不透明的字元序列，您無法從中推斷出封存的任何含義。因此，您可以在用戶端維護封存的中繼資料。如需更多詳細資訊，請參閱 在 Amazon S3 Glacier 中使用封存。
封存是不可變的。在您上傳封存後，您不能編輯封存或其說明。
請求
要上傳封存，請使用 HTTP POST 方法，並將請求範圍限定在要儲存封存的文件庫的 archives 子資源。請求必須包括封存承載大小、檢查總和(SHA256 樹狀雜湊)，並且可以選擇包含封存的說明。
語法
POST /AccountId/vaults/VaultName/archives Host: glacier.Region.amazonaws.com x-amz-glacier-version: 2012-06-01 Date:DateAuthorization:SignatureValuex-amz-archive-description:Descriptionx-amz-sha256-tree-hash:SHA256 tree hashx-amz-content-sha256:SHA256 linear hashContent-Length:Length<Request body.>
注意
此 AccountId 值是擁有該文件庫之帳戶的 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選擇性使用 '-' (連字號)，在這種情況下，Amazon S3 會使用與用於簽署請求之憑證關聯的 AWS 帳戶 ID。如果您使用帳號 ID，請勿在 ID 中包含任何連字號 ('-')。
請求參數
此實作操作不使用請求參數。
請求標頭
除了所有操作通用的請求標頭之外，此操作還會使用下列請求標頭。如需常見請求標頭的資訊，請參閱常見請求標題。
| 名稱 | 描述 | 必要 |
|---|---|---|
Content-Length
|
物件的大小 (位元組)。如需詳細資訊，請參閱 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13 類型：數字 預設：無 限制條件：無 |
是 |
x-amz-archive-description
|
正在上傳的封存的可選說明。它可以是純語言描述或您選擇指派的某個識別符。說明在封存中不必是唯一的。當您擷取文件庫庫存 (請參閱 啟動 Job (POST工作)) 時，它將為其傳回的每個封存的說明包括在內。 類型：字串 預設：無 限制：說明必須小於或等於 1,024 字元。允許的字元是沒有控制代碼的 7 位元 ASCII，尤其 ASCII 值是 32-126 十進制或 0x20-0x7E 十六進制。 |
否 |
x-amz-content-sha256
|
承載的 SHA256-256 檢查總和 (線性雜湊)。這與您在 類型：字串 預設：無 限制條件：無 |
是 |
x-amz-sha256-tree-hash
|
承載的使用者計算的檢查總和，SHA256-256 樹狀雜湊。如需有關運算 SHA256 樹狀雜湊的資訊，請參閱 運算檢查總和。如果 S3 Glacier 計算承載的不同檢查總和，其會拒絕該請求。 類型：字串 預設：無 限制條件：無 |
是 |
請求主體
請求內文包含要上傳的資料。
回應
S3 Glacier 會在回應中長期存放封存，並傳回封存 ID 的 URI 路徑。
語法
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier Location: Location x-amz-archive-id: ArchiveId
回應標頭
成功的回應除了所有操作通用的回應標頭之外，還包含下列回應標頭。如需常見回應標頭的詳細資訊，請參閱常見回應標頭。
| 名稱 | 描述 |
|---|---|
Location
|
新加入的封存資源的相對 URI 路徑。 類型：字串 |
x-amz-archive-id
|
此封存的 ID。此值也包含在 類型：字串 |
x-amz-sha256-tree-hash |
由 S3 Glacier 計算的封存檢查總和。 類型：字串 |
回應內文
此操作不會傳回任何回應內文。
錯誤
如需 Amazon S3 Glacier 例外和錯誤訊息的詳細資訊，請參閱錯誤回應。
範例
範例請求
以下範例顯示上傳封存的請求。
POST /-/vaults/examplevault/archives HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 x-amz-content-sha256: 7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3 Content-Length: 2097152 x-amz-glacier-version: 2012-06-01 Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace <Request body (2097152 bytes).>
回應範例
下面的成功回應有一個 Location 標頭，您可以從中取得S3 Glacier 指派給封存的 ID。
HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
相關章節
