使用 AWS Command Line Interface 在 Amazon S3 Glacier 中下載文件庫庫存 - Amazon S3 Glacier
(必要條件) 設定 AWS CLI範例：使用 AWS CLI 下載文件庫清查

如果您不熟悉 Amazon Simple Storage Service (Amazon S3) 中的封存儲存，建議您從深入了解 Amazon S3 中的 S3 Glacier 儲存類別、S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 開始。如需詳細資訊，請參閱 Amazon S3 使用者指南中的 S3 Glacier 儲存類別和存檔物件的儲存類別。

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

使用 AWS Command Line Interface 在 Amazon S3 Glacier 中下載文件庫庫存

請遵循以下步驟，使用 AWS Command Line Interface (AWS CLI) 下載 Amazon S3 Glacier (S3 Glacier) 中的文件庫庫存。

(必要條件) 設定 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 命令。將 123456789012 替換為 AWS 帳戶 ID。

      aws glacier list-vaults --account-id 123456789012

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

      aws configure list

範例：使用 AWS CLI 下載文件庫清查

  1. 使用 initiate-job 命令啟動清查擷取任務。

    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. 等候任務完成。

    您必須等到任務輸出準備好供您下載。S3 Glacier 完成任務後，任務 ID 至少在 24 小時內不會過期。如果您在文件庫上設定通知設定，或者在起始任務時指定 Amazon Simple Notification Service (Amazon SNS) 主題，則 S3 Glacier 會在完成任務後向該主題傳送訊息。

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

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

    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":
...
]}