此頁面僅適用於使用 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
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
啟動分段上傳 (POST 分段 - 上傳)
描述
這個作業會啟動分段上傳 (請參閱上傳分段中的大型封存 (分段上傳))。Amazon S3 Glacier (S3 Glacier) 會建立分段上傳資源和在回應中傳回其 ID。在後續分段上傳操作中使用此上傳 ID。
當您啟動分段上傳時，可以指定部分大小 (以位元組為單位)。部分大小必須是 1 MiB (1024 KiB) 乘以 2 的次方，例如 1048576 (1 MiB)、2097152 (2 MiB)、4194304 (4 MiB)、8388608 (8 MiB) 等。最小允許部分大小為 1 MiB，最大為 4 GiB。
使用此上傳 ID上傳的每個部分（除最後一個外）都必須具有相同的大小。最後一個可以是相同的大小或較小。例如，假設您想要上傳 16.2 MiB 的檔案。如果您以 4 MiB 的部分大小啟動分段上傳，則將上傳四個部分的 4 MiB 和一個部分的 0.2 MiB。
注意
當您啟動分段上傳時，不需要知道封存的大小，因為 S3 Glacier 不需要指定整體封存大小。
完成分段上傳後，S3 Glacier 會移除由該 ID 引用的分段上傳資源。如果取消分段上傳，或者如果在 24 小時內沒有活動，則 S3 Glacier 也將移除分段上傳資源。該 ID 可能在24 小時後後仍然可用，但應用程式不應預期這種行為。
請求
若要啟動分段上傳，您可以將 HTTP POST 請求傳送到要儲存封存的保存庫的 multipart-uploads 子資源的 URI。請求必須包括部分大小，並且可以選擇包含封存的說明。
語法
POST /AccountId/vaults/VaultName/multipart-uploads Host: glacier.us-west-2.amazonaws.com Date:DateAuthorization:SignatureValuex-amz-glacier-version: 2012-06-01 x-amz-archive-description:ArchiveDescriptionx-amz-part-size:PartSize
注意
此AccountId值是擁有保存庫的帳戶 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選用單一 '-' （連字號），在這種情況下，Amazon S3 Glacier 會使用與用來簽署請求之登入資料相關聯的 AWS 帳戶 ID。如果您使用帳號 ID，請勿在 ID 中包含任何連字號 ('-')。
請求參數
此操作不使用請求參數。
請求標頭
除了所有作業通用的請求標頭之外，此作業還會使用下列請求標頭。如需常見請求標頭的資訊，請參閱常見請求標題。
| 名稱 | 描述 | 必要 |
|---|---|---|
x-amz-part-size
|
除了最後一個外，每個部分的大小 (以位元組為單位)。最後一個部分可以小於此部分大小。 類型：字串 預設：無 限制：部分大小必須是 1 MiB (1024 KiB) 乘以 2 的次方，例如 1048576 (1 MiB)、2097152 (2 MiB)、4194304 (4 MiB)、8388608 (8 MiB) 等。最小允許部分大小為 1 MiB，最大為 4 GiB (4096 MiB)。 |
是 |
x-amz-archive-description
|
封存描述您正在上傳的部分。它可以是純語言描述或您選擇指派的某個唯一識別符。當您擷取保存庫庫存 (請參閱 啟動任務 (POST 任務)) 時，庫存將為其傳回的每個封存的描述包括在內。封存描述中的前方空格會遭到移除。 類型：字串 預設：無 限制：描述必須小於或等於 1,024 位元組。允許的字元是沒有控制代碼的 7 位元 ASCII，尤其 ASCII 值是 32-126 十進制或 0x20-0x7E 十六進制。 |
否 |
請求主體
此操作沒有請求內文。
回應
在回應中，S3 Glacier 會建立由 ID 識別的分段上傳資源，並傳回分段上傳 ID 的相對 URI 路徑。
語法
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date Location: Location x-amz-multipart-upload-id: multiPartUploadId
回應標頭
成功的回應除了所有作業通用的回應標頭之外，還包含下列回應標頭。如需常見回應標頭的詳細資訊，請參閱常見回應標頭。
| 名稱 | 描述 |
|---|---|
Location
|
已建立分段上傳 ID S3 Glacier 的相對 URI 路徑。您使用此 URI 路徑來限制您的請求以上傳部分，並完成分段上傳。 類型：字串 |
x-amz-multipart-upload-id
|
分段上傳的 ID。此值也包含在 類型：字串 |
回應內文
此作業不會傳回任何回應內文。
錯誤
如需 Amazon S3 Glacier 例外和錯誤訊息的詳細資訊，請參閱錯誤回應。
範例
範例請求
以下範例透過名為 POST 的保存庫的 multipart-uploads 子資源的 URI 傳送 HTTP examplevault 請求來啟動分段上傳。該請求包括標頭以指定 4 MiB (4194304 位元組) 的部分大小和選填的封存描述。
POST /-/vaults/examplevault/multipart-uploads Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-archive-description: MyArchive-101 x-amz-part-size: 4194304 x-amz-glacier-version: 2012-06-01 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 建立分段上傳資源，並將其新增到保存庫的 multipart-uploads 子資源。Location 回應標頭包括分段上傳 ID 的相對 URI 路徑。
HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Location: /111122223333/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE x-amz-multipart-upload-id: OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
如需上傳單個部分的詳細資訊，請參閱 分段上傳 (PUT uploadID)。
相關章節
