選取您的 Cookie 偏好設定

我們使用提供自身網站和服務所需的基本 Cookie 和類似工具。我們使用效能 Cookie 收集匿名統計資料,以便了解客戶如何使用我們的網站並進行改進。基本 Cookie 無法停用,但可以按一下「自訂」或「拒絕」以拒絕效能 Cookie。

如果您同意,AWS 與經核准的第三方也會使用 Cookie 提供實用的網站功能、記住您的偏好設定,並顯示相關內容,包括相關廣告。若要接受或拒絕所有非必要 Cookie,請按一下「接受」或「拒絕」。若要進行更詳細的選擇,請按一下「自訂」。

上傳封存 (POST 封存) - Amazon S3 Glacier

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

如果您要尋找封存儲存解決方案,建議您在 Amazon S3、S3 Glacier S3 Instant RetrievalS3 Glacier Flexible RetrievalS3 Glacier Deep Archive 中使用 S3 Glacier 儲存類別。若要進一步了解這些儲存選項,請參閱《Amazon S3 使用者指南》中的使用 S3 Glacier 儲存類別的 S3 Glacier 儲存類別和長期資料儲存Amazon S3 這些儲存類別使用 Amazon S3 API,可在所有區域使用,並且可在 Amazon S3 主控台中管理。它們提供 Storage Cost Analysis、Storage Lens、進階選用加密功能等功能。

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

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

如果您要尋找封存儲存解決方案,建議您在 Amazon S3、S3 Glacier S3 Instant RetrievalS3 Glacier Flexible RetrievalS3 Glacier Deep Archive 中使用 S3 Glacier 儲存類別。若要進一步了解這些儲存選項,請參閱《Amazon S3 使用者指南》中的使用 S3 Glacier 儲存類別的 S3 Glacier 儲存類別和長期資料儲存Amazon S3 這些儲存類別使用 Amazon S3 API,可在所有區域使用,並且可在 Amazon S3 主控台中管理。它們提供 Storage Cost Analysis、Storage Lens、進階選用加密功能等功能。

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

上傳封存 (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 Glacier 會使用與用來簽署請求之登入資料相關聯的 AWS 帳戶 ID。如果您使用帳號 ID,請勿在 ID 中包含任何連字號 ('-')。

請求參數

此實作操作不使用請求參數。

請求標頭

除了所有作業通用的請求標頭之外,此作業還會使用下列請求標頭。如需常見請求標頭的資訊,請參閱常見請求標題

名稱 描述 必要
Content-Length

物件的大小 (位元組)。如需詳細資訊,請參閱 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13

類型:數字

預設:無

限制條件:無

x-amz-archive-description

正在上傳的封存的可選說明。它可以是純語言描述或您選擇指派的某個識別符。說明在封存中不必是唯一的。當您擷取保存庫庫存 (請參閱 啟動任務 (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

相關章節

下一個主題:

分段上傳操作

上一個主題:

刪除封存
隱私權網站條款Cookie 偏好設定
© 2025, Amazon Web Services, Inc.或其附屬公司。保留所有權利。