上傳封存 (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: Date
Authorization: SignatureValue
x-amz-archive-description: Description
x-amz-sha256-tree-hash: SHA256 tree hash
x-amz-content-sha256: SHA256 linear hash
Content-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 標頭中指定的值不同。 類型：字串 預設：無 限制條件：無	是
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。此值也包含在 Location 標頭中。 類型：字串
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

相關章節

• 在 Amazon S3 Glacier 中使用封存

• 上傳分段中的大型封存 (分段上傳)

• 刪除封存 (DELETE archive)

• Amazon S3 Glacier 的 Identity and Access Management