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

如果您要尋找封存儲存解決方案，建議您在 Amazon Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 Amazon Glacier 儲存類別。 Amazon S3 若要進一步了解這些儲存選項，請參閱 [Amazon Glacier 儲存類別](https://aws.amazon.com/s3/storage-classes/glacier/)。

Amazon Glacier （原始獨立保存庫型服務） 不再接受新客戶。Amazon Glacier 是一項獨立服務，具有自己的 APIs，可將資料存放在保存庫中，並與 Amazon S3 和 Amazon S3 Glacier 儲存類別不同。您現有的資料將在 Amazon Glacier 中無限期保持安全且可存取。不需要遷移。對於低成本、長期的封存儲存， AWS 建議使用 [Amazon S3 Glacier 儲存類別](https://aws.amazon.com/s3/storage-classes/glacier/)，透過 S3 儲存貯體型 APIs、完整 AWS 區域 可用性、降低成本 AWS 和服務整合，提供卓越的客戶體驗。如果您想要增強功能，請考慮使用我們的解決方案指南，將資料從 Amazon S3 Glacier 保存庫傳輸至 Amazon S3 Glacier 儲存類別，以遷移至 Amazon S3 Glacier 儲存類別。 [AWS Amazon Glacier Amazon S3 ](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)

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

# 分段上傳操作
<a name="multipart-archive-operations"></a>

以下是可用於 Amazon Glacier 的分段上傳操作。

**Topics**
+ [中止分段上傳 (DELETE uploadID)](api-multipart-abort-upload.md)
+ [完成分段上傳 (POST uploadID)](api-multipart-complete-upload.md)
+ [啟動分段上傳 (POST 分段 - 上傳)](api-multipart-initiate-upload.md)
+ [清單部分 (GET uploadID)](api-multipart-list-parts.md)
+ [列出分段上傳 (GET 分段 - 上傳)](api-multipart-list-uploads.md)
+ [分段上傳 (PUT uploadID)](api-upload-part.md)

# 中止分段上傳 (DELETE uploadID)
<a name="api-multipart-abort-upload"></a>

## Description
<a name="api-multipart-abort-upload-description"></a>

此分段上傳作業命令會停止由上傳 ID 識別的分段上傳。

中止分段上傳請求成功後，您不能使用上傳 ID 上傳更多部分或執行任何其他操作。停止已完成的分段上傳失敗。但是，停止已經停止的上傳動作將會在短時間內成功。

此為等冪操作。

如需有關分段上傳的資訊，請參閱[上傳分段中的大型封存 (分段上傳)](uploading-archive-mpu.md)。

## 要求
<a name="api-multipart-abort-upload-requests"></a>

若要停止分段上傳，請將 HTTP `DELETE` 請求傳送至保存庫 `multipart-uploads` 子資源的 URI，並將特定的分段上傳 ID 識別為 URI 的一部分。

### 語法
<a name="api-multipart-abort-upload-requests-syntax"></a>

```
1. DELETE /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```

 

**注意**  
`AccountId` 值是擁有保存庫的帳戶 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選擇性地指定單一 '`-`' （連字號），在這種情況下，Amazon Glacier 會使用與用來簽署請求之登入資料相關聯的 AWS 帳戶 ID。如果您使用帳號 ID，請勿在 ID 中包含任何連字號 ('-')。

### 請求參數
<a name="api-multipart-abort-upload-requests-parameters"></a>

此操作不使用請求參數。

### 請求標頭
<a name="api-multipart-abort-upload-requests-headers"></a>

此操作僅使用所有操作常見的請求標頭。如需常見請求標頭的資訊，請參閱 [常見請求標題](api-common-request-headers.md)。

### 請求主體
<a name="api-multipart-abort-upload-requests-elements"></a>

此操作沒有請求內文。

## 回應
<a name="api-multipart-abort-upload-responses"></a>

### 語法
<a name="api-multipart-abort-upload-responses-syntax"></a>

```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```

### 回應標頭
<a name="api-multipart-abort-upload-responses-headers"></a>

此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊，請參閱 [常見回應標頭](api-common-response-headers.md)。

### 回應內文
<a name="api-multipart-abort-upload-responses-elements"></a>

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

### 錯誤
<a name="api-multipart-abort-upload-responses-errors"></a>

如需 Amazon Glacier 例外狀況和錯誤訊息的相關資訊，請參閱 [錯誤回應](api-error-responses.md)。

## 範例
<a name="api-multipart-abort-upload-examples"></a>

### 範例請求
<a name="api-multipart-abort-upload-example-request"></a>

在下列範例中，將 `DELETE` 請求傳送到分段上傳 ID 資源的 URI。

```
1. DELETE /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE  HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```

### 回應範例
<a name="api-multipart-abort-upload-example-response"></a>

```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
```

## 相關章節
<a name="related-sections-multipart-abort-upload"></a>

 
+ [啟動分段上傳 (POST 分段 - 上傳)](api-multipart-initiate-upload.md)
+ [分段上傳 (PUT uploadID)](api-upload-part.md)
+ [完成分段上傳 (POST uploadID)](api-multipart-complete-upload.md)
+ [列出分段上傳 (GET 分段 - 上傳)](api-multipart-list-uploads.md)
+ [清單部分 (GET uploadID)](api-multipart-list-parts.md)
+ [上傳分段中的大型封存 (分段上傳)](uploading-archive-mpu.md)
+ [Amazon Glacier 的 Identity and Access Management](security-iam.md)

# 完成分段上傳 (POST uploadID)
<a name="api-multipart-complete-upload"></a>

## 說明
<a name="api-multipart-complete-upload-description"></a>

您呼叫此分段上傳操作，以通知 Amazon Glacier (Amazon Glacier) 所有封存組件都已上傳，Amazon Glacier 現在可從上傳的組件組合封存。

如需有關分段上傳的資訊，請參閱[上傳分段中的大型封存 (分段上傳)](uploading-archive-mpu.md)。

將封存合併並儲存到保存庫之後，Amazon Glacier 會傳回新建立的封存資源的封存 ID。上傳封存後，應該儲存傳回的封存 ID 以便稍後擷取封存。

在請求中，必須包括已上傳的整個封存的計算 SHA256 樹雜湊。如需有關運算 SHA256 樹雜湊的資訊，請參閱 [運算檢查總和](checksum-calculations.md)。在伺服器端，Amazon Glacier 也會建構組合封存的 SHA256 樹雜湊。如果值相符，Amazon Glacier 會將封存儲存至保存庫；否則會傳回錯誤，且操作會失敗。此 [清單部分 (GET uploadID)](api-multipart-list-parts.md) 操作會傳回為特定的分段上傳所上傳的組件清單。其中包含每個上傳部分的檢查總和資訊，可用於偵測錯誤的檢查總和問題。

此外，Amazon Glacier 也會檢查是否有任何遺漏的內容範圍。上傳部分時，可指定範圍值，以識別每個部分所適合在該封存中的最終整合位置。組合最終封存時，Amazon Glacier 會檢查是否有任何遺失的內容範圍，以及是否有任何遺失的內容範圍，Amazon Glacier 會傳回錯誤，且完成分段上傳操作會失敗。

完整分段上傳是等冪操作。在您首次成功完整分段上傳後，如果在短時間內再次呼叫該操作，該操作將成功並傳回相同的封存 ID。這在遇到網路問題或收到 500 伺服器錯誤時非常有用，在這種情況下，您可以重複完整分段上傳請求，並在不建立重複封存的情況下獲得相同的封存 ID。但是請注意，在分段上傳完成後，您無法呼叫清單組件操作，並且分段上傳不會出現在清單分段上傳回應中，即使冪等完整也是如此。

## 請求
<a name="api-multipart-complete-upload-requests"></a>

若要完成分段上傳，請將 HTTP POST 請求傳送至 Amazon Glacier 為回應啟動分段上傳請求而建立的上傳 ID URI。這與上傳組件時使用的 URI 相同。除了常見的必要標頭外，還必須包括整個封存的 SHA256 樹雜湊結果和封存的總大小 (以位元組為單位)。

### 語法
<a name="api-multipart-complete-upload-requests-syntax"></a>

```
1. POST /AccountId/vaults/VaultName/multipart-uploads/uploadID
2. Host: glacier.Region.amazonaws.com
3. Date: date
4. Authorization: SignatureValue
5. x-amz-sha256-tree-hash: SHA256 tree hash of the archive
6. x-amz-archive-size: ArchiveSize in bytes
7. x-amz-glacier-version: 2012-06-01
```

 

**注意**  
`AccountId` 值是擁有保存庫的帳戶 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選擇性地指定單一 '`-`' （連字號），在這種情況下，Amazon Glacier 會使用與用來簽署請求之登入資料相關聯的 AWS 帳戶 ID。如果您使用帳號 ID，請勿在 ID 中包含任何連字號 ('-')。

### 請求參數
<a name="api-multipart-complete-upload-requests-parameters"></a>

此操作不使用請求參數。

### 請求標頭
<a name="api-multipart-complete-upload-requests-headers"></a>

除了所有作業通用的請求標頭之外，此作業還會使用下列請求標頭。如需常見請求標頭的資訊，請參閱[常見請求標題](api-common-request-headers.md)。


|  名稱  |  描述  |  必要  | 
| --- | --- | --- | 
| x-amz-archive-size   |  整個封存的總大小 (以位元組為單位)。這個值應該是您上傳的個別組件的所有大小的總和。 類型：字串 預設：無 限制條件：無  |  是 | 
|  x-amz-sha256-tree-hash​  |  整個封存的 SHA256 樹雜湊。它是個別組件的 SHA256 樹雜湊的樹雜湊。如果您在請求中指定的值不符合 Amazon Glacier 計算的最終組合封存的 SHA256 樹雜湊，Amazon Glacier 會傳回錯誤，且請求會失敗。 類型：字串 預設：無 限制條件：無  |  是 | 

### 要求元素
<a name="api-multipart-complete-upload-requests-elements"></a>

此操作不使用請求元素。

## 回應
<a name="api-multipart-complete-upload-responses"></a>

Amazon Glacier (Amazon Glacier) 會建立整個封存的 SHA256 樹雜湊。如果值符合您在請求中指定之整個封存的 SHA256 樹雜湊，Amazon Glacier 會將封存新增至保存庫。在回應中，會傳回具有新增的封存資源的 URL 路徑的 HTTP `Location` 標頭。如果您在請求中傳送的封存大小或 SHA256 不相符，Amazon Glacier 將傳回錯誤，且上傳仍處於未完成狀態。稍後可以使用正確的值重試完整分段上傳操作，此時您可以成功建立封存。如果分段上傳未完成，最終 Amazon Glacier 將回收上傳 ID。

### 語法
<a name="api-multipart-complete-upload-responses-syntax"></a>

```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location
x-amz-archive-id: ArchiveId
```

### 回應標頭
<a name="api-multipart-complete-upload-responses-headers"></a>

成功的回應除了所有作業通用的回應標頭之外，還包含下列回應標頭。如需常見回應標頭的詳細資訊，請參閱[常見回應標頭](api-common-response-headers.md)。


|  名稱  |  描述  | 
| --- | --- | 
|  Location  |  新建立的封存的相對 URI 路徑。此 URL 包含 Amazon Glacier 產生的封存 ID。 類型：字串  | 
|  x-amz-archive-id  |  此封存的 ID。此值也包含在 `Location` 標頭中。 類型：字串  | 

### 回應欄位
<a name="api-multipart-complete-upload-responses-elements"></a>

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

## 範例
<a name="api-multipart-complete-upload-examples"></a>

### 範例請求
<a name="api-multipart-complete-upload-example-request"></a>

在這個範例中，HTTP POST 請求被傳送到由初始分段上傳請求傳回的 URI。該請求同時指定整個封存的 SHA256 樹雜湊和總封存大小。

```
1. POST /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. z-amz-Date: 20170210T120000Z
4. x-amz-sha256-tree-hash:1ffc0f54dd5fdd66b62da70d25edacd0
5. x-amz-archive-size:8388608
6. x-amz-glacier-version: 2012-06-01
7. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```

### 回應範例
<a name="api-multipart-complete-upload-example-response"></a>

下列範例回應顯示 Amazon Glacier 已成功從您上傳的部分建立封存。該回應包含具有完整路徑的封存 ID。

```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
5. x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
```

您現在可以將 HTTP 請求傳送到新增的資源/封存的 URI。例如，您可以傳送 GET 請求以擷取封存。

## 相關章節
<a name="related-sections-complete-mpu"></a>

 
+ [啟動分段上傳 (POST 分段 - 上傳)](api-multipart-initiate-upload.md)
+ [分段上傳 (PUT uploadID)](api-upload-part.md)
+ [中止分段上傳 (DELETE uploadID)](api-multipart-abort-upload.md)
+ [列出分段上傳 (GET 分段 - 上傳)](api-multipart-list-uploads.md)
+ [清單部分 (GET uploadID)](api-multipart-list-parts.md)
+ [上傳分段中的大型封存 (分段上傳)](uploading-archive-mpu.md)
+  [刪除封存 (DELETE archive)](api-archive-delete.md)
+ [Amazon Glacier 的 Identity and Access Management](security-iam.md)

# 啟動分段上傳 (POST 分段 - 上傳)
<a name="api-multipart-initiate-upload"></a>

## Description
<a name="api-multipart-initiate-upload-description"></a>

這個作業會啟動分段上傳 (請參閱[上傳分段中的大型封存 (分段上傳)](uploading-archive-mpu.md))。Amazon Glacier (Amazon 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。

 

**注意**  
當您開始分段上傳時，不需要知道封存的大小，因為 Amazon Glacier 不需要您指定整體封存大小。

完成分段上傳後，Amazon Glacier 會移除 ID 參考的分段上傳資源。如果您取消分段上傳，或者如果 24 小時內沒有活動，Amazon Glacier 也會移除分段上傳資源。該 ID 可能在24 小時後後仍然可用，但應用程式不應預期這種行為。

## 要求
<a name="api-multipart-initiate-upload-requests"></a>

若要啟動分段上傳，您可以將 HTTP `POST` 請求傳送到要儲存封存的保存庫的 `multipart-uploads` 子資源的 URI。請求必須包括部分大小，並且可以選擇包含封存的說明。

### 語法
<a name="api-multipart-initiate-upload-requests-syntax"></a>

```
1. POST /AccountId/vaults/VaultName/multipart-uploads 
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
6. x-amz-archive-description: ArchiveDescription
7. x-amz-part-size: PartSize
```

 

**注意**  
`AccountId` 值是擁有保存庫的帳戶 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選擇性地指定單一 '`-`' （連字號），在這種情況下，Amazon Glacier 會使用與用來簽署請求之登入資料相關聯的 AWS 帳戶 ID。如果您使用帳號 ID，請勿在 ID 中包含任何連字號 ('-')。

### 請求參數
<a name="api-archive-post-requests-parameters1"></a>

此操作不使用請求參數。

### 請求標頭
<a name="api-archive-post-requests-headers1"></a>

除了所有作業通用的請求標頭之外，此作業還會使用下列請求標頭。如需常見請求標頭的資訊，請參閱[常見請求標題](api-common-request-headers.md)。


|  名稱  |  描述  |  必要  | 
| --- | --- | --- | 
|  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 任務)](api-initiate-job-post.md)) 時，庫存將為其傳回的每個封存的描述包括在內。封存描述中的前方空格會遭到移除。 類型：字串 預設：無 限制：描述必須小於或等於 1,024 位元組。允許的字元是沒有控制代碼的 7 位元 ASCII，尤其 ASCII 值是 32-126 十進制或 0x20-0x7E 十六進制。  |  否  | 

