在 Amazon Glacier 中設定保存庫通知 - Amazon Glacier
一般概念

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

如果您要尋找封存儲存解決方案，建議您在 Amazon Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 Amazon Glacier 儲存類別。 Amazon S3 若要進一步了解這些儲存選項，請參閱 Amazon Glacier 儲存類別。

自 2025 年 12 月 15 日起，Amazon Glacier （原始獨立保存庫型服務） 將不再接受新客戶，不會影響現有客戶。Amazon Glacier 是一項獨立服務，具有自己的 APIs，可將資料存放在保存庫中，並與 Amazon S3 和 Amazon S3 Glacier 儲存類別不同。您現有的資料將在 Amazon Glacier 中無限期保持安全且可存取。不需要遷移。對於低成本、長期的封存儲存， AWS 建議採用 Amazon S3 Glacier 儲存類別，透過 S3 儲存貯體型 APIs、完整 AWS 區域 可用性、降低成本 AWS 和服務整合，提供卓越的客戶體驗。如果您想要增強功能，請考慮使用我們的解決方案指南，將資料從 Amazon S3 Glacier 保存庫傳輸至 Amazon S3 Glacier 儲存類別，以遷移至 Amazon S3 Glacier 儲存類別。 AWS Amazon Glacier Amazon S3

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

在 Amazon Glacier 中設定保存庫通知

從 Amazon Glacier 擷取任何內容，例如從保存庫或保存庫庫存封存，都是兩個步驟。

  1. 啟動擷取任務。

  2. 工作完成後，下載工作輸出。

可以在保存庫中設定通知設定，以便在工作完成後，將訊息傳送到 Amazon Simple Notification Service (Amazon SNS) 主題。

主題

在 Amazon Glacier 中設定保存庫通知：一般概念

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

Amazon Glacier 會定義與任務完成 (ArchiveRetrievalCompleted、InventoryRetrievalCompleted) 特別相關的事件，您可以將這些事件新增至保存庫的通知組態。特定任務完成後，Amazon Glacier 會將通知訊息發佈至 SNS 主題。

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

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

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

注意

將通知組態新增至保存庫會導致 Amazon Glacier 每次發生通知組態中指定的事件時傳送通知。您還可以選擇在每個工作啟動請求中指定 Amazon SNS 主題。如果您在保存庫上新增通知組態，並在啟動任務請求中指定 Amazon SNS 主題，Amazon Glacier 會傳送這兩個通知。

Amazon Glacier 傳送的任務完成訊息包含諸如任務類型 (InventoryRetrieval、ArchiveRetrieval)、任務完成狀態、SNS 主題名稱、任務狀態碼和保存庫 ARN 等資訊。以下是 Amazon Glacier 在完成InventoryRetrieval任務後傳送至 SNS 主題的範例通知。

{
 "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 主題擁有者可以向該主題發布訊息。不過，如果 Amazon SNS 主題和保存庫是由不同的 擁有 AWS 帳戶，則您必須設定 Amazon SNS 主題以接受保存庫中的發佈。您可以在 Amazon SNS 主控台設定 Amazon SNS 主題政策。

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