啟動分段上傳 (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: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01
x-amz-archive-description: ArchiveDescription
x-amz-part-size: PartSize

注意

此 AccountId 值是擁有該文件庫之帳戶的 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選擇性使用 '-' (連字號)，在這種情況下，Amazon S3 會使用與用於簽署請求之憑證關聯的 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。此值也包含在 Location 標頭中。 類型：字串

回應內文

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

錯誤

如需 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)。

相關章節

• 分段上傳 (PUT uploadID)

• 完成分段上傳 (POST uploadID)

• 中止分段上傳 (DELETE uploadID)

• 列出分段上傳 (GET 分段 - 上傳)

• 清單部分 (GET uploadID)

• 刪除封存 (DELETE archive)

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

• Amazon S3 Glacier 的 Identity and Access Management