### 請求主體
<a name="api-multipart-initiate-upload-requests-elements"></a>

此操作沒有請求內文。

## 回應
<a name="api-multipart-initiate-upload-responses"></a>

在回應中，Amazon Glacier 會建立由 ID 識別的分段上傳資源，並傳回分段上傳 ID 的相對 URI 路徑。

### 語法
<a name="api-multipart-initiate-upload-response-syntax"></a>

```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. Location: Location
5. x-amz-multipart-upload-id: multiPartUploadId
```

### 回應標頭
<a name="api-archive-post-responses-headers2"></a>

成功的回應除了所有作業通用的回應標頭之外，還包含下列回應標頭。如需常見回應標頭的詳細資訊，請參閱[常見回應標頭](api-common-response-headers.md)。


|  名稱  |  描述  | 
| --- | --- | 
|  Location  |  已建立分段上傳 ID Amazon Glacier 的相對 URI 路徑。您使用此 URI 路徑來限制您的請求以上傳部分，並完成分段上傳。 類型：字串  | 
|  x-amz-multipart-upload-id  |  分段上傳的 ID。此值也包含在 `Location` 標頭中。 類型：字串  | 

### 回應內文
<a name="api-archive-post-responses-elements1"></a>

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

### 錯誤
<a name="api-archive-post-responses-errors1"></a>

