此頁面僅適用於使用 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
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Amazon S3 Glacier 資料模型
Amazon S3 Glacier 資料模型核心元件包括保存庫和封存。S3 Glacier 是以 REST 為基礎的 Web 服務。以 REST 而言,保存庫和封存是資源。此外,S3 Glacier 資料模型包含工作和通知設定資源。這些資源可以補足核心資源。
保存庫
在 S3 Glacier 中,保存庫是儲存封存的一種容器。保存庫類似於 Amazon S3 儲存貯體。當您建立儲存庫時,您可以指定名稱並選擇您 AWS 區域 要建立資料保險箱的位置。
每個保存庫資源都有唯一的地址。一般形式為:
https://
region-specific-endpoint
/account-id
/vaults/vault-name
例如,假設您在美國西部 (奧勒岡) 區域中,在帳戶中使用 ID 111122223333 建立保存庫 (examplevault
)。您可使用以下 URI 定址此保存庫:
https://glacier.us-west-2.amazonaws.com/111122223333/vaults/examplevault
以下是 URI 各種元件的含義:
-
glacier.us-west-2.amazonaws.com
識別美國西部 (奧勒岡) 區域。 -
111122223333
是擁有儲存庫的 AWS 帳戶 ID。 -
vaults
是指 AWS 帳戶所擁有的保存庫集合。 -
examplevault
識別保存庫集合中的特定保存庫。
AWS 帳戶 可以在任何受支援 AWS 區域的儲存庫中建立儲存庫。如需支援的清單 AWS 區域,請參閱存取 Amazon S3 Glacier。在區域內,帳戶必須使用唯一保存庫名稱。 AWS 帳戶 可以在不同的區域中建立相同名稱的儲存庫。
您可以在保存庫中存放無限數量的封存。根據您的業務或應用程式需求,您可以將這些封存存放在一個保存庫或多個保存庫。
S3 Glacier 支援各種保存庫作業。保存庫作業為區域特定。例如,當您建立保存庫時,您可以在特定區域建立。當您請求儲存庫清單時,您會從特定的資料保險箱清單中提出要求 AWS 區域,而產生的清單僅包括在該特定區域中建立的 Vault。
存檔
封存可以是任何資料,例如照片、影片或文件。封存類似於 Amazon S3 物件,並且是 S3 Glacier 中的儲存基本單位。每個封存都有唯一的 ID 以及選擇性說明。您僅可在上傳封存期間指定選擇性說明。S3 Glacier 會為歸檔指派一個 ID,該 ID 在存放歸檔 AWS 區域 中是唯一的。
每個封存都有唯一的地址。一般形式如下所示:
https://
region-specific-endpoint
/account-id
/vaults/vault-name
/archives/archive-id
以下是存放在帳戶為 111122223333 之美國西部 (奧勒岡) 區域中 examplevault
保存庫之封存的範例 URI:
https://glacier.us-west-2.amazonaws.com/111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
您可以在保存庫中存放無限數量的封存。
任務
S3 Glacier 工作可以擷取封存,或取得保存庫的庫存。
擷取封存和保存庫庫存 (封存的清單) 是 S3 Glacier 中的非同步作業,您必須先啟動工作,然後在 S3 Glacier 完成工作後才能下載工作輸出。
注意
S3 Glacier 提供冷儲存資料封存解決方案。如果您的應用程式需要儲存解決方案,需要即時擷取資料,您可以考慮使用 Amazon S3。如需詳細資訊,請參閱 Amazon Simple Storage Service (Amazon S3)
若要起始保存庫工作,您要提供保存庫名稱。封存擷取工作需要保存庫名稱和封存 ID 二者。您也可以提供選擇性任務描述,以協助識別任務。
封存擷取以及保存庫庫存工作會與保存庫相關聯。保存庫可以在任何時間點有多個進行中的工作。當您傳送工作請求 (起始工作) 時,S3 Glacier 會傳回工作 ID 以追蹤工作。每個任務都是由 URI 的形式來唯一識別:
https://
region-specific-endpoint
/account-id
/vaults/vault-name
/jobs/job-id
下列是與帳戶為 111122223333 的美國西部 (奧勒岡) 區域中 examplevault
保存庫相關聯的工作範例。
https://glacier.us-west-2.amazonaws.com/111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID
對於每個工作,S3 Glacier 會維護工作類型、描述、建立日期、完成日期和工作狀態之類的資訊。您可以取得有關特定工作的資訊,或取得與保存庫關聯的所有工作清單。S3 Glacier 傳回的工作清單包含所有進行中和最近已完成的工作。
通知組態
由於工作需要時間才能執行,所以 S3 Glacier 支援通知機制,可在工作完成時通知您。您可以設定保存庫,以在工作完成時將通知傳送到 Amazon Simple Notification Service (Amazon SNS) 主題。您可以在通知設定中每個保存庫指定 Amazon SNS 主題。
S3 Glacier 會將通知設定儲存為 JSON 文件。以下是範例保存庫通知組態:
{ "Topic": "arn:aws:sns:us-west-2:111122223333:mytopic", "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"] }
請注意,通知設定會與保存庫相關聯;每個保存庫都可以有一個設定。每個通知組態資源都是由 URI 的形式來唯一識別:
https://
region-specific-endpoint
/account-id
/vaults/vault-name
/notification-configuration
S3 Glacier 支援設定、取得和刪除通知設定的作業。在您刪除通知設定後,當保存庫上的資料擷取作業完成時不會傳送任何通知。