**此页面仅适用于使用文件库和 2012 年原始 REST API 的 Amazon Glacier 服务的现有客户。** 如果您正在寻找归档存储解决方案，建议使用 Amazon S3 中的 Amazon Glacier 存储类别 S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive。要了解有关这些存储选项的更多信息，请参阅 [Amazon Glacier 存储类别](https://aws.amazon.com/s3/storage-classes/glacier/)。 Amazon Glacier（最初基于保管库的独立服务）不再接受新客户。Amazon Glacier 是一项独立的服务 APIs ，拥有自己的服务，可将数据存储在文件库中，不同于亚马逊 S3 和 Amazon S3 Glacier 存储类别。在 Amazon Glacier 中，您现有的数据将确保安全，并且可以无限期地访问。无需进行迁移。对于低成本、长期的存档存储， AWS 建议[使用 Amazon S3 Glacier 存储类别，这些存储类别](https://aws.amazon.com/s3/storage-classes/glacier/)基于S3存储桶 APIs、完全 AWS 区域 可用性、更低的成本和 AWS 服务集成，可提供卓越的客户体验。如果您希望加强功能，可以考虑使用我们的 [AWS 将数据从 Amazon Glacier 文件库传输到 Amazon S3 Glacier 存储类别的解决方案指南](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)，迁移到 Amazon S3 Glacier 存储类别。 本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 描述任务（GET JobID） ## 说明 此操作返回有关您之前启动的任务的信息，包括任务启动日期、启动任务的用户、任务状态代码/消息，以及要在 Amazon Glacier（Amazon Glacier）完成任务后通知的 Amazon Simple Notification Service（Amazon SNS）主题。有关启动任务的更多信息，请参阅[启动任务（POST jobs）](api-initiate-job-post.md)。 **注意** 此操作可让您检查您的任务的状态。但是，我们强烈建议您设置 Amazon SNS 主题并在您的启动任务请求中指定它，这样，Amazon Glacier 可以在完成任务后通知该主题。 Amazon Glacier 完成任务后，任务 ID 至少在 24 小时内都不会过期。 ## 请求 ### 语法 要获取有关任务的信息，您可以使用 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 jobs）](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`。 *类型*：字符串 **ArchiveId** 为选择任务或档案检索任务请求的档案 ID。否则，此字段为 `null`。 *类型*：字符串 **存档SHA256TreeHash** 档案检索任务的整个档案的 SHA256 树形哈希。对于清单检索任务，此字段为 `null`。 *类型*：字符串 **ArchiveSizeInBytes** 对于 `ArchiveRetrieval` 任务，这是正在请求下载的档案的大小（以字节为单位）。对于 `InventoryRetrieval` 任务，该值为 `null`。 *类型*：数字 **Completed** 任务状态。当档案或清单检索任务完成后，您将使用[获取任务输出（GET output）](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 jobs）](api-initiate-job-post.md)请求指定了以树形哈希对齐的范围，则此字段会返回值。有关档案范围检索的树形哈希对齐的更多信息，请参阅[下载数据时接收校验和](checksum-calculations-range.md)。 对于检索整个档案时的特定情况，此值与 `ArchiveSHA256TreeHash` 值相同。 在以下情况中，此字段为 `null`： + 指定未以树形哈希对齐的范围的档案检索任务。 + 指定等于整个档案的范围并且任务状态为 `InProgress` 的档案任务。 + 清单任务。 + 选择任务。 *类型*：字符串 **SNSTopic** 接收通知的 Amazon SNS 主题。 *类型*：字符串 **StatusCode** 指示任务状态的代码。 *有效值*：`InProgress` \$1 `Succeeded` \$1 `Failed` *类型*：字符串 **StatusMessage** 描述任务状态的友好消息。 *类型*：字符串 **Tier** 用于选择任务或档案检索任务的数据访问套餐。 *有效值*：`Bulk` \$1`Expedited` \$1`Standard` *类型*：字符串 **VaultARN** 任务为其子资源的文件库的 Amazon 资源名称（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`字段显示了 Initiate Job 请求中请求的范围的 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` 字段值为空，因为这些字段不适用于清单检索任务。 + `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 output）](api-job-output-get.md) + [适用于 Amazon Glacier 的 Identity and Access Management](security-iam.md)