如需 Amazon Glacier 例外狀況和錯誤訊息的相關資訊，請參閱 [錯誤回應](api-error-responses.md)。

## 範例
<a name="initiate-mpu-api-example"></a>

### 範例請求
<a name="api-multipart-initiate-upload-example-request"></a>

以下範例透過名為 `POST` 的保存庫的 `multipart-uploads` 子資源的 URI 傳送 HTTP `examplevault` 請求來啟動分段上傳。該請求包括標頭以指定 4 MiB (4194304 位元組) 的部分大小和選填的封存描述。

```
1. POST /-/vaults/examplevault/multipart-uploads 
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-archive-description: MyArchive-101
5. x-amz-part-size: 4194304
6. x-amz-glacier-version: 2012-06-01
7. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```

### 回應範例
<a name="api-multipart-initiate-upload-example-response"></a>

Amazon Glacier 會建立分段上傳資源，並將其新增至保存庫的`multipart-uploads`子資源。`Location` 回應標頭包括分段上傳 ID 的相對 URI 路徑。

```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Location: /111122223333/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
5. x-amz-multipart-upload-id: OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
```

如需上傳單個部分的詳細資訊，請參閱 [分段上傳 (PUT uploadID)](api-upload-part.md)。

## 相關章節
<a name="related-sections-initiate-mpu"></a>

 
+ [分段上傳 (PUT uploadID)](api-upload-part.md)
+ [完成分段上傳 (POST uploadID)](api-multipart-complete-upload.md)
+ [中止分段上傳 (DELETE uploadID)](api-multipart-abort-upload.md)
+ [列出分段上傳 (GET 分段 - 上傳)](api-multipart-list-uploads.md)
+ [清單部分 (GET uploadID)](api-multipart-list-parts.md)
+ [刪除封存 (DELETE archive)](api-archive-delete.md)
+ [上傳分段中的大型封存 (分段上傳)](uploading-archive-mpu.md)
+ [Amazon Glacier 的 Identity and Access Management](security-iam.md)

