使用 在 Amazon S3 Glacier 中下載封存 AWS CLI

您可以使用 AWS Command Line Interface () 在 Amazon S3 Glacier (S3 Glacier) 中下載封存AWS CLI。

（先決條件） 設定 AWS CLI

1. 下載和設定 AWS CLI。如需相關指示，請參閱《AWS Command Line Interface 使用者指南》中的下列主題：

   安裝 AWS Command Line Interface

   設定 AWS Command Line Interface

2. 在命令提示中輸入下列命令來驗證您的 AWS CLI 設定。這些命令不會明確提供登入資料，因此會使用預設描述檔的登入資料。

   • 嘗試使用幫助命令。

     aws help

   • 若要取得已設定帳戶上 S3 Glacier 保存庫的清單，請使用 list-vaults 命令。以您的 AWS 帳戶 ID 取代 123456789012。

     aws glacier list-vaults --account-id 123456789012

   • 若要查看 目前的組態資料 AWS CLI，請使用 aws configure list命令。

     aws configure list

範例：使用 下載封存 AWS CLI

注意

為了下載封存，您必須知道封存 ID。步驟 1-4 將擷取封存 ID。如果您已經知道要下載的封存 ID，請跳至步驟 5。

1. 使用 initiate-job 命令開始庫存擷取工作。庫存報告將列出封存 ID。

   aws glacier initiate-job --vault-name awsexamplevault --account-id 111122223333 --job-parameters="{\"Type\":\"inventory-retrieval\"}"

   預期的輸出結果：

   
   {
       "location": "/111122223333/vaults/awsexamplevault/jobs/*** jobid ***", 
       "jobId": "*** jobid ***"
   }
   						

2. 使用 describe-job 命令檢查先前 工作命令的狀態。

   aws glacier describe-job --vault-name awsexamplevault --account-id 111122223333 --job-id *** jobid ***

   預期的輸出結果：

   {
       "InventoryRetrievalParameters": {
           "Format": "JSON"
       }, 
       "VaultARN": "*** vault arn ***", 
       "Completed": false, 
       "JobId": "*** jobid ***", 
       "Action": "InventoryRetrieval", 
       "CreationDate": "*** job creation date ***", 
       "StatusCode": "InProgress"
   }
   						

3. 等候 工作完成。

   您必須等到任務輸出準備好供您下載。如果您在保存庫上設定通知設定，或者在起始工作時指定 Amazon Simple Notification Service (Amazon SNS) 主題，則 S3 Glacier 會在完成工作後向該主題傳送訊息。

   您可以為文件庫中的特定事件設定通知組態。如需詳細資訊，請參閱在 Amazon S3 Glacier 中設定保存庫通知。無論何時發生特定事件，S3 Glacier 都會傳送訊息到指定的 SNS 主題。

4. 完成時，請使用 get-job-output 命令將擷取任務下載至檔案 output.json。該檔案將包含封存 ID。

   aws glacier get-job-output --vault-name awsexamplevault --account-id 111122223333 --job-id *** jobid *** output.json

   這個命令會產生一個包含下列欄位的檔案。

   
   {
   "VaultARN":"arn:aws:glacier:region:111122223333:vaults/awsexamplevault",
   "InventoryDate":"*** job completion date ***",
   "ArchiveList":[
   {"ArchiveId":"*** archiveid ***",
   "ArchiveDescription":*** archive description (if set) ***,
   "CreationDate":"*** archive creation date ***",
   "Size":"*** archive size (in bytes) ***",
   "SHA256TreeHash":"*** archive hash ***"
   }
   {"ArchiveId":
   ...
   ]}

5. 使用 initiate-job 命令，從保存庫開始每個封存的擷取程序。您將需要將工作參數指定為 archive-retrieval，如下所示。

   aws glacier initiate-job --vault-name awsexamplevault --account-id 111122223333 --job-parameters="{\"Type\":\"archive-retrieval\",\"ArchiveId\":\"*** archiveId ***\"}"

6. 等候 archive-retrieval 工作完成。使用 describe-job 命令檢查先前命令的狀態。

   aws glacier describe-job --vault-name awsexamplevault --account-id 111122223333 --job-id *** jobid ***

7. 當上述工作完成後，使用 get-job-output 命令下載封存。

   aws glacier get-job-output --vault-name awsexamplevault --account-id 111122223333 --job-id *** jobid *** output_file_name