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

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

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

提供選項來定義工作。

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

**封存**  
您想要封存的 ID。如果 `Type` 欄位設定為 `select` 或 `archive-retrieval`，則此欄位是必要的。如果為庫存擷取工作請求指定此欄位，則會發生錯誤。  
*有效值*：必須是您從先前對 Amazon Glacier (Amazon Glacier) 的請求取得的有效封存 ID。  
*類型：*字串  
*必要 *：是，當 `Type` 設定為 `select` 或 `archive-retrieval`。

**描述**  
工作的可選說明。  
* 有效值 *：描述必須小於或等於 1,024 位元組。允許的字元是沒有控制代碼的 7 位元 ASCII，尤其 ASCII 值是 32-126 十進制或 0x20-0x7E 十六進制。  
*類型：*字串  
*必要*：否

**Format (格式)**  
(選用) 輸出格式，用於啟動任務以擷取文件庫清查。如果您啟動庫存工作並未指定 `Format` 欄位，則 JSON 是預設的格式。  
*有效值*：`CSV` \| `JSON`   
*類型：*字串  
*必要*：否

**InventoryRetrievalParameters**  
用於各種庫存擷取的輸入參數。  
*類型*：[InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md)物件  
*必要*：否

**OutputLocation**  
 一個物件，其中包含有關儲存選取工作結果的位置的資訊。  
*類型*：[OutputLocation](api-OutputLocation.md)物件  
* 必要*：是，對於 `select` 工作而言。

**RetrievalByteRange**  
要為 `archive-retrieval` 擷取的位元組範圍，格式為「{{StartByteValue}}-{{EndByteValue}}」。如果不指定此欄位，則擷取整個封存。如果指定此欄位，則位元組範圍必須符合 MB (1024\* 1024)。MB - 符合表示 *StartByteValue* 必須被 1 MB 整除，並且 *EndByteValue* 加上 1 必須可被 1 MB 整除或者是指定為封存位元組大小值減去 1 的封存的結尾。如果 **RetrievalByteRange** 不符合 MB，則此操作將傳回 `400` 回應。  
如果為 `inventory-retrieval` 或 `select` 工作請求指定此欄位，則會發生錯誤。  
*類型：*字串  
*必要*：否

**SelectParameters**  
一個物件，其中包含有關用於選擇的參數的資訊。  
*類型*：[SelectParameters](api-SelectParameters.md)物件  
*必要*：否

**SNSTopic**  
Amazon Glacier 在任務完成且輸出準備好供您下載時傳送通知的 Amazon SNS 主題的 Amazon Resource Name (ARN)。 Amazon Glacier 定的主題將通知發佈到其訂閱伺服器。  
SNS 主題必須存在。如果沒有，Amazon Glacier 不會為您建立。此外，SNS 主題必須具有政策，可讓已建立工作的帳戶將訊息發佈到該主題。如需有關 SNS 主題名稱的詳細資訊，請參閱 [Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html) *API 參考* 中的 *CreateTopic*。  
*類型：*字串  
*必要*：否

**層**  
用於選擇或封存擷取工作的方案。`Standard` 是使用的預設值。  
*有效值*：`Expedited` \| `Standard` \| `Bulk`  
*類型：*字串  
*必要*：否 

**類型**  
工作類型。您可以啟動 任務，對存檔執行 select 查詢、擷取存檔或取得文件庫的清查。  
*有效值*：`select` \| `archive-retrieval` \| `inventory-retrieval`   
*類型：*字串  
*必要*：是

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