# 清單部分 (GET uploadID)
<a name="api-multipart-list-parts"></a>

## Description
<a name="api-multipart-list-partsDescription"></a>

此分段上傳操作列出已上傳到由上傳 ID 識別的特定分段上傳中的封存部分。如需有關分段上傳的資訊，請參閱[上傳分段中的大型封存 (分段上傳)](uploading-archive-mpu.md)。

在完成分段上傳之前，您可以在正在進行的分段上傳期間隨時提出此請求。Amazon Glacier 會傳回按您在每個部分上傳中指定的範圍排序的部分清單。如果您在完成分段上傳後傳送列出組件請求，Amazon Glacier (Amazon Glacier) 會傳回錯誤。

此清單部分操作支援分頁。您應該經常檢查回應內文 `Marker` 欄位中註明可繼續列表的標記，如果沒有其他項目，`marker` 欄位為 `null`。如果 `marker` 不是 null，若要擷取您傳送的另一組列出組件請求，並將`marker`請求參數設定為 Amazon Glacier 傳回的標記值，以回應先前的列出組件請求。

您可以透過在請求中指定 `limit` 參數來限制回應中傳回的部分數量。

## 要求
<a name="api-multipart-list-parts-requests"></a>

### 語法
<a name="api-multipart-list-parts-requests-syntax"></a>

要列出正在進行的分段上傳的部分，請將 `GET` 請求傳送到分段上傳 ID 資源的 URI。當您啟動分段上傳時，將傳回分段上傳 ID ([啟動分段上傳 (POST 分段 - 上傳)](api-multipart-initiate-upload.md))。您可以選擇指定 `marker` 和 `limit` 參數。

```
1. GET /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```

 

**注意**  
`AccountId` 值是擁有保存庫的帳戶 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選擇性指定單一 '`-`' （連字號），在這種情況下，Amazon Glacier 會使用與用來簽署請求之登入資料相關聯的 AWS 帳戶 ID。如果您使用帳號 ID，請勿在 ID 中包含任何連字號 ('-')。

### 請求參數
<a name="api-multipart-list-parts-requests-parameters"></a>


|  名稱  |  描述  |  必要  | 
| --- | --- | --- | 
| limit  |  所要傳回的部分數量上限。預設限制為 50。傳回的部分數量可能少於指定的限制，但傳回的部分數量永遠不會超過限制。 類型：字串 限制：最小整數值為 `1`。最大整數值為 `50`。  |  否  | 
|  marker  |  用於分頁的不透明字串。`marker` 指定部分清單應開始的部分。從之前的清單部分回應的回應中獲取 `marker` 值。如果您要繼續對之前的清單部分請求中開始的結果進行分頁，則只需包含 `marker`。 類型：字串 限制條件：無  |  否 | 

### 請求標頭
<a name="api-multipart-list-parts-requests-headers"></a>

此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊，請參閱 [常見回應標頭](api-common-response-headers.md)。

### 請求主體
<a name="api-multipart-list-parts-requests-elements"></a>

此操作沒有請求內文。

## 回應
<a name="api-multipart-list-parts-responses"></a>

