此頁面僅適用於使用文件庫的 S3 Glacier 服務的現有客戶，並且是 2012 年RESTAPI起的原始客戶。
如果您正在尋找存檔儲存解決方案，我們建議您使用 Amazon S3 中的 S3 Glacier 儲存類別、S3 冰川即時擷取、S3 冰川彈性擷取和 S3 Glacier Deep Archive。若要進一步了解這些儲存選項，請參閱 Amazon S3 使用者指南中的 S3 Glacier 儲存類
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
jobParameters
提供選項來定義工作。
目錄
- 封存
-
您想要封存的 ID。如果
Type欄位設定為select或archive-retrieval，則此欄位是必要的。如果為庫存擷取工作請求指定此欄位，則會發生錯誤。有效值：必須是從之前向 Amazon S3 Glacier (S3 Glacier) 請求取得的有效封存 ID。
類型：字串
必要 ：是，當
Type設定為select或archive-retrieval。 - 描述
-
工作的可選說明。
有效值 ：描述必須小於或等於 1,024 位元組。允許的字元是沒有控制代碼的 7 位元 ASCII，尤其 ASCII 值是 32-126 十進制或 0x20-0x7E 十六進制。
類型：字串
必要：否
- Format (格式)
-
(選用) 輸出格式，用於啟動任務以擷取文件庫清查。如果您啟動庫存工作並未指定
Format欄位，則 JSON 是預設的格式。有效值：
CSV|JSON類型：字串
必要：否
- InventoryRetrievalParameters
-
用於各種庫存擷取的輸入參數。
類型：InventoryRetrievalJobInput物件
必要：否
- OutputLocation
-
一個物件，其中包含有關儲存選取工作結果的位置的資訊。
類型：OutputLocation物件
必要：是，對於
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物件
必要：否
- SNSTopic
-
Amazon SNS 主題的 Amazon Resource Name (ARN)，任務完成時，S3 Glacier 會傳送通知，並且輸出可供您下載。定的主題將通知發佈到其訂閱伺服器。
SNS 主題必須存在。如果沒有，S3 Glacier 不會為您建立輸出。此外，SNS 主題必須具有政策，可讓已建立工作的帳戶將訊息發佈到該主題。如需有關 SNS 主題名稱的詳細資訊，請參閱 Amazon Simple Notification Service API 參考 中的 CreateTopic。
類型：字串
必要：否
- 層
-
用於選擇或封存擷取工作的方案。
Standard是使用的預設值。有效值：
Expedited|Standard|Bulk類型：字串
必要：否
- 類型
-
工作類型。您可以啟動 任務，對存檔執行 select 查詢、擷取存檔或取得文件庫的清查。
有效值：
select|archive-retrieval|inventory-retrieval類型：字串
必要：是
詳細資訊
