**此頁面僅適用於使用 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/) 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 任務操作 以下是 Amazon Glacier 中可用的任務操作。 **Topics** + [描述任務 (GET JobID)](api-describe-job-get.md) + [「取得任務輸出」 (GET 輸出)](api-job-output-get.md) + [啟動任務 (POST 任務)](api-initiate-job-post.md) + [列出工作 (GET 工作)](api-jobs-get.md) # 描述任務 (GET JobID) ## Description 此操作會傳回您先前啟動之任務的相關資訊，包括任務啟動日期、啟動任務的使用者、任務狀態碼/訊息，以及在 Amazon Glacier (Amazon SNS) 主題。 Amazon Glacier 如需有關啟動任務的詳細資訊，請參閱 [啟動任務 (POST 任務)](api-initiate-job-post.md)。 **注意** 此操作可讓您檢查任務的狀態。不過，我們強烈建議您設定 Amazon SNS 主題，並在啟動任務請求中指定該主題，以便 Amazon Glacier 可以在完成任務後通知該主題。 在 Amazon Glacier 完成任務後至少 24 小時內，任務 ID 不會過期。 ## 要求 ### 語法 若要取得有關任務時的資訊，可以使用 HTTP `GET` 方法，並將請求範圍限定於特定任務。請注意，相對 URI 路徑與 Amazon Glacier 在您啟動任務時傳回的路徑相同。 ``` 1. GET /AccountID/vaults/VaultName/jobs/JobID 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 中包含任何連字號 ('-')。 **注意** 在請求中，如果您省略 `JobID`，該回應將傳回在指定文件庫上的所有作用中任務的清單。如需有關列出任務的詳細資訊，請參閱 [列出工作 (GET 工作)](api-jobs-get.md)。 ### 請求參數 此操作不使用請求參數。 ### 請求標頭 此操作僅使用所有操作常見的請求標頭。如需常見請求標頭的資訊，請參閱 [常見請求標題](api-common-request-headers.md)。 ### 請求主體 此操作沒有請求內文。 ## 回應 ### 語法 ``` HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: Length { "Action": "string", "ArchiveId": "string", "ArchiveSHA256TreeHash": "string", "ArchiveSizeInBytes": number, "Completed": boolean, "CompletionDate": "string", "CreationDate": "string", "InventoryRetrievalParameters": { "EndDate": "string", "Format": "string", "Limit": "string", "Marker": "string", "StartDate": "string" }, "InventorySizeInBytes": number, "JobDescription": "string", "JobId": "string", "JobOutputPath": "string", "OutputLocation": { "S3": { "AccessControlList": [ { "Grantee": { "DisplayName": "string", "EmailAddress": "string", "ID": "string", "Type": "string", "URI": "string" }, "Permission": "string" } ], "BucketName": "string", "CannedACL": "string", "Encryption": { "EncryptionType": "string", "KMSContext": "string", "KMSKeyId": "string" }, "Prefix": "string", "StorageClass": "string", "Tagging": { "string": "string" }, "UserMetadata": { "string": "string" } } }, "RetrievalByteRange": "string", "SelectParameters": { "Expression": "string", "ExpressionType": "string", "InputSerialization": { "csv": { "Comments": "string", "FieldDelimiter": "string", "FileHeaderInfo": "string", "QuoteCharacter": "string", "QuoteEscapeCharacter": "string", "RecordDelimiter": "string" } }, "OutputSerialization": { "csv": { "FieldDelimiter": "string", "QuoteCharacter": "string", "QuoteEscapeCharacter": "string", "QuoteFields": "string", "RecordDelimiter": "string" } } }, "SHA256TreeHash": "string", "SNSTopic": "string", "StatusCode": "string", "StatusMessage": "string", "Tier": "string", "VaultARN": "string" } ``` ### 回應標頭 此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊，請參閱 [常見回應標頭](api-common-response-headers.md)。 ### 回應內文 回應內文包含以下 JSON 欄位。 **Action** 工作類型。它是 `ArchiveRetrieval`、`InventoryRetrieval` 或 `Select`。 *類型：*字串 **封存** 針對選擇或封存擷取任務請求的封存 ID。否則，此欄位為 `null`。 *類型：*字串 **ArchiveSHA256TreeHash** 用於封存任務的整個封存的 SHA256 樹狀雜湊。對於庫存擷取作業，此欄位為 `null`。 *類型：*字串 **ArchiveSizeInBytes** 對於 `ArchiveRetrieval` 任務，這是請求下載的封存的大小，以位元組為單位。對於 `InventoryRetrieval` 任務，值為 `null`。 *類型*：數字 **已完成** 工作狀態。當封存或庫存擷取任務完成後，您可以使用 [「取得任務輸出」 (GET 輸出)](api-job-output-get.md) 獲取任務的輸出。 *類型*：布林值 **CompletionDate** 任務請求完成的國際標準時間 (UTC) 的時間。當任務正在進行時，該值為空。 *類型：*字串 **CreationDate** 建立任務所需的 UTC 時間。 *類型*：ISO 8601 日期格式的字串表示法，例如，`2013-03-20T17:03:43.221Z`。 **InventoryRetrievalParameters** 用於各種庫存擷取的輸入參數。 *類型*：[InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md)物件 **InventorySizeInBytes** 對於 `InventoryRetrieval` 任務，這是請求下載的庫存的大小，以位元組為單位。對於 `ArchiveRetrieval` 或 `Select` 任務，值為 `null`。 *類型*：數字 **JobDescription** 當您啟動的任務所提供的任務說明。 *類型：*字串 **JobId** 在 Amazon Glacier 中識別任務的 ID。 *類型：*字串 **JobOutputPath** 包含任務輸出位置。 *類型：*字串 **OutputLocation** 一個物件，其中包含有關儲存選取任務結果和錯誤的位置的資訊。 *類型*：[OutputLocation](api-OutputLocation.md)物件 **RetrievalByteRange** 用於封存擷取任務的擷取位元組範圍，格式為「*StartByteValue*-*EndByteValue*。」 如果封存擷取中沒有指定範圍, 則擷取整個封存，也就 *StartByteValue* 等於 0，而 *EndByteValue* 等於封存的大小減去 1。對於庫存擷取或選擇作業，此欄位為 `null`。 *類型：*字串 **SelectParameters** 一個物件，其中包含有關用於選擇的參數的資訊。 *類型*：[SelectParameters](api-SelectParameters.md)物件 **SHA256TreeHash** 所請求的封存範圍的 SHA256 樹狀雜湊值。如果對封存的 [啟動任務 (POST 任務)](api-initiate-job-post.md) 請求指定了樹狀雜湊值的範圍，則此欄位會傳回一個值。如需關於封存範圍擷取的樹狀雜湊值的詳細資訊，請參閱 [下載資料時接收檢查總和](checksum-calculations-range.md)。 對於擷取整個封存的特定案例，此值與 `ArchiveSHA256TreeHash` 值相同。 此欄位在以下情況下為 `null`： + 封存擷取任務所指定的範圍不符合樹狀雜湊。 + 指定與整個封存和任務狀態相等的範圍的封存任務是 `InProgress`。 + 庫存任務 + 選取任務。 *類型：*字串 **SNSTopic** 接收通知的 Amazon SNS 主題。 *類型：*字串 **StatusCode** 表示任務狀態的代碼。 *有效值*：`InProgress` \$1 `Succeeded` \$1 `Failed` *類型：*字串 **StatusMessage** 描述任務狀態的友善訊息。 *類型：*字串 **層** 用於選擇或封存擷取的資料存方案。 *有效值*：`Bulk` \$1 `Expedited` \$1 `Standard` *類型：*字串 **VaultARN** 該任務是子資源的文件庫 Amazon Resource Name (ARN)。 *類型：*字串 ### 錯誤 如需 Amazon Glacier 例外狀況和錯誤訊息的相關資訊，請參閱 [錯誤回應](api-error-responses.md)。 ## 範例 以下範例顯示對擷取封存的任務的請求。 ### 範例請求：取得任務描述 ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 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 ``` ### 回應範例 回應內文包含描述指定任務的 JSON。請注意，對於庫存擷取和封存擷取任務，JSON 欄位是相同的。但是，當欄位不適用於任務類型時，其值為 `null`。以下是封存擷取作業的範例回應。注意下列事項： + `Action`欄位值為 `ArchiveRetrieval`。 + `ArchiveSizeInBytes` 欄位會顯示在封存擷取作業中請求的封存大小。 + `ArchiveSHA256TreeHash` 欄位顯示整個封存的 SHA256 樹狀雜湊。 + `RetrievalByteRange` 欄位顯示在啟動任務請求中請求的範圍。在這個範例中，請求整個封存。 + `SHA256TreeHash` 欄位顯示在啟動任務請求中請求的範圍的 SHA256 樹狀雜湊。在這個範例中，它與 `ArchiveSHA256TreeHash` 欄位相同，這表示請求整個封存。 + 此 `InventorySizeInBytes` 欄位值為 `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: 419 6. { 7. "Action": "ArchiveRetrieval", 8. "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", 9. "ArchiveSizeInBytes": 16777216, 10. "ArchiveSHA256TreeHash": "beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60", 11. "Completed": false, 12. "CompletionDate": null, 13. "CreationDate": "2012-05-15T17:21:39.339Z", 14. "InventorySizeInBytes": null, 15. "JobDescription": "My ArchiveRetrieval Job", 16. "JobId": "HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID", 17. "RetrievalByteRange": "0-16777215", 18. "SHA256TreeHash": "beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60", 19. "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic", 20. "StatusCode": "InProgress", 21. "StatusMessage": "Operation in progress.", 22. "Tier": "Bulk", 23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 24. } ``` 以下是庫存擷取任務的範例回應。注意下列事項： + `Action`欄位值為 `InventoryRetrieval`。 + `ArchiveSizeInBytes`、`ArchiveSHA256TreeHash` 和 `RetrievalByteRange` 欄位值為 null，因為這些欄位不適用於庫存擷取任務。 + `InventorySizeInBytes` 欄位值是 `null` ，因為該任務仍在進行中，而且要下載的庫存尚未完全準備好。如果任務在描述任務請求之前完成，則此欄位將給出輸出的大小。 ``` { "Action": "InventoryRetrieval", "ArchiveId": null, "ArchiveSizeInBytes": null, "ArchiveSHA256TreeHash": null, "Completed": false, "CompletionDate": null, "CreationDate": "2012-05-15T23:18:13.224Z", "InventorySizeInBytes": null, "JobDescription": "Inventory Description", "JobId": "HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID", "RetrievalByteRange": null, "SHA256TreeHash": null, "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic", "StatusCode": "InProgress", "StatusMessage": "Operation in progress.", "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" } ``` 以下是已完成的清查擷取任務的範例回應，其中包含用來持續對文件庫清查擷取進行分頁的標記。 ``` { "Action": "InventoryRetrieval", "ArchiveId": null, "ArchiveSHA256TreeHash": null, "ArchiveSizeInBytes": null, "Completed": true, "CompletionDate": "2013-12-05T21:51:13.591Z", "CreationDate": "2013-12-05T21:51:12.281Z", "InventorySizeInBytes": 777062, "JobDescription": null, "JobId": "sCC2RZNBF2nildYD_roe0J9bHRdPQUbDRkmTdg-mXi2u3lc49uW6TcEhDF2D9pB2phx-BN30JaBru7PMyOlfXHdStzu8", "NextInventoryRetrievalMarker": null, "RetrievalByteRange": null, "SHA256TreeHash": null, "SNSTopic": null, "StatusCode": "Succeeded", "StatusMessage": "Succeeded", "Tier": "Bulk", "VaultARN": "arn:aws:glacier-devo:us-west-2:836579025725:vaults/inventory-icecube-2", "InventoryRetrievalParameters": { "StartDate": "2013-11-12T13:43:12Z", "EndDate": "2013-11-20T08:12:45Z", "Limit": "120000", "Format": "JSON", "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" }, } ``` ## 相關章節 + [「取得任務輸出」 (GET 輸出)](api-job-output-get.md) + [Amazon Glacier 的 Identity and Access Management](security-iam.md) # 「取得任務輸出」 (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) # 啟動任務 (POST 任務) 此操作會啟動下列類型的 Amazon Glacier (Amazon Glacier) 任務： + `archive-retrieval`：擷取封存 + `inventory-retrieval`：清點保存庫 **Topics** + [初始化封存或保存庫庫存擷取工作](#api-initiate-job-post-description) + [要求](#api-initiate-job-post-requests) + [回應](#api-initiate-job-post-responses) + [範例](#api-initiate-job-post-examples) + [相關章節](#more-info-api-initiate-job-post) ## 初始化封存或保存庫庫存擷取工作 擷取封存或保存庫庫存是非同步作業，需要您啟動工作。一旦啟動，就無法取消任務。擷取是兩個步驟： 1. 使用 [啟動任務 (POST 任務)](#api-initiate-job-post) 操作啟動擷取任務。 **重要** 資料擷取政策可能導致啟動擷取作業請求失敗，並出現 `PolicyEnforcedException`。如需有關資料擷取政策的詳細資訊，請參閱 [Amazon Glacier 資料擷取政策](data-retrieval-policy.md)。如需 `PolicyEnforcedException` 例外狀況的詳細資訊，請參閱 [錯誤回應](api-error-responses.md)。 1. 任務完成後，使用 [「取得任務輸出」 (GET 輸出)](api-job-output-get.md) 操作下載位元組。 以非同步方式執行擷取請求。當您起始檢索任務時，Amazon Glacier 會建立任務，並在回應中傳回任務 ID。當 Amazon Glacier 完成任務時，您可以取得任務輸出 （封存或庫存資料）。如需有關取得任務輸出的詳細資訊，請參閱 [「取得任務輸出」 (GET 輸出)](api-job-output-get.md) 操作。 必須完成任務，才能取得其輸出。若要判斷任務何時完成，您有下列選項： + **使用 Amazon SNS 通知 —** 您可以指定 Amazon Glacier 可以在任務完成後發佈通知的 Amazon SNS 主題。 Amazon Glacier 您可以為每個任務請求指定一個 SNS 主題。只有在 Amazon Glacier 完成任務後，才會傳送通知。除了指定每個工作請求的 SNS 主題外，還可以為保存庫設定保存庫通知，以便為所有擷取傳送工作通知。如需詳細資訊，請參閱[設定保存庫通知組態 (PUT 通知的組態)](api-vault-notifications-put.md)。 + **取得工作詳細資訊：**工作進行中時，您可以提出 [描述任務 (GET JobID)](api-describe-job-get.md) 請求以取得工作狀態資訊。但是，使用 Amazon SNS 通知來判斷工作何時完成會更有效率。 **注意** 您透過通知取得的資訊，與您呼叫 [描述任務 (GET JobID)](api-describe-job-get.md) 所取得的資訊相同。 如果針對特定事件，您可以在保存庫上新增通知組態，並在啟動任務請求中指定 SNS 主題，Amazon Glacier 會傳送這兩個通知。如需詳細資訊，請參閱[設定保存庫通知組態 (PUT 通知的組態)](api-vault-notifications-put.md)。 ### 此保存庫庫存 Amazon Glacier 大約每天更新一次保存庫庫存，從您第一次將封存上傳至保存庫的那一天開始。如果從上次清查以來，沒有新增或刪除文件庫的存檔，則清查日期不會更新。當您啟動保存庫庫存的任務時，Amazon Glacier 會傳回其產生的最後一個庫存，這是point-in-time快照，而不是即時資料。 Amazon Glacier 為保存庫建立第一個庫存後，通常需要半天到一天的時間才能擷取該庫存。 您可能沒有發現為每個存檔上傳擷取文件庫清查的好處。不過，假設您在用戶端維護資料庫，關聯您上傳到 Amazon Glacier 之封存的相關中繼資料。然後，您可能會發現文件庫清查的好處，可以視需要在資料庫中使用實際的文件庫清查來調節資訊。如需有關庫存任務輸出中傳回的資料欄位的詳細資訊，請參閱 [回應內文](api-job-output-get.md#api-job-output-get-responses-elements)。 ### 庫存擷取範圍 您可以透過篩選在保存庫建立日期或設定限制來限制擷取到的保存庫庫存項目的數量。 **透過封存建立日期進行篩選** 您可以透過在**啟動工作**請求中指定這些參數的值，來擷取在 `StartDate` 和 `EndDate` 之間建立之封存的庫存項目。在 `StartDate` 之時或之後，以及 `EndDate` 之前所建立的封存被傳回。如果您只提供沒有 `StartDate` 的 `EndDate` ，則擷取 `StartDate` 或之後建立的所有封存的庫存。如果您只提供 `EndDate` 而沒有 `StartDate`，則擷取 `EndDate` 之時或之後所建立的所有封存的庫存。 **限制每個擷取的庫存項目** 您可以透過在**啟動工作**請求中設定 `Limit` 參數，來限制傳回的庫存項目數量。庫存任務輸出包含達到指定 `Limit` 的庫存項目。如果有更多的庫存項目可用，則結果會進行分頁。在任務完成後，您可以使用 [描述任務 (GET JobID)](api-describe-job-get.md) 操作來取得您在後續的**啟動任務**請求中使用的標記。標記指示要擷取下一組庫存項目的起點。您可以透過使用之前**描述工作**輸出中的標記重複建立**啟動工作**請求來瀏覽整個庫存。這樣做一直到您從**描述任務**取得傳回空標記，表示沒有更多的庫存項目可用。 您可以將 `Limit` 參數與日期範圍參數一起使用。 ### 遠端封存擷取 您可以為整個封存或封存範圍啟動封存擷取。在遠端封存擷取的情況下，指定要傳回的位元組範圍或整個封存。指定的範圍必須符合百萬位元組 (MB)。換言之，範圍起始值必須可被 1 MB 整除，並且範圍結束值加上 1 必須可整除 1 MB 或等於封存的結束。如果遠端封存擷取不符合 MB，則此操作將傳回 `400` 回應。此外，為了確保使用**取得任務輸** ([「取得任務輸出」 (GET 輸出)](api-job-output-get.md)) 下載的資料取得檢查總和值，該範圍必須必須符合樹狀雜湊。如需有關樹狀雜湊符合範圍的詳細資訊，請參閱 [下載資料時接收檢查總和](checksum-calculations-range.md)。 ### 急件、標準和大量方案 當啟動封存擷取工作時，可以在請求內文的 `Tier` 欄位中指定下列選項之一： + **`Expedited`**：當您偶爾需要緊急要求還原封存時，急件讓您快速存取資料。對於幾乎最大型的封存 (250 MB 以上)，使用急件方案所存取的資料，通常會在 1-5 分鐘內即可使用。 + **`Standard`**：讓您能以標準方案在幾小時內存取任何封存。使用標準方案存取的資料通常 3 -5 小時內可用。若未指定方案選項，這會是任務請求的預設選項。 + **`Bulk`** – 大量是 Amazon Glacier 成本最低的方案，可讓您在一天內以經濟實惠的價格擷取大量資料，甚至 PB。使用大量方案存取的資料通常 5 -12 小時內可用。 如需有關急件和大量擷取的詳細資訊，請參閱 [擷取 Amazon Glacier Archives](downloading-an-archive-two-steps.md)。 ## 要求 要啟動作業，您可以使用 HTTP `POST` 方法的請求，並將請求範圍擴大到保存庫的 `jobs` 子資源。您可以在請求的 JSON 文件中指定任務請求的詳細資訊。任務類型是由 `Type` 欄位指定的。或者，您可以指定 `SNSTopic` 欄位，以指示 Amazon Glacier 在完成任務後可發佈通知的 Amazon SNS 主題。 Amazon Glacier **注意** 若要將通知發佈到 Amazon SNS，如果主題尚不存在，您必須自行建立該主題。Amazon Glacier 不會為您建立主題。主題必須具有從 Amazon Glacier 保存庫接收出版物的許可。Amazon Glacier 不會驗證保存庫是否具有發佈至主題的許可。如果未設定適當的權限，即使任務完成後，您也可能不會收到通知。 ### 語法 以下是啟動任務的請求語法。 ``` 1. POST /AccountId/vaults/VaultName/jobs HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. x-amz-glacier-version: 2012-06-01 6. 7. { 8. "jobParameters": { 9. "ArchiveId": "string", 10. "Description": "string", 11. "Format": "string", 12. "InventoryRetrievalParameters": { 13. "EndDate": "string", 14. "Limit": "string", 15. "Marker": "string", 16. "StartDate": "string" 17. }, 18. "OutputLocation": { 19. "S3": { 20. "AccessControlList": [ 21. { 22. "Grantee": { 23. "DisplayName": "string", 24. "EmailAddress": "string", 25. "ID": "string", 26. "Type": "string", 27. "URI": "string" 28. }, 29. "Permission": "string" 30. } 31. ], 32. "BucketName": "string", 33. "CannedACL": "string", 34. "Encryption": { 35. "EncryptionType": "string", 36. "KMSContext": "string", 37. "KMSKeyId": "string" 38. }, 39. "Prefix": "string", 40. "StorageClass": "string", 41. "Tagging": { 42. "string" : "string" 43. }, 44. "UserMetadata": { 45. "string" : "string" 46. } 47. } 48. }, 49. "RetrievalByteRange": "string", 50. "SelectParameters": { 51. "Expression": "string", 52. "ExpressionType": "string", 53. "InputSerialization": { 54. "csv": { 55. "Comments": "string", 56. "FieldDelimiter": "string", 57. "FileHeaderInfo": "string", 58. "QuoteCharacter": "string", 59. "QuoteEscapeCharacter": "string", 60. "RecordDelimiter": "string" 61. } 62. }, 63. "OutputSerialization": { 64. "csv": { 65. "FieldDelimiter": "string", 66. "QuoteCharacter": "string", 67. "QuoteEscapeCharacter": "string", 68. "QuoteFields": "string", 69. "RecordDelimiter": "string" 70. } 71. } 72. }, 73. "SNSTopic": "string", 74. "Tier": "string", 75. "Type": "string" 76. } 77. } ``` **注意** `AccountId` 值是擁有保存庫的帳戶 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選擇性指定單一 '`-`' （連字號），在這種情況下，Amazon Glacier 會使用與用來簽署請求之登入資料相關聯的 AWS 帳戶 ID。如果您使用帳號 ID，請勿在 ID 中包含任何連字號 ('-')。 ### 請求主體 該請求接受請求內文中的 JSON 格式的以下資料。 jobParameters 提供指定任務資訊的選項。 *類型*：[jobParameters](api-jobParameters.md)物件 *必要*：是 ## 回應 Amazon Glacier 會建立任務。在回應中，它會傳回任務的 URI。 ### 語法 ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Location: location 5. x-amz-job-id: jobId 6. x-amz-job-output-path: jobOutputPath ``` ### 回應標頭 | 標頭 | Description | | --- | --- | | Location | 任務的相對 URI 路徑。您可以使用此 URI 路徑來尋找任務狀態。如需詳細資訊，請參閱[描述任務 (GET JobID)](api-describe-job-get.md)。 類型：字串 預設：無 | | x-amz-job-id | 任務的 ID。此值也包含在 `Location` 標頭中。 類型：字串 預設：無 | | x-amz-job-output-path | 儲存選取結果的位置的路徑。 類型：字串 預設：無 | ### 回應內文 此作業不會傳回任何回應內文。 ### 錯誤 除了所有 Amazon Glacier 操作常見的可能錯誤之外，此操作還包含下列錯誤。如需 Amazon Glacier 錯誤的資訊和錯誤代碼清單，請參閱 [錯誤回應](api-error-responses.md)。 | Code | Description | HTTP 狀態碼 | Type | | --- | --- | --- | --- | | InsufficientCapacityException | 如果沒有足夠的能力處理此急件請求，則退回。此錯誤僅適用於急件擷取，而不適用於標準或大量擷取。 | 503 Service Unavailable | Server | ## 範例 ### 範例請求：啟動封存擷取任務 ``` 1. POST /-/vaults/examplevault/jobs 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 6. 7. { 8. "Type": "archive-retrieval", 9. "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", 10. "Description": "My archive description", 11. "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-ArchiveRetrieval-topic-Example", 12. "Tier" : "Bulk" 13. } ``` 以下是一個請求內文的範例，該請求指定各種封存擷取使用 `RetrievalByteRange` 欄位。 ``` { "Type": "archive-retrieval", "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", "Description": "My archive description", "RetrievalByteRange": "2097152-4194303", "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-ArchiveRetrieval-topic-Example", "Tier" : "Bulk" } ``` ### 回應範例 ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID ``` ### 範例請求：啟動庫存擷取任務 以下請求將啟動一個庫存擷取工作，以便從 `examplevault` 保存庫中取得封存清單。在請求內文中的 `Format` 設為 `CSV` 表示庫存以 CSV 格式傳回。 ``` 1. POST /-/vaults/examplevault/jobs HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. Content-Type: application/x-www-form-urlencoded 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 7. 8. { 9. "Type": "inventory-retrieval", 10. "Description": "My inventory job", 11. "Format": "CSV", 12. "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-InventoryRetrieval-topic-Example" 13. } ``` ### 回應範例 ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID ``` ### 範例請求：通過使用一組限制的日期篩選和後續請求來擷取庫存項目的下一頁，啟動庫存擷取任務。 以下請求透過使用日期篩選和設定限制來啟動保存庫庫存擷取工作。 ``` 1. { 2. "ArchiveId": null, 3. "Description": null, 4. "Format": "CSV", 5. "RetrievalByteRange": null, 6. "SNSTopic": null, 7. "Type": "inventory-retrieval", 8. "InventoryRetrievalParameters": { 9. "StartDate": "2013-12-04T21:25:42Z", 10. "EndDate": "2013-12-05T21:25:42Z", 11. "Limit" : "10000" 12. }, 13. } ``` 以下的請求範例，後續請求使用來自 [描述任務 (GET JobID)](api-describe-job-get.md) 所取得的標記來擷取庫存項目的下一頁。 ``` 1. { 2. "ArchiveId": null, 3. "Description": null, 4. "Format": "CSV", 5. "RetrievalByteRange": null, 6. "SNSTopic": null, 7. "Type": "inventory-retrieval", 8. "InventoryRetrievalParameters": { 9. "StartDate": "2013-12-04T21:25:42Z", 10. "EndDate": "2013-12-05T21:25:42Z", 11. "Limit": "10000", 12. "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" 13. }, 14. } ``` ### 回應範例 ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 6. x-amz-job-output-path: test/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/ ``` ## 相關章節 + [描述任務 (GET JobID)](api-describe-job-get.md) + [「取得任務輸出」 (GET 輸出)](api-job-output-get.md) + [Amazon Glacier 的 Identity and Access Management](security-iam.md) # 列出工作 (GET 工作) ## Description 此操作列出文件庫的任務，包括正在進行的任務和最近完成的任務。 **注意** Amazon Glacier (Amazon Glacier) 會在刪除任務之前保留最近完成的任務一段時間；不過，最終會移除已完成的任務。可以擷取完成工作的輸出。在完成工作後，工作將保留一段時間，可使您可以在錯過工作完成通知的情況下取得工作輸出，否則您第一次嘗試下載工作時會失敗。例如，假設您啟動封存擷取工作以下載封存。工作完成後，您開始下載封存，但發生網路錯誤。在此案例中，您可以在工作存在時重試並下載封存。 `List Jobs` 操作支援分頁。您應該隨時檢查回應 `Marker` 欄位。如果沒有更多的工作要列出，`Marker` 欄位設定為 `null`。如果要列出更多工作，`Marker` 欄位將設定為非空值，您可以使用該值來繼續清單的分頁。若要傳回從特定工作開始的工作清單，請將 `marker` 請求參數設定為從之前的 `Marker` 請求取得的工作的 `List Jobs` 值。 您可以透過在請求中指定 `limit` 參數來設定回應中傳回的工作數量的最大限制。預設限制為 50。傳回的工作數可能少於限制，但傳回的工作數永遠不會超過限制。 此外，還可以透過指定選用的 `statuscode` 參數或 `completed` 參數或兩者來篩選傳回的工作清單。使用 `statuscode` 參數，可以指定僅返回與 `InProgress`、`Succeeded` 或 `Failed` 狀態符合的工作。使用 `completed` 參數，您可以指定只傳回已完成的 (`true`) 的工作或未完成的 (`false`) 的工作。 ## 要求 ### 語法 要傳回所有類型的任務清單, 請將 `GET` 請求傳送到文件庫的 `jobs` 子資源的 URI。 ``` 1. GET /AccountId/vaults/VaultName/jobs 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 中包含任何連字號 ('-')。 ### 請求參數 | 名稱 | 描述 | 必要 | | --- | --- | --- | | completed | 要傳回的工作狀態。您可指定為 `true` 或 `false`。 類型：布林值 限制條件：無 | 否 | | limit | 所要傳回的工作數量上限。預設限制為 50。傳回的工作數可能少於指定的限制，但傳回的工作數永遠不會超過限制。 類型：字串 限制：最小整數值為 1。最大整數值為 50。 | 否 | | marker | 用於分頁的不透明字串，用於指定工作清單應開始的工作。您可以從之前的 `marker` 回應中取得 `List Jobs` 值。如果您要繼續分析在之前的 `marker` 請求中啟動的結果，則只需包含 `List Jobs`。 類型：字串 限制條件：無 | 否 | | statuscode | 傳回的工作狀態類型。 類型：字串 限制：`InProgress`、`Succeeded` 或 `Failed` 的其中一個值。 | 否 | ### 請求標頭 此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊，請參閱 [常見回應標頭](api-common-response-headers.md)。 ### 請求主體 此操作沒有請求內文。 ## 回應 ### 語法 ``` HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Location: Location Content-Type: application/json Content-Length: Length { "JobList": [ { "Action": "string", "ArchiveId": "string", "ArchiveSHA256TreeHash": "string", "ArchiveSizeInBytes": number, "Completed": boolean, "CompletionDate": "string", "CreationDate": "string", "InventoryRetrievalParameters": { "EndDate": "string", "Format": "string", "Limit": "string", "Marker": "string", "StartDate": "string" }, "InventorySizeInBytes": number, "JobDescription": "string", "JobId": "string", "JobOutputPath": "string", "OutputLocation": { "S3": { "AccessControlList": [ { "Grantee": { "DisplayName": "string", "EmailAddress": "string", "ID": "string", "Type": "string", "URI": "string" }, "Permission": "string" } ], "BucketName": "string", "CannedACL": "string", "Encryption": { "EncryptionType": "string", "KMSContext": "string", "KMSKeyId": "string" }, "Prefix": "string", "StorageClass": "string", "Tagging": { "string": "string" }, "UserMetadata": { "string": "string" } } }, "RetrievalByteRange": "string", "SelectParameters": { "Expression": "string", "ExpressionType": "string", "InputSerialization": { "csv": { "Comments": "string", "FieldDelimiter": "string", "FileHeaderInfo": "string", "QuoteCharacter": "string", "QuoteEscapeCharacter": "string", "RecordDelimiter": "string" } }, "OutputSerialization": { "csv": { "FieldDelimiter": "string", "QuoteCharacter": "string", "QuoteEscapeCharacter": "string", "QuoteFields": "string", "RecordDelimiter": "string" } } }, "SHA256TreeHash": "string", "SNSTopic": "string", "StatusCode": "string", "StatusMessage": "string", "Tier": "string", "VaultARN": "string" } ], "Marker": "string" } ``` ### 回應標頭 此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊，請參閱 [常見回應標頭](api-common-response-headers.md)。 ### 回應內文 回應內文包含以下 JSON 欄位。 **JobList** 工作物件的清單。每個工作物件包含描述工作的中繼資料。 *類型*：[GlacierJobDescription](api-GlacierJobDescription.md) 物件陣列 **Marker** 一個不透明字串，表示繼續結果分頁之處。您可以在新的 `marker` 請求中使用 ` List Jobs` 值來取得清單中的更多工作。如果沒有更多的工作列出，則此值為 `null`。 *類型：*字串 ### 錯誤 如需 Amazon Glacier 例外狀況和錯誤訊息的相關資訊，請參閱 [錯誤回應](api-error-responses.md)。 ## 範例 以下範例示範如何傳回有關文件庫任務的資訊。第一個範例傳回兩個工作清單，第二個範例傳回部分工作。 ### 範例：傳回所有工作 #### 範例請求 以下 `GET` 請求傳回文件庫的任務。 ``` 1. GET /-/vaults/examplevault/jobs 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 ``` #### 回應範例 以下回應包括存檔擷取任務和清查擷取任務，其中包含用來持續對文件庫清查擷取進行分頁的標記。回應還會顯示 `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: 1444 6. 7. { 8. "JobList": [ 9. { 10. "Action": "ArchiveRetrieval", 11. "ArchiveId": "BDfaUQul0dVzYwAMr8YSa_6_8abbhZq-i1oT69g8ByClfJyBgAGBkWl2QbF5os851P7Y7KdZDOHWJIn4rh1ZHaOYD3MgFhK_g0oDPesW34uHQoVGwoIqubf6BgUEfQm_wrU4Jlm3cA", 12. "ArchiveSizeInBytes": 1048576, 13. "ArchiveSHA256TreeHash": "25499381569ab2f85e1fd0eb93c5406a178ab77c5933056eb5d6e7d4adda609b", 14. "Completed": true, 15. "CompletionDate": "2012-05-01T00:00:09.304Z", 16. "CreationDate": "2012-05-01T00:00:06.663Z", 17. "InventorySizeInBytes": null, 18. "JobDescription": null, 19. "JobId": "hDe9t9DTHXqFw8sBGpLQQOmIM0-JrGtu1O_YFKLnzQ64548qJc667BRWTwBLZC76Ygy1jHYruqXkdcAhRsh0hYv4eVRU", 20. "RetrievalByteRange": "0-1048575", 21. "SHA256TreeHash": "25499381569ab2f85e1fd0eb93c5406a178ab77c5933056eb5d6e7d4adda609b", 22. "SNSTopic": null, 23. "StatusCode": "Succeeded", 24. "StatusMessage": "Succeeded", 25. "Tier": "Bulk", 26. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 27. }, 28. { 29. "Action": "InventoryRetrieval", 30. "ArchiveId": null, 31. "ArchiveSizeInBytes": null, 32. "ArchiveSHA256TreeHash": null, 33. "Completed": true, 34. "CompletionDate": "2013-05-11T00:25:18.831Z", 35. "CreationDate": "2013-05-11T00:25:14.981Z", 36. "InventorySizeInBytes": 1988, 37. "JobDescription": null, 38. "JobId": "2cvVOnBL36btzyP3pobwIceiaJebM1bx9vZOOUtmNAr0KaVZ4WkWgVjiPldJ73VU7imlm0pnZriBVBebnqaAcirZq_C5", 39. "RetrievalByteRange": null, 40. "SHA256TreeHash": null, 41. "SNSTopic": null, 42. "StatusCode": "Succeeded", 43. "StatusMessage": "Succeeded", 44. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 45. "InventoryRetrievalParameters": { 46. "StartDate": "2013-11-12T13:43:12Z", 47. "EndDate": "2013-11-20T08:12:45Z", 48. "Limit": "120000", 49. "Format": "JSON", 50. "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" 51. } 52. ], 53. "Marker": null 54. } ``` ### 範例：回傳工作的局部清單 #### 範例請求 以下 `GET` 請求傳回由 `marker` 參數指定的工作。將 `limit` 參數設定為 `2` 以指定最多傳回兩個工作。 ``` 1. GET /-/vaults/examplevault/jobs?marker=HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID&limit=2 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 ``` #### 回應範例 以下回應顯示傳回的兩個工作，`Marker` 欄位設定為非空值，可用來繼續工作清單的分頁。 ``` 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: 1744 6. 7. { 8. "JobList": [ 9. { 10. "Action": "ArchiveRetrieval", 11. "ArchiveId": "58-3KpZfcMPUznvMZNPaKyJx9wODCsWTnqcjtx2CjKZ6b-XgxEuA8yvZOYTPQfd7gWR4GRm2XR08gcnWbLV4VPV_kDWtZJKi0TFhKKVPzwrZnA4-FXuIBfViYUIVveeiBE51FO4bvg", 12. "ArchiveSizeInBytes": 8388608, 13. "ArchiveSHA256TreeHash": "106086b256ddf0fedf3d9e72f461d5983a2566247ebe7e1949246bc61359b4f4", 14. "Completed": true, 15. "CompletionDate": "2012-05-01T00:25:20.043Z", 16. "CreationDate": "2012-05-01T00:25:16.344Z", 17. "InventorySizeInBytes": null, 18. "JobDescription": "aaabbbccc", 19. "JobId": "s4MvaNHIh6mOa1f8iY4ioG2921SDPihXxh3Kv0FBX-JbNPctpRvE4c2_BifuhdGLqEhGBNGeB6Ub-JMunR9JoVa8y1hQ", 20. "RetrievalByteRange": "0-8388607", 21. "SHA256TreeHash": "106086b256ddf0fedf3d9e72f461d5983a2566247ebe7e1949246bc61359b4f4", 22. "SNSTopic": null, 23. "StatusCode": "Succeeded", 24. "StatusMessage": "Succeeded", 25. "Tier": "Bulk", 26. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 27. }, 28. { 29. "Action": "ArchiveRetrieval", 30. "ArchiveId": "2NVGpf83U6qB9M2u-Ihh61yoFLRDEoh7YLZWKBn80A2i1xG8uieBwGjAr4RkzOHA0E07ZjtI267R03Z-6Hxd8pyGQkBdciCSH1-Lw63Kx9qKpZbPCdU0uTW_WAdwF6lR6w8iSyKdvw", 31. "ArchiveSizeInBytes": 1048576, 32. "ArchiveSHA256TreeHash": "3d2ae052b2978727e0c51c0a5e32961c6a56650d1f2e4ceccab6472a5ed4a0", 33. "Completed": true, 34. "CompletionDate": "2012-05-01T16:59:48.444Z", 35. "CreationDate": "2012-05-01T16:59:42.977Z", 36. "InventorySizeInBytes": null, 37. "JobDescription": "aaabbbccc", 38. "JobId": "CQ_tf6fOR4jrJCL61Mfk6VM03oY8lmnWK93KK4gLig1UPAbZiN3UV4G_5nq4AfmJHQ_dOMLOX5k8ItFv0wCPN0oaz5dG", 39. "RetrievalByteRange": "0-1048575", 40. "SHA256TreeHash": "3d2ae052b2978727e0c51c0a5e32961c6a56650d1f2e4ceccab6472a5ed4a0", 41. "SNSTopic": null, 42. "StatusCode": "Succeeded", 43. "StatusMessage": "Succeeded", 44. "Tier": "Standard", 45. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 46. } 47. ], 48. "Marker": "CQ_tf6fOR4jrJCL61Mfk6VM03oY8lmnWK93KK4gLig1UPAbZiN3UV4G_5nq4AfmJHQ_dOMLOX5k8ItFv0wCPN0oaz5dG" 49. } ``` ## 相關章節 + [描述任務 (GET JobID)](api-describe-job-get.md) + [Amazon Glacier 的 Identity and Access Management](security-iam.md)