### 語法
<a name="api-multipart-list-parts-responses-syntax"></a>

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: x-amzn-RequestId
 3. Date: Date
 4. Content-Type: application/json
 5. Content-Length: Length
 6. 
 7. {
 8.     "ArchiveDescription" : String,
 9.     "CreationDate" : String,
10.     "Marker": String,
11.     "MultipartUploadId" : String,
12.     "PartSizeInBytes" : Number,
13.     "Parts" : 
14.     [ {
15.       "RangeInBytes" : String,
16.       "SHA256TreeHash" : String
17.       },
18.       ...
19.      ],
20.     "VaultARN" : String
21. }
```

### 回應標頭
<a name="api-multipart-list-parts-responses-headers"></a>

此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊，請參閱 [常見回應標頭](api-common-response-headers.md)。

### 回應內文
<a name="api-multipart-list-parts-responses-elements"></a>

回應內文包含以下 JSON 欄位。

**ArchiveDescription**  
在啟動分段上傳請求中指定的封存說明。如果在啟動分段上傳操作中未指定封存說明，則此欄位為 `null`。  
*類型：*字串

**CreationDate**  
啟動分段上傳的 UTC 時間。  
*類型*：字串 ISO 8601 日期格式的字串表示法，例如，`2013-03-20T17:03:43.221Z`。

**Marker**  
一個不透明字串，表示繼續結果分頁之處。您可以在新的清單部分請求中使用 `marker` 來取得清單中的更多任務。如果沒有更多的部分列出，則此值為 `null`。  
*類型：*字串

**MultipartUploadId**  
與部分關聯的上傳的 ID。  
*類型：*字串

**PartSizeInBytes**  
部分大小 (以位元組為單位)。這與您在啟動分段上傳請求中指定的值相同。  
*類型*：數字

**部分**  
分段上傳的部分大小清單。陣列中的每個物件都包含 `RangeBytes` 和 `sha256-tree-hash` 名稱/值對。  
*類型*：陣列

**RangeInBytes**  
部分的位元組範圍，包含範圍的上限值。  
*類型：*字串

**SHA256TreeHash**   
Amazon Glacier 為組件計算的 SHA256 樹雜湊值。此欄位永遠不為 `null`。  
*類型：*字串

**VaultARN**  
啟動分段上傳的文件庫的 Amazon Resource Name (ARN)。  
*類型：*字串

### 錯誤
<a name="api-multipart-list-parts-responses-errors"></a>

如需 Amazon Glacier 例外狀況和錯誤訊息的相關資訊，請參閱 [錯誤回應](api-error-responses.md)。

## 範例
<a name="api-multipart-list-parts-examples"></a>

### 範例：列出分段上傳的部分
<a name="api-multipart-list-parts-examples-one"></a>

以下範例列出了上傳的所有部分。此範例將 HTTP `GET` 請求傳送到正在進行的分段上傳的特定分段上傳 ID 的 URI，最多可傳回 1,000 個部分。

#### 範例請求
<a name="api-multipart-list-parts-example-request"></a>

```
1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```

#### 回應範例
<a name="api-multipart-list-parts-example-response"></a>

在回應中，Amazon Glacier 會傳回與指定分段上傳 ID 相關聯的上傳組件清單。在這個範例中，只有兩個部分。傳回的 `Marker` 欄位是 `null`，表示沒有更多部分的分段上傳。

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:00:00 GMT
 4. Content-Type: application/json
 5. Content-Length: 412
 6.       
 7. {
 8.     "ArchiveDescription" : "archive description",
 9.     "CreationDate" : "2012-03-20T17:03:43.221Z",
10.     "Marker": null,
11.     "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
12.     "PartSizeInBytes" : 4194304,
13.     "Parts" : 
14.     [ {
15.       "RangeInBytes" : "0-4194303",
16.       "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
17.       },
18.       {
19.       "RangeInBytes" : "4194304-8388607",
20.       "SHA256TreeHash" : "0195875365afda349fc21c84c099987164"
21.       }],
22.     "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
23. }
```

### 範例：列出分段上傳的部分 (指定標記和限制請求參數)
<a name="api-multipart-list-parts-examples-two"></a>

以下範例示範如何使用分頁來取得有限數量的結果。此範例將 HTTP `GET` 請求傳送到正在進行的分段上傳的特定分段上傳 ID 的 URI，以傳回一部分。起始 `marker` 參數指定在哪些部分上啟動部分清單。您可以從對部分清單的上一個請求的回應中獲取 `marker` 值。此外，在這個範例中，`limit` 參數設為 1 和傳回一個部分。請注意，`Marker` 欄位不是 `null`，表示至少還有一個要獲取的部分。

#### 範例請求
<a name="api-multipart-list-parts-example-request-two"></a>

```
1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```

#### 回應範例
<a name="api-multipart-list-parts-example-response-two"></a>

