此頁面僅適用於使用 Vault 和 REST API 2012 年原始版本的 S3 Glacier 服務的現有客戶。

如果您要尋找封存儲存解決方案，建議您在 Amazon S3、S3 Glacier S3 Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 S3 Glacier 儲存類別。若要進一步了解這些儲存選項，請參閱 Amazon S3 使用者指南 中的使用 S3 Glacier 儲存類別的 S3 Glacier 儲存類別和長期資料儲存。 Amazon S3 這些儲存類別使用 Amazon S3 API，適用於所有區域，並且可以在 Amazon S3 主控台中管理。它們提供 Storage Cost Analysis、Storage Lens、進階選用加密功能等功能。

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

在 Amazon S3 Glacier 中設定文件庫通知

從 Amazon S3 Glacier 中擷取任何內容 (例如從文件庫或文件庫庫存中封存) 都是兩步驟程序。

可以在文件庫中設定通知設定，以便在任務完成後，將訊息傳送到 Amazon Simple Notification Service (Amazon SNS) 主題。

在 S3 Glacier 中設定文件庫通知：一般概念

S3 Glacier 擷取任務請求是以非同步方式執行的。您必須等到 S3 Glacier 完成任務後才能取得其輸出。您可以定期輪詢 S3 Glacier 來判斷任務狀態，但那不是最佳的方法。S3 Glacier 也支援通知。任務完成後，該任務就可將訊息張貼到 Amazon Simple Notification Service (Amazon SNS) 主題。使用此功能需要您在文件庫上設定通知設定。您可以在設定中識別一或多個事件，以及您希望 S3 Glacier 在事件發生時向其傳送訊息的 Amazon SNS 主題。

S3 Glacier 定義與任務完成 (ArchiveRetrievalCompleted、InventoryRetrievalCompleted) 具體相關的事件，您可以將其新增至文件庫的通知設定中。當特定任務完成後，S3 Glacier 會將通知訊息發布到 SNS 主題。

通知組態是 JSON 文件，如以下範例所示。

{    
   "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic",    
   "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"] 
}

請注意，您只能為文件庫設定一個 Amazon SNS 主題。

任務完成訊息 S3 Glacier 傳送包括以下資訊：任務類型 (InventoryRetrieval、ArchiveRetrieval)、任務完成狀態，SNS 主題名稱、任務狀態碼，以及文件庫 ARN。以下是 InventoryRetrieval 任務完成後，傳送到 SNS 主題的通知 S3 Glacier 範例。

{
 "Action": "InventoryRetrieval",
 "ArchiveId": null,
 "ArchiveSizeInBytes": null,
 "Completed": true,
 "CompletionDate": "2012-06-12T22:20:40.790Z",
 "CreationDate": "2012-06-12T22:20:36.814Z",
 "InventorySizeInBytes":11693,
 "JobDescription": "my retrieval job",
 "JobId":"HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID",
 "SHA256TreeHash":null,
 "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic",
 "StatusCode":"Succeeded",
 "StatusMessage": "Succeeded",
 "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
}    

如果 Completed 欄位為 true，您還必須檢查 StatusCode 來確認任務順利完成還是失敗。

如需 Amazon SNS 的詳細資訊，請參閱 Amazon SNS 入門。