**此頁面僅適用於使用 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/)
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 完成分段上傳 (POST uploadID)
## 說明
您呼叫此分段上傳操作，以通知 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。但是請注意，在分段上傳完成後，您無法呼叫清單組件操作，並且分段上傳不會出現在清單分段上傳回應中，即使冪等完整也是如此。
## 請求
若要完成分段上傳，請將 HTTP POST 請求傳送至 Amazon Glacier 為回應啟動分段上傳請求而建立的上傳 ID URI。這與上傳組件時使用的 URI 相同。除了常見的必要標頭外，還必須包括整個封存的 SHA256 樹雜湊結果和封存的總大小 (以位元組為單位)。
### 語法
```
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 中包含任何連字號 ('-')。
### 請求參數
此操作不使用請求參數。
### 請求標頭
除了所有作業通用的請求標頭之外，此作業還會使用下列請求標頭。如需常見請求標頭的資訊，請參閱[常見請求標題](api-common-request-headers.md)。
| 名稱 | 描述 | 必要 |
| --- | --- | --- |
| x-amz-archive-size | 整個封存的總大小 (以位元組為單位)。這個值應該是您上傳的個別組件的所有大小的總和。 類型：字串 預設：無 限制條件：無 | 是 |
| x-amz-sha256-tree-hash | 整個封存的 SHA256 樹雜湊。它是個別組件的 SHA256 樹雜湊的樹雜湊。如果您在請求中指定的值不符合 Amazon Glacier 計算的最終組合封存的 SHA256 樹雜湊，Amazon Glacier 會傳回錯誤，且請求會失敗。 類型：字串 預設：無 限制條件：無 | 是 |
### 要求元素
此操作不使用請求元素。
## 回應
Amazon Glacier (Amazon Glacier) 會建立整個封存的 SHA256 樹雜湊。如果值符合您在請求中指定之整個封存的 SHA256 樹雜湊，Amazon Glacier 會將封存新增至保存庫。在回應中，會傳回具有新增的封存資源的 URL 路徑的 HTTP `Location` 標頭。如果您在請求中傳送的封存大小或 SHA256 不相符，Amazon Glacier 將傳回錯誤，且上傳仍處於未完成狀態。稍後可以使用正確的值重試完整分段上傳操作，此時您可以成功建立封存。如果分段上傳未完成，最終 Amazon Glacier 將回收上傳 ID。
### 語法
```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location
x-amz-archive-id: ArchiveId
```
### 回應標頭
成功的回應除了所有作業通用的回應標頭之外，還包含下列回應標頭。如需常見回應標頭的詳細資訊，請參閱[常見回應標頭](api-common-response-headers.md)。
| 名稱 | 描述 |
| --- | --- |
| Location | 新建立的封存的相對 URI 路徑。此 URL 包含 Amazon Glacier 產生的封存 ID。 類型：字串 |
| x-amz-archive-id | 此封存的 ID。此值也包含在 `Location` 標頭中。 類型：字串 |
### 回應欄位
此作業不會傳回任何回應內文。
## 範例
### 範例請求
在這個範例中，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
```
### 回應範例
下列範例回應顯示 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 請求以擷取封存。
## 相關章節
+ [啟動分段上傳 (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)