在回應中，Amazon Glacier 會傳回與指定的進行中分段上傳 ID 相關聯的上傳組件清單。

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:00:00 GMT
 4. Content-Type: text/json
 5. Content-Length: 412
 6.       
 7. {
 8.     "ArchiveDescription" : "archive description 1",
 9.     "CreationDate" : "2012-03-20T17:03:43.221Z",
10.     "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ",
11.     "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
12.     "PartSizeInBytes" : 4194304,
13.     "Parts" : 
14.     [ {
15.       "RangeInBytes" : "4194304-8388607",
16.       "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
17.       }],
18.     "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
19. }
```

## 相關章節
<a name="related-sections-api-multipart-list-parts"></a>

 
+ [啟動分段上傳 (POST 分段 - 上傳)](api-multipart-initiate-upload.md)
+ [分段上傳 (PUT uploadID)](api-upload-part.md)
+ [完成分段上傳 (POST uploadID)](api-multipart-complete-upload.md)
+ [中止分段上傳 (DELETE uploadID)](api-multipart-abort-upload.md)
+ [列出分段上傳 (GET 分段 - 上傳)](api-multipart-list-uploads.md)
+ [上傳分段中的大型封存 (分段上傳)](uploading-archive-mpu.md)
+ [Amazon Glacier 的 Identity and Access Management](security-iam.md)

# 列出分段上傳 (GET 分段 - 上傳)
<a name="api-multipart-list-uploads"></a>

## Description
<a name="api-multipart-list-uploads-description"></a>

這個分段上傳操作列出了用於指定的文件庫的進行中分段上傳。進行中的分段上傳是已由 [啟動分段上傳 (POST 分段 - 上傳)](api-multipart-initiate-upload.md) 請求啟動，但尚未完成或停止的分段上傳。「列出分段上傳」回應中傳回的清單中，並沒有保證順序。

「列出分段上傳」操作支援分頁。在預設情況下，在回應中這項操作會傳回最多 50 個分段上傳。您應該經常檢查回應內文 `marker` 欄位中註明可繼續列表的標記，如果沒有其他項目，`marker` 欄位為 `null`。

如果 `marker` 不是 null，若要擷取下一組分段上傳，請傳送另一個「列出分段上傳」請求，並將 `marker` 請求參數設定為 Amazon Glacier (Amazon Glacier) 傳回的標記值，以回應先前的「列出分段上傳」請求。

請注意這個操作和 [清單部分 (GET uploadID)](api-multipart-list-parts.md) 操作之間的不同。「列出分段上傳」操作列出了文件庫的所有分段上傳。「列出分段」操作會傳回上傳 ID 識別之特定分段上傳部分。

如需有關分段上傳的資訊，請參閱[上傳分段中的大型封存 (分段上傳)](uploading-archive-mpu.md)。

## 要求
<a name="api-multipart-list-uploads-requests"></a>

### 語法
<a name="api-multipart-list-uploads-requests-syntax"></a>

若要列出段上傳，可將 `GET` 請求傳送到文件庫的 `multipart-uploads` 子資源的 URI。您可以選擇指定 `marker` 和 `limit` 參數。

```
1. GET /AccountId/vaults/VaultName/multipart-uploads HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```

 

**注意**  
`AccountId` 值是擁有保存庫的帳戶 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選擇性指定單一 '`-`' （連字號），在這種情況下，Amazon Glacier 會使用與用來簽署請求之登入資料相關聯的 AWS 帳戶 ID。如果您使用帳號 ID，請勿在 ID 中包含任何連字號 ('-')。

### 請求參數
<a name="api-multipart-list-uploads-requests-parameters"></a>


|  名稱  |  描述  |  必要  | 
| --- | --- | --- | 
|  limit  |  指定回應內文中傳回的上傳數量上限。如果未指定，「列出上傳」操作會傳回最多 50 個上傳。 類型：字串 限制：最小整數值為 `1`。最大整數值為 `50`。  |  否 | 
| marker  |  用於分頁的不透明字串。`marker` 指定上傳清單應開始的上傳部分。從之前的「列出上傳」回應中取得 `marker` 值。如果您要繼續對之前的「列出上傳」請求中開始的結果進行分頁，則只需包含 `marker`。 類型：字串 限制條件：無  |  否  | 

### 請求標頭
<a name="api-multipart-list-uploads-requests-headers"></a>

此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊，請參閱 [常見回應標頭](api-common-response-headers.md)。

### 請求主體
<a name="api-multipart-list-uploads-requests-elements"></a>

此操作沒有請求內文。

## 回應
<a name="api-multipart-list-uploads-responses"></a>

### 語法
<a name="api-multipart-list-uploads-responses-syntax"></a>

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: x-amzn-RequestId
 3. Date: Date
 4. Content-Type: application/json
 5. Content-Length: Length
 6. 
 7. {
 8.   "Marker": String,
 9.   "UploadsList" : [ 
10.     {
11.       "ArchiveDescription": String,
12.       "CreationDate": String,
13.       "MultipartUploadId": String,
14.       "PartSizeInBytes": Number,
15.       "VaultARN": String
16.     }, 
17.    ...
18.   ]
19. }
```

### 回應標頭
<a name="api-multipart-list-uploads-responses-headers"></a>

此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊，請參閱 [常見回應標頭](api-common-response-headers.md)。

### 回應內文
<a name="api-multipart-list-uploads-responses-elements"></a>

回應內文包含以下 JSON 欄位。

**ArchiveDescription**  
在啟動分段上傳請求中指定的封存說明。如果在啟動分段上傳操作中未指定封存說明，則此欄位為 `null`。  
*類型：*字串

**CreationDate**  
啟動分段上傳的 UTC 時間。  
*類型*：字串 ISO 8601 日期格式的字串表示法，例如，`2013-03-20T17:03:43.221Z`。

**Marker**  
一個不透明字串，表示繼續結果分頁之處。您在新的「列出分段上傳」請求中使用 `marker` 來取得清單中的更多上傳。如果沒有更多的上傳，則此值為 `null`。  
*類型：*字串

**PartSizeInBytes**  
[啟動分段上傳 (POST 分段 - 上傳)](api-multipart-initiate-upload.md) 請求中指定的分段大小。這是在上傳的所有部分的大小，除了最後一個分段外，其可能小於此大小。  
*類型*：數字

**MultipartUploadId**  
分段上傳的 ID。  
*類型：*字串

**UploadsList **  
關於分段上傳物件的中繼資料清單。清單中的每一個項目包含一組用於對應上傳的名稱值的配對，包括 `ArchiveDescription` `CreationDate`、`MultipartUploadId`、`PartSizeInBytes` 和 `VaultARN`。  
*類型*：陣列

**VaultARN**  
文件庫的 Amazon Resource Name (ARN)，其中包含存檔。  
*類型：*字串

### 錯誤
<a name="api-multipart-list-uploads-responses-errors"></a>

如需 Amazon Glacier 例外狀況和錯誤訊息的相關資訊，請參閱 [錯誤回應](api-error-responses.md)。

## 範例
<a name="api-multipart-list-uploads-examples"></a>

### 範例：列出所有分段上傳
<a name="api-multipart-list-uploads-examples-one"></a>

以下範例列出文件庫所有進行中的分段上傳。範例對指定之文件庫的 `GET` 子資源的 URI 顯示 HTTP `multipart-uploads` 請求。由於在請求中未指定 `marker` 和 `limit` 參數，因此傳回最多 1,000 個進行中分段上傳。

#### 範例請求
<a name="api-multipart-list-uploads-example-request"></a>

```
1. GET /-/vaults/examplevault/multipart-uploads HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```

#### 回應範例
<a name="api-multipart-list-uploads-example-response"></a>

