此頁面僅適用於使用 Vaults 和 2012 年原始 REST API 的 S3 Glacier 服務的現有客戶。
如果您要尋找封存儲存解決方案，建議您在 Amazon S3、S3 Glacier S3 Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 S3 Glacier 儲存類別。若要進一步了解這些儲存選項，請參閱《Amazon S3
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
在 Amazon S3 Glacier 中下載保存庫庫存
將第一個封存上傳到保存庫後，Amazon S3 Glacier (S3 Glacier) 會自動建立保存庫庫存，然後每天大約更新一次。S3 Glacier 建立第一個庫存後，通常需要半天到一天的時間才可以擷取庫存。您可以透過以下兩個步驟從 S3 Glacier 中擷取保存庫庫存：
-
使用 啟動任務 (POST 任務) 操作啟動庫存擷取任務。
重要
資料擷取政策可能導致啟動擷取作業請求失敗，並出現
PolicyEnforcedException例外狀況。如需有關資料擷取政策的詳細資訊，請參閱 S3 Glacier 資料擷取政策。如需PolicyEnforcedException例外狀況的詳細資訊，請參閱 錯誤回應。 -
任務完成後，使用 「取得任務輸出」 (GET 輸出) 操作下載位元組。
例如，擷取存檔或文件庫清查要求您先啟動擷取作業。以非同步方式執行工作請求。當您開始擷取工作時，S3 Glacier 會建立工作並在回應中傳回工作 ID。當 S3 Glacier 完成工作時，您可以取得工作輸出、封存位元組或保存庫庫存的資料。
必須完成任務，才能取得其輸出。若要判斷任務的狀態，您有下列選項：
-
等待任務完成通知 — 您可以指定 Amazon 簡單通知服務 (AmazonSNS) 主題，S3 Glacier 可在任務完成後張貼通知。您可以使用以下方法指定 Amazon SNS 主題：
為每個任務指定一個 Amazon SNS 主題。
啟動任務時，您可以選擇性地指定 Amazon SNS 主題。
在文件庫上設定通知組態。
您可以為保存庫中的特定事件設定通知設定 (請參閱 在 Amazon S3 Glacier 中設定文件庫通知)。S3 Glacier 會在任何特定事件發生時傳送訊息至指定的SNS主題。
如果您在保存庫上設定了通知組態，並且在啟動任務時也指定了 Amazon 主SNS題，則 S3 Glacier 會向這兩個主題傳送任務完成訊息。
您可以設定SNS主題以透過電子郵件通知您，或將訊息存放在 Amazon 簡單佇列服務 (AmazonSQS) 中，讓您的應用程式可以輪詢。當訊息出現在佇列中時，您可以檢查任務是否順利完成，然後下載任務的輸出。
-
明確地請求工作資訊：S3 Glacier 也提供描述工作作業 (描述任務 (GET JobID))，可讓您輪詢工作資訊。您可以定期發送此請求以獲取任務資訊。但是，建議您選擇使用 Amazon SNS 通知。
注意
您SNS通過通知獲得的信息與您通過調用描述 Job 獲得的信息相同。
主題
關於庫存
S3 Glacier 每天至少更新一次保管庫庫存，從您第一次上傳存檔到文件庫的那一天開始。如果從上次清查以來，沒有新增或刪除文件庫的存檔，則清查日期不會更新。當您啟動文件庫庫存的任務時，S3 Glacier 會傳回產生的最後一個庫存，這是 point-in-time 快照，而非即時資料。請注意，S3 Glacier 為保存庫建立第一個庫存後，通常需要半天到一天的時間才可以擷取庫存。
您可能沒有發現為每個存檔上傳擷取文件庫清查的好處。不過，假設您在用戶端上維護一個資料庫，該用戶端將上傳到 S3 Glacier 之封存的相關中繼資料建立關聯。然後，您可能會發現文件庫清查的好處，可以視需要在資料庫中使用實際的文件庫清查來調節資訊。您可以透過篩選存檔建立日期或設定配額來限制擷取到的清查項目數量。如需有關限制庫存擷取的詳細資訊，請參閱 庫存擷取範圍。
可以使用逗號分隔值 (CSV) 或JSON兩種格式傳回庫存。您可以選擇指定啟動庫存任務時的格式。預設格式為JSON。如需詳細目錄 Job 輸出中傳回回應內文之資料欄位的詳細資訊，請參閱取得工作輸出API。
