**此頁面僅適用於使用 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/)

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

# GlacierJobDescription
<a name="api-GlacierJobDescription"></a>

包含 Amazon Glacier (Amazon Glacier) 任務的描述。

## 目錄
<a name="api-GlacierJobDescription-contents"></a>

**Action**  
工作類型。它是 `ArchiveRetrieval`、`InventoryRetrieval` 或 `Select`。  
*類型：*字串

**封存**  
針對選擇或封存擷取任務請求的封存 ID。否則，此欄位為 `null`。  
*類型：*字串

**ArchiveSHA256TreeHash**  
用於封存擷取的整個封存的 SHA256 樹狀雜湊。對於庫存擷取作業，此欄位為 `null`。  
*類型：*字串

**ArchiveSizeInBytes**  
對於 `ArchiveRetrieval` 任務，這是請求下載的封存的大小，以位元組為單位。對於 `InventoryRetrieval` 任務，值為 `null`。  
*類型*：數字

**已完成**  
如果任務完成後，則為 `true` 否則為 `false`。  
*類型*：布林值

**CompletionDate**  
任務完成的日期。  
任務請求完成的國際標準時間 (UTC) 的時間。當任務正在進行時，該值為空。  
*類型*：ISO 8601 日期格式的字串表示法，例如，`2013-03-20T17:03:43.221Z`。

**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**  
如果在工作啟動 ([啟動任務 (POST 任務)](api-initiate-job-post.md)) 中設定了通知，則 Amazon Resource Name (ARN) 代表傳送工作完成或失敗的通知的 Amazon SNS 主題。  
*類型：*字串

**StatusCode**  
表示任務狀態的代碼。  
*有效值*：`InProgress` \| `Succeeded` \| `Failed`  
*類型：*字串

**StatusMessage**  
任務狀態訊息。  
*類型：*字串

**層**  
用於選擇或封存擷取的資料存方案。  
*有效值*：`Expedited` \| `Standard` \| `Bulk`  
*類型：*字串

**VaultARN**  
該工作是子資源的保存庫 ARN。  
*類型：*字串

## 詳細資訊
<a name="more-info-api-GlacierJobDescription"></a>
+ [啟動任務 (POST 任務)](api-initiate-job-post.md)