在回應中，Amazon Glacier 會傳回指定保存庫的所有進行中分段上傳的清單。`marker` 欄位為 `null`，其表示沒有其他上傳可列出。

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:00:00 GMT
 4. Content-Type: application/json
 5. Content-Length: 1054
 6.       
 7. {
 8.   "Marker": null, 
 9.   "UploadsList": [ 
10.     {
11.       "ArchiveDescription": "archive 1",
12.       "CreationDate": "2012-03-19T23:20:59.130Z",
13.       "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev",
14.       "PartSizeInBytes": 4194304,
15.       "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
16.     }, 
17.     {
18.       "ArchiveDescription": "archive 2",
19.       "CreationDate": "2012-04-01T15:00:00.000Z",
20.       "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
21.       "PartSizeInBytes": 4194304,
22.       "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
23.     },
24.     {
25.       "ArchiveDescription": "archive 3",
26.       "CreationDate": "2012-03-20T17:03:43.221Z",
27.       "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
28.       "PartSizeInBytes": 4194304,
29.       "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
30.     } 
31.   ]
32. }
```

### 範例：部分列出分段上傳
<a name="api-multipart-list-uploads-examples-two"></a>

以下範例示範如何使用分頁來取得有限數量的結果。範例對指定之文件庫的 `GET` 子資源的 URI 顯示 HTTP `multipart-uploads` 請求。在這個範例中，`limit` 參數設為 1，其表示只傳回清單中一個上傳，而 `marker` 參數指出傳回清單開始進行的分段上傳 ID。

#### 範例請求
<a name="api-multipart-list-uploads-example-request-two"></a>

```
1. GET /-/vaults/examplevault/multipart-uploads?limit=1&marker=xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```

#### 回應範例
<a name="api-multipart-list-uploads-example-response-two"></a>

在回應中，Amazon Glacier (Amazon Glacier) 會傳回指定保存庫不超過兩個進行中分段上傳的清單，從指定的標記開始，並傳回兩個結果。

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:00:00 GMT
 4. Content-Type: application/json
 5. Content-Length: 470
 6. 
 7. {
 8.   "Marker": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
 9.   "UploadsList" : [ 
10.     {
11.       "ArchiveDescription": "archive 2",
12.       "CreationDate": "2012-04-01T15:00:00.000Z",
13.       "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
14.       "PartSizeInBytes": 4194304,
15.       "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
16.     }
17.   ]
18. }
```

## 相關章節
<a name="related-sections-multipart-list-uploads"></a>

 
+ [啟動分段上傳 (POST 分段 - 上傳)](api-multipart-initiate-upload.md)
+ [分段上傳 (PUT uploadID)](api-upload-part.md)
+ [完成分段上傳 (POST uploadID)](api-multipart-complete-upload.md)
+ [中止分段上傳 (DELETE uploadID)](api-multipart-abort-upload.md)
+ [清單部分 (GET uploadID)](api-multipart-list-parts.md)
+ [上傳分段中的大型封存 (分段上傳)](uploading-archive-mpu.md)
+ [Amazon Glacier 的 Identity and Access Management](security-iam.md)

# 分段上傳 (PUT uploadID)
<a name="api-upload-part"></a>

## 說明
<a name="api-job-get-description"></a>

這個分段上傳操作會上傳封存的一部分。您可以任何順序上傳封存部分，因為在您的分段上傳請求中您指定將在部分中上傳之整合封存的位元組範圍。您也可以平行上傳這些部分。您可以上傳多達 10,000 個部分的分段上傳。

如需有關分段上傳的資訊，請參閱[上傳分段中的大型封存 (分段上傳)](uploading-archive-mpu.md)。

 

如果以下任何條件成立，Amazon Glacier (Amazon Glacier) 會拒絕您的上傳組件請求：

 
+ **SHA256 樹雜湊不相符：**為確保部分資料不會在傳輸時毀損，您運算該部分的 SHA256 樹雜湊並將其包含在請求中。收到組件資料時，Amazon Glacier 也會計算 SHA256 樹雜湊。如果兩個雜湊值不相符，操作就會失敗。如需有關運算 SHA256 樹雜湊的資訊，請參閱 [運算檢查總和](checksum-calculations.md)。
+ **SHA256 線性雜湊不相符：**由於授權需要，您運算整個上傳承載的 SHA256 線性雜湊，並將其包含在請求中。如需有關運算 SHA256 線性雜湊的資訊，請參閱[運算檢查總和](checksum-calculations.md)。
+ **部分大小不相符：**每個部分 (最後部分除外) 的大小，必須符合在對應的 [啟動分段上傳 (POST 分段 - 上傳)](api-multipart-initiate-upload.md) 請求中所指定的大小。最後分段的大小必須與指定的大小相同或小於指定的大小。
**注意**  
如果您所上傳分段的大小小於在起始分段上傳請求中所指定的分段大小，而且該分段不是最後一個分段，則上傳分段請求將會成功。不過，後續的「完成分段上傳」請求將會失敗。
+ **範圍不符合：**請求中的位元組範圍值，不符合對應的起始請求中所指定的部分大小。例如，如果您指定 4194304 位元組 (4 MB) 的分段大小，則 0 到 4194303 位元組 (4 MB -1) 和 4194304 (4 MB) 到 8388607 (8 MB -1) 是有效的分段範圍。不過，如果您設定範圍值為 2 MB 到 6 MB，範圍就不符合分段大小且上傳將會失敗。

此為等冪操作。如果您多次上傳相同的分段，最新請求中所包含的資料會覆寫之前上傳的資料。

## 請求
<a name="api-job-get-requests"></a>

您傳送此 HTTP `PUT` 請求至由您起始分段上傳請求所傳回的上傳 ID 的 URI。Amazon Glacier 使用上傳 ID 將分段上傳與特定分段上傳建立關聯。請求必須包含分段資料的 SHA256 樹雜湊 (`x-amz-SHA256-tree-hash` 標頭)、整個承載的 SHA256 線性雜湊 (`x-amz-content-sha256` 標頭)、位元組範圍 (`Content-Range` 標頭)，以及以位元組表示的分段長度 (`Content-Length` 標頭)。

