**此頁面僅適用於使用 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/)
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 「取得任務輸出」 (GET 輸出)
## Description
此操作可下載使用 [啟動任務 (POST 任務)](api-initiate-job-post.md) 啟動的任務的輸出。根據您在啟動任務時所指定的任務類型，輸出將是存檔或文件庫清查的內容。
您可以透過指定位元組範圍來下載所有任務輸出或下載部分輸出。對於封存和庫存擷取任務，應根據**取得任務輸出**回應中的標題中傳回的大小來驗證下載的大小。
對於封存擷取任務，您還應該驗證大小是否符合預期。如果您下載部分輸出，則預期的大小取決於您指定的位元組範圍。例如，如果您指定 `bytes=0-1048575` 範圍，則應驗證下載大小為 1,048,576 位元組。如果您下載整個封存，預期的大小是上傳到 Amazon Glacier (Amazon Glacier) 時的封存大小。預期大小也會從**取得任務輸出**回應的標題中傳回。
如果是封存擷取任務，Amazon Glacier 會根據您指定的位元組範圍，傳回資料部分的檢查總和。為確保下載的部分是正確的資料，請計算用戶端上的檢查總和，驗證值是否符合，並驗證大小是否符合您所期望的。
在 Amazon Glacier 完成任務後至少 24 小時內，任務 ID 不會過期。也就是說，您可以在 Amazon Glacier 完成任務後的 24 小時內下載任務輸出。
## 要求
### 語法
若要擷取任務輸出，請將 HTTP `GET` 請求傳送到特定任務的 `output` 的 URI。
```
1. GET /AccountId/vaults/VaultName/jobs/JobID/output HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Range: ByteRangeToRetrieve
6. x-amz-glacier-version: 2012-06-01
```
**注意**
`AccountId` 值是擁有保存庫的帳戶 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選擇性地指定單一 '`-`' （連字號），在這種情況下，Amazon Glacier 會使用與用來簽署請求之登入資料相關聯的 AWS 帳戶 ID。如果您使用帳號 ID，請勿在 ID 中包含任何連字號 ('-')。
### 請求參數
此操作不使用請求參數。
### 請求標頭
除了所有作業通用的請求標頭之外，此作業還會使用下列請求標頭。如需常見請求標頭的資訊，請參閱[常見請求標題](api-common-request-headers.md)。
| 名稱 | 描述 | 必要 |
| --- | --- | --- |
| Range | 從輸出中擷取的位元組範圍。例如，如果想要下載第一個 1,048,576 位元組，請將範圍指定為 `bytes=0-1048575`。如需詳細資訊，請前往[範圍標頭欄位定義](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35)。範圍與啟動任務請求中指定的任何範圍有關。在預設情況下，這個操作下載整個輸出。 如果任務輸出很大，則您可以使用 `Range` 請求標頭來擷取輸出的一部分。這可讓您可以以較小的位元組區塊下載整個輸出。例如，假設您有 1 GB 的任務輸出要下載，並且您決定一次下載 128 MB 的資料區塊，總共有八個「取得任務輸出」請求。您將使用以下程序下載任務輸出： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/amazonglacier/latest/dev/api-job-output-get.html) 類型：字串 預設：無 限制條件：無 | 否 |
### 請求主體
此操作沒有請求內文。
## 回應
### 語法
對於傳回所有任務資料的擷取請求，任務輸出回應將傳回 `200 OK` 回應程式碼。當請求部分內容時，例如，如果您在請求中指定了 `Range` 標頭，，則會傳回回應的程式碼 `206 Partial Content`。
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. Content-Type: ContentType
5. Content-Length: Length
6. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier
7.
8. [Body containing job output.]
```
### 回應標頭
| 標頭 | Description |
| --- | --- |
| Content-Range | Amazon Glacier 傳回的位元組範圍。如果只下載部分輸出，回應會提供 Amazon Glacier 傳回的位元組範圍。 例如，`bytes 0-1048575/8388608` 從 8 MB中傳回第一個 1 MB。 如需有關 `Content-Range` 標頭的詳細資訊，請參閱[內容 - 範圍標頭欄位定義](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16)。 類型：字串 |
| Content-Type | 內容類型取決於任務輸出是存檔還是文件庫清查。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/amazonglacier/latest/dev/api-job-output-get.html) 類型：字串 |
| x-amz-sha256-tree-hash | 在回應中資料的檢查總和。只有在擷取封存擷取任務的輸出時才傳回此標頭。此外, 當啟動任務請求中請求的擷取資料範圍與樹狀雜湊符合，並且在「取得任務輸出」中下載的範圍也與樹狀雜湊符合時，會出現此標頭。如需有關樹狀雜湊符合範圍的詳細資訊，請參閱 [下載資料時接收檢查總和](checksum-calculations-range.md)。 例如，如果在啟動任務請求中指定了要擷取的樹狀雜湊符合範圍 (包括整個封存)，則在下列情況下，您將收到下載資料的檢查總和： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/amazonglacier/latest/dev/api-job-output-get.html) 類型：字串 |
### 回應內文
Amazon Glacier 會在回應內文中傳回任務輸出。根據任務類型，輸出可以是存檔內容或文件庫清查。在文件庫清查情況下，根據預設，會以下列 JSON 內文傳回清查清單。
```
1. {
2. "VaultARN": String,
3. "InventoryDate": String,
4. "ArchiveList": [
5. {"ArchiveId": String,
6. "ArchiveDescription": String,
7. "CreationDate": String,
8. "Size": Number,
9. "SHA256TreeHash": String
10. },
11. ...
12. ]
13. }
```
如果您在啟動文件庫清查任務時請求以逗號分隔值 (CSV) 輸出格式，則在內文中以 CSV 格式傳回文件庫清查。CSV 格式有五個欄「ArchiveId」、」 ArchiveDescription」、」 CreationDate」、「Size」和「SHA256TreeHash」，其定義與相應的 JSON 欄位相同。
**注意**
在傳回的 CSV 格式中，欄位可能會以整個欄位用雙引號括起來。包含逗號或雙引號的欄位一律以雙引號括起來。例如，`my archive description,1` 做為 `"my archive description,1"` 傳回。在傳回的雙引號所括起的欄位中的雙引號字元，是藉由在其前面加上反斜線字元*逸出*。例如，`my archive description,1"2` 做為 `"my archive description,1\"2"` 傳回，`my archive description,1\"2` 做為 `"my archive description,1\\"2"` 傳回。反斜線字元不會逸出。
JSON 回應內文包含以下 JSON 欄位。
**ArchiveDescription**
封存的說明。
*類型：*字串
**封存**
封存的 ID。
*類型：*字串
**ArchiveList**
封存中繼資料的陣列。陣列中的每個物件表示文件庫中包含的一個存檔的中繼資料。
*類型*：陣列
**CreationDate**
建立封存的 UTC 日期和時間。
*類型*：ISO 8601 日期格式的字串表示法，例如，`2013-03-20T17:03:43.221Z`。
**InventoryDate**
在文件庫變更後完成的文件庫的最後清查的 UTC 日期和時間。即使 Amazon Glacier 每天準備一次保存庫庫存，只有在自上次庫存以來保存庫有存檔新增或刪除時，才會更新庫存日期。
*類型*：ISO 8601 日期格式的字串表示法，例如，`2013-03-20T17:03:43.221Z`。
**SHA256TreeHash**
封存的樹狀雜湊。
*類型：*字串
**大小**
封存的大小 (位元組)。
*類型*：數字
**VaultARN**
請求封存擷取的 Amazon Resource Name (ARN) 資源。
*類型：*字串
### 錯誤
如需 Amazon Glacier 例外狀況和錯誤訊息的相關資訊，請參閱 [錯誤回應](api-error-responses.md)。
## 範例
以下範例顯示對擷取封存的任務的請求。
### 範例 1：下載輸出
此範例會擷取 Amazon Glacier 為回應啟動封存擷取任務請求而準備的資料。
#### 範例請求
```
1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output 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
```
#### 回應範例
以下是封存擷取作業的範例回應。請注意，`Content-Type` 標頭是 `application/octet-stream`，並且 `x-amz-sha256-tree-hash` 標頭包含在回應中，這表示傳回所有任務資料。
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
4. Date: Wed, 10 Feb 2017 12:00:00 GMT
5. Content-Type: application/octet-stream
6. Content-Length: 1048576
7.
8. [Archive data.]
```
以下是庫存擷取任務的範例回應。請注意，`Content-Type` 標頭是 `application/json`。另請注意，回應不包含 `x-amz-sha256-tree-hash` 標頭。
```
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: 906
6.
7. {
8. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
9. "InventoryDate": "2011-12-12T14:19:01Z",
10. "ArchiveList": [
11. {
12. "ArchiveId": "DMTmICA2n5Tdqq5BV2z7og-A20xnpAPKt3UXwWxdWsn_D6auTUrW6kwy5Qyj9xd1MCE1mBYvMQ63LWaT8yTMzMaCxB_9VBWrW4Jw4zsvg5kehAPDVKcppUD1X7b24JukOr4mMAq-oA",
13. "ArchiveDescription": "my archive1",
14. "CreationDate": "2012-05-15T17:19:46.700Z",
15. "Size": 2140123,
16. "SHA256TreeHash": "6b9d4cf8697bd3af6aa1b590a0b27b337da5b18988dbcc619a3e608a554a1e62"
17. },
18. {
19. "ArchiveId": "2lHzwhKhgF2JHyvCS-ZRuF08IQLuyB4265Hs3AXj9MoAIhz7tbXAvcFeHusgU_hViO1WeCBe0N5lsYYHRyZ7rrmRkNRuYrXUs_sjl2K8ume_7mKO_0i7C-uHE1oHqaW9d37pabXrSA",
20. "ArchiveDescription": "my archive2",
21. "CreationDate": "2012-05-15T17:21:39.339Z",
22. "Size": 2140123,
23. "SHA256TreeHash": "7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3"
24. }
25. ]
26. }
```
### 範例 2：僅下載部分輸出
此範例只會擷取 Amazon Glacier 為回應啟動封存擷取任務請求而準備的一部分封存。請求使用可選的 `Range` 標頭只擷取前 1,024 位元組。
#### 範例請求
```
1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. Range: bytes=0-1023
5. x-amz-glacier-version: 2012-06-01
6. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```
#### 回應範例
以下成功回應顯示 `206 Partial Content` 回應。在此情況下，回應也包含一個`Content-Range`標頭，指定 Amazon Glacier 傳回的位元組範圍。
```
1. HTTP/1.1 206 Partial Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Range: bytes 0-1023/8388608
5. Content-Type: application/octet-stream
6. Content-Length: 1024
7.
8. [Archive data.]
```
## 相關章節
+ [描述任務 (GET JobID)](api-describe-job-get.md)
+ [啟動任務 (POST 任務)](api-initiate-job-post.md)
+ [Amazon Glacier 的 Identity and Access Management](security-iam.md)