### 語法
<a name="api-job-get-requests-syntax"></a>

```
 1. PUT /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
 2. Host: glacier.Region.amazonaws.com
 3. Date: Date
 4. Authorization: SignatureValue
 5. Content-Range: ContentRange
 6. Content-Length: PayloadSize
 7. Content-Type: application/octet-stream
 8. x-amz-sha256-tree-hash: Checksum of the part
 9. x-amz-content-sha256: Checksum of the entire payload			
10. x-amz-glacier-version: 2012-06-01
```

 

**注意**  
`AccountId` 值是擁有保存庫的帳戶 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選擇性地指定單一 '`-`' （連字號），在這種情況下，Amazon Glacier 會使用與用來簽署請求之登入資料相關聯的 AWS 帳戶 ID。如果您使用帳號 ID，請勿在 ID 中包含任何連字號 ('-')。

### 請求參數
<a name="api-upload-part-requests-parameters"></a>

此操作不使用請求參數。

### 請求標頭
<a name="api-upload-part-requests-headers"></a>

除了所有作業通用的請求標頭之外，此作業還會使用下列請求標頭。如需常見請求標頭的資訊，請參閱[常見請求標題](api-common-request-headers.md)。


|  名稱  |  描述  |  必要  | 
| --- | --- | --- | 
| Content-Length  |  識別以位元組表示的分段長度。 類型：字串 預設：無 限制條件：無  |  否 | 
| Content-Range  |  識別在此分段將上傳之整合封存的位元組範圍。Amazon Glacier 會使用此資訊以適當的順序組合封存。此標頭的格式遵循 [ RFC 2616](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16)。範例標頭為 `Content-Range:bytes 0-4194303/*`。 類型：字串 預設：無 限制條件：範圍不得大於您在起始分段上傳時所指定的分段大小。  |  是 | 
|  x-amz-content-sha256  |  所上傳承載的 SHA256 檢查總和 (線性雜湊)。這與您在 `x-amz-sha256-tree-hash` 標頭中指定的值不同。 類型：字串 預設：無 限制條件：無  |  是 | 
|  x-amz-sha256-tree-hash​  |  指定將上傳之資料的 SHA256 樹雜湊。如需有關運算 SHA256 樹雜湊的資訊，請參閱 [運算檢查總和](checksum-calculations.md)。 類型：字串 預設：無 限制條件：無  |  是 | 

### 請求主體
<a name="api-job-get-requests-elements"></a>

 請求內文包含要上傳的資料。

## 回應
<a name="api-job-get-responses"></a>

成功上傳組件後，Amazon Glacier 會傳回`204 No Content`回應。

### 語法
<a name="api-job-get-response-syntax"></a>

```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier
```

### 回應標頭
<a name="api-job-get-responses-headers"></a>

成功的回應除了所有作業通用的回應標頭之外，還包含下列回應標頭。如需常見回應標頭的詳細資訊，請參閱[常見回應標頭](api-common-response-headers.md)。


|  名稱  |  描述  | 
| --- | --- | 
|  x-amz-sha256-tree-hash​  |  Amazon Glacier 為上傳部分計算的 SHA256 樹雜湊。 類型：字串  | 

### 回應內文
<a name="api-job-get-responses-elements"></a>

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

## 範例
<a name="api-job-get-examples"></a>

以下請求上傳 4 MB 的分段。請求會設定位元組範圍以將此成為封存的第一個分段。

### 範例請求
<a name="api-job-get-examples-sample-request"></a>

範例傳送 HTTP `PUT` 請求以上傳 4 MB 的分段。請求是傳送至由起始分段上傳請求所傳回之上傳 ID 的 URI。`Content-Range` 標頭將分段識別為封存的第一個 4 MB 資料分段。

```
1. PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Range:bytes 0-4194303/*
5. x-amz-sha256-tree-hash:c06f7cd4baacb087002a99a5f48bf953
6. x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
7. Content-Length: 4194304
8. 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
```

若要上傳下一個分段，程序是相同的；不過，您必須計算要上傳分段的新 SHA256 樹雜湊，也可以指定新的位元組範圍，以指出分段將進入最終組件的哪裡。以下請求會上傳使用相同上傳 ID 的另一個分段。請求指定之前請求之後的下一個 4 MB 封存和 4 MB 的分段大小。

```
1. PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Range:bytes 4194304-8388607/*
5. Content-Length: 4194304
6. x-amz-sha256-tree-hash:f10e02544d651e2c3ce90a4307427493
7. x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
8. x-amz-glacier-version: 2012-06-01
9. Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20120525/us-west-2/glacier/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version, Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace
```

組件可以按任何順序上傳；Amazon Glacier 會使用每個組件的範圍規格來決定組合組件的順序。

### 回應範例
<a name="api-job-get-examples-sample-response"></a>

```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. x-amz-sha256-tree-hash: c06f7cd4baacb087002a99a5f48bf953
4. Date: Wed, 10 Feb 2017 12:00:00 GMT
```

## 相關章節
<a name="related-sections-upload-part"></a>

 
+ [啟動分段上傳 (POST 分段 - 上傳)](api-multipart-initiate-upload.md)
+ [分段上傳 (PUT uploadID)](#api-upload-part)
+ [完成分段上傳 (POST uploadID)](api-multipart-complete-upload.md)
+ [中止分段上傳 (DELETE uploadID)](api-multipart-abort-upload.md)
+ [列出分段上傳 (GET 分段 - 上傳)](api-multipart-list-uploads.md)
+ [清單部分 (GET uploadID)](api-multipart-list-parts.md)
+ [上傳分段中的大型封存 (分段上傳)](uploading-archive-mpu.md)
+ [Amazon Glacier 的 Identity and Access Management](security-iam.md)