使用 的 S3 Glacier 範例 AWS CLI - AWS Command Line Interface

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

使用 的 S3 Glacier 範例 AWS CLI

下列程式碼範例示範如何搭配 AWS Command Line Interface S3 Glacier 使用 來執行動作和實作常見案例。

Actions 是大型程式的程式碼摘錄,必須在內容中執行。雖然動作會示範如何呼叫個別服務函數,但您可以在其相關案例中查看內容中的動作。

每個範例都包含完整原始程式碼的連結,您可以在其中找到如何在內容中設定和執行程式碼的指示。

主題

動作

下列程式碼範例示範如何使用 abort-multipart-upload

AWS CLI

下列命令會刪除正在進行的分段上傳至名為 的保存庫my-vault

aws glacier abort-multipart-upload --account-id - --vault-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ

此命令不會產生任何輸出。Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。上傳 ID 由 aws glacier initiate-multipart-upload 命令傳回,也可以透過 aws glacier list-multipart-uploads 獲取。

如需使用 將分段上傳至 Amazon Glacier 的詳細資訊 AWS CLI,請參閱 AWS CLI 使用者指南 中的使用 Amazon Glacier。

下列程式碼範例示範如何使用 abort-vault-lock

AWS CLI

若要中止進行中保存庫鎖定程序

下列abort-vault-lock範例會從指定的保存庫中刪除保存庫鎖定政策,並將保存庫鎖定的鎖定狀態重設為解除鎖定。

aws glacier abort-vault-lock \ --account-id - \ --vault-name MyVaultName

此命令不會產生輸出。

如需詳細資訊,請參閱 Amazon Glacier API開發人員指南 中的 Abort Vault Lock (DELETE lock-policy)

  • 如需API詳細資訊,請參閱 命令參考 AbortVaultLock中的 。 AWS CLI

下列程式碼範例示範如何使用 add-tags-to-vault

AWS CLI

以下命令會將兩個標籤加入名為 my-vault 的文件庫:

aws glacier add-tags-to-vault --account-id - --vault-name my-vault --tags id=1234,date=july2015

Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

  • 如需API詳細資訊,請參閱 命令參考 AddTagsToVault中的 。 AWS CLI

下列程式碼範例示範如何使用 complete-multipart-upload

AWS CLI

下列命令會完成 3 MiB 封存的分段上傳:

aws glacier complete-multipart-upload --archive-size 3145728 --checksum 9628195fcdbcbbe76cdde456d4646fa7de5f219fb39823836d81f0cc0e18aa67 --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ --account-id - --vault-name my-vault

Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

上傳 ID 由 aws glacier initiate-multipart-upload 命令傳回,也可以透過 aws glacier list-multipart-uploads 獲取。總和檢查碼參數會取得十六進位封存的 SHA-256 樹雜湊。

如需使用 將分段上傳至 Amazon Glacier 的詳細資訊 AWS CLI,包括計算樹雜湊的指示,請參閱 AWS CLI 使用者指南 中的使用 Amazon Glacier。

下列程式碼範例示範如何使用 complete-vault-lock

AWS CLI

若要完成進行中保存庫鎖定程序

下列complete-vault-lock範例會完成指定保存庫的進行中鎖定進度,並將保存庫鎖定的鎖定狀態設定為 Locked。執行 時,您會取得 lock-id 參數的值initiate-lock-process

aws glacier complete-vault-lock \ --account-id - \ --vault-name MyVaultName \ --lock-id 9QZgEXAMPLEPhvL6xEXAMPLE

此命令不會產生輸出。

如需詳細資訊,請參閱 Amazon Glacier 開發人員指南 中的完成保存庫鎖定 (POST lockId)Amazon Glacier API

下列程式碼範例示範如何使用 create-vault

AWS CLI

以下命令建立一個名為 my-vault 的文件庫:

aws glacier create-vault --vault-name my-vault --account-id -

Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

  • 如需API詳細資訊,請參閱 命令參考 CreateVault中的 。 AWS CLI

下列程式碼範例示範如何使用 delete-archive

AWS CLI

從文件庫刪除封存

下列 delete-archive 範例會從 example_vault 中移除指定的封存。

aws glacier delete-archive \ --account-id 111122223333 \ --vault-name example_vault \ --archive-id Sc0u9ZP8yaWkmh-XGlIvAVprtLhaLCGnNwNl5I5x9HqPIkX5mjc0DrId3Ln-Gi_k2HzmlIDZUz117KSdVMdMXLuFWi9PJUitxWO73edQ43eTlMWkH0pd9zVSAuV_XXZBVhKhyGhJ7w

此命令不會產生輸出。

  • 如需API詳細資訊,請參閱 命令參考 DeleteArchive中的 。 AWS CLI

下列程式碼範例示範如何使用 delete-vault-access-policy

AWS CLI

若要移除保存庫的存取政策

下列delete-vault-access-policy範例會移除指定保存庫的存取政策。

aws glacier delete-vault-access-policy \ --account-id 111122223333 \ --vault-name example_vault

此命令不會產生輸出。

下列程式碼範例示範如何使用 delete-vault-notifications

AWS CLI

若要移除保存庫的SNS通知

下列delete-vault-notifications範例會移除 Amazon Simple Notification Service (Amazon SNS) 為指定保存庫傳送的通知。

aws glacier delete-vault-notifications \ --account-id 111122223333 \ --vault-name example_vault

此命令不會產生輸出。

下列程式碼範例示範如何使用 delete-vault

AWS CLI

以下命令刪除一個名為 my-vault 的文件庫:

aws glacier delete-vault --vault-name my-vault --account-id -

此命令不會產生任何輸出。Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

  • 如需API詳細資訊,請參閱 命令參考 DeleteVault中的 。 AWS CLI

下列程式碼範例示範如何使用 describe-job

AWS CLI

以下命令會擷取文件庫上名為 my-vault 的庫存擷取工作相關資訊:

aws glacier describe-job --account-id - --vault-name my-vault --job-id zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW

輸出:

{ "InventoryRetrievalParameters": { "Format": "JSON" }, "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault", "Completed": false, "JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW", "Action": "InventoryRetrieval", "CreationDate": "2015-07-17T20:23:41.616Z", "StatusCode": "InProgress" }

工作 ID 可以在 aws glacier initiate-jobaws glacier list-jobs 的輸出中找到。Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

  • 如需API詳細資訊,請參閱 命令參考 DescribeJob中的 。 AWS CLI

下列程式碼範例示範如何使用 describe-vault

AWS CLI

以下命令會擷取名為 my-vault 的文件庫資料:

aws glacier describe-vault --vault-name my-vault --account-id -

Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

  • 如需API詳細資訊,請參閱 命令參考 DescribeVault中的 。 AWS CLI

下列程式碼範例示範如何使用 get-data-retrieval-policy

AWS CLI

下列命令會取得使用中帳戶的資料擷取政策:

aws glacier get-data-retrieval-policy --account-id -

輸出:

{ "Policy": { "Rules": [ { "BytesPerHour": 10737418240, "Strategy": "BytesPerHour" } ] } }

Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

下列程式碼範例示範如何使用 get-job-output

AWS CLI

以下命令會將文件庫庫存任務的輸出儲存到目前目錄名為 output.json 的檔案中:

aws glacier get-job-output --account-id - --vault-name my-vault --job-id zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW output.json

job-id 可在 aws glacier list-jobs 的輸出中使用。請注意,輸出檔案名稱是位置引數,不以選項名稱作為前綴。Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

輸出:

{ "status": 200, "acceptRanges": "bytes", "contentType": "application/json" }

output.json:

{"VaultARN":"arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault","InventoryDate":"2015-04-07T00:26:18Z","ArchiveList":[{"ArchiveId":"kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw","ArchiveDescription":"multipart upload test","CreationDate":"2015-04-06T22:24:34Z","Size":3145728,"SHA256TreeHash":"9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67"}]}
  • 如需API詳細資訊,請參閱 命令參考 GetJobOutput中的 。 AWS CLI

下列程式碼範例示範如何使用 get-vault-access-policy

AWS CLI

擷取保存庫的存取政策

下列get-vault-access-policy範例會擷取指定保存庫的存取政策。

aws glacier get-vault-access-policy \ --account-id 111122223333 \ --vault-name example_vault

輸出:

{ "policy": { "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:ListJobs\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"},{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:UploadArchive\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"}]}" } }

下列程式碼範例示範如何使用 get-vault-lock

AWS CLI

若要取得保存庫鎖定的詳細資訊

下列get-vault-lock範例擷取指定保存庫鎖定的詳細資訊。

aws glacier get-vault-lock \ --account-id - \ --vault-name MyVaultName

輸出:

{ "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:99999999999:vaults/MyVaultName\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}", "State": "Locked", "CreationDate": "2019-07-29T22:25:28.640Z" }

如需詳細資訊,請參閱 Amazon Glacier API開發人員指南 中的取得保存庫鎖定 (GET鎖定政策)

  • 如需API詳細資訊,請參閱 命令參考 GetVaultLock中的 。 AWS CLI

下列程式碼範例示範如何使用 get-vault-notifications

AWS CLI

以下命令會取得名為 my-vault 的文件庫通知組態描述:

aws glacier get-vault-notifications --account-id - --vault-name my-vault

輸出:

{ "vaultNotificationConfig": { "Events": [ "InventoryRetrievalCompleted", "ArchiveRetrievalCompleted" ], "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault" } }

如果尚未為文件庫設定任何通知,則會傳回錯誤。Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

下列程式碼範例示範如何使用 initiate-job

AWS CLI

下列命令會啟動任務,以取得保存庫 的庫存my-vault

aws glacier initiate-job --account-id - --vault-name my-vault --job-parameters '{"Type": "inventory-retrieval"}'

輸出:

{ "location": "/0123456789012/vaults/my-vault/jobs/zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW", "jobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW" }

Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

下列命令會啟動任務,以從保存庫擷取封存my-vault

aws glacier initiate-job --account-id - --vault-name my-vault --job-parameters file://job-archive-retrieval.json

job-archive-retrieval.json 是本機資料夾中JSON的檔案,指定任務類型、封存 ID 和一些選用參數:

{ "Type": "archive-retrieval", "ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw", "Description": "Retrieve archive on 2015-07-17", "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-topic" }

封存IDs可在 aws glacier upload-archive和 的輸出中使用aws glacier get-job-output

輸出:

{ "location": "/011685312445/vaults/mwunderl/jobs/l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav", "jobId": "l7IL5-EkXy2O5uLYaFdAYOiEY9Ws95fClzIbk-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav" }

如需任務參數格式的詳細資訊,請參閱 Amazon Glacier API參考中的啟動任務。

  • 如需API詳細資訊,請參閱 命令參考 InitiateJob中的 。 AWS CLI

下列程式碼範例示範如何使用 initiate-multipart-upload

AWS CLI

下列命令會啟動分段上傳至名為 my-vault的保存庫,每個檔案的部分大小為 1 MiB (1024 x 1024 位元組):

aws glacier initiate-multipart-upload --account-id - --part-size 1048576 --vault-name my-vault --archive-description "multipart upload test"

封存描述參數為選用。Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

此命令會在成功時輸出上傳 ID。使用 上傳封存的每個部分時,請使用上傳 IDaws glacier upload-multipart-part。如需使用 將分段上傳至 Amazon Glacier 的詳細資訊 AWS CLI,請參閱 AWS CLI 使用者指南 中的使用 Amazon Glacier。

下列程式碼範例示範如何使用 initiate-vault-lock

AWS CLI

啟動保存庫鎖定程序

下列initiate-vault-lock範例會在指定的保存庫上安裝保存庫鎖定政策,並將保存庫鎖定的鎖定狀態設定為 InProgress。您必須在 complete-vault-lock 24 小時內呼叫 以完成程序,將保存庫鎖定的狀態設定為 Locked

aws glacier initiate-vault-lock \ --account-id - \ --vault-name MyVaultName \ --policy file://vault_lock_policy.json

vault_lock_policy.json 的內容:

{"Policy":"{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}"}

輸出是保存庫鎖定 ID,可用來完成保存庫鎖定程序。

{ "lockId": "9QZgEXAMPLEPhvL6xEXAMPLE" }

如需詳細資訊,請參閱 Amazon Glacier API開發人員指南 中的啟動保存庫鎖定 (POST鎖定政策)

下列程式碼範例示範如何使用 list-jobs

AWS CLI

以下命令會列出名為 my-vault 的文件庫正在進行和最近完成之工作:

aws glacier list-jobs --account-id - --vault-name my-vault

輸出:

{ "JobList": [ { "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault", "RetrievalByteRange": "0-3145727", "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault", "Completed": false, "SHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67", "JobId": "l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav", "ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw", "JobDescription": "Retrieve archive on 2015-07-17", "ArchiveSizeInBytes": 3145728, "Action": "ArchiveRetrieval", "ArchiveSHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67", "CreationDate": "2015-07-17T21:16:13.840Z", "StatusCode": "InProgress" }, { "InventoryRetrievalParameters": { "Format": "JSON" }, "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault", "Completed": false, "JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW", "Action": "InventoryRetrieval", "CreationDate": "2015-07-17T20:23:41.616Z", "StatusCode": ""InProgress"" } ] }

Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

  • 如需API詳細資訊,請參閱 命令參考 ListJobs中的 。 AWS CLI

下列程式碼範例示範如何使用 list-multipart-uploads

AWS CLI

下列命令顯示名為 的保存庫的所有進行中分段上傳my-vault

aws glacier list-multipart-uploads --account-id - --vault-name my-vault

Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

如需使用 將分段上傳至 Amazon Glacier 的詳細資訊 AWS CLI,請參閱 AWS CLI 使用者指南 中的使用 Amazon Glacier。

下列程式碼範例示範如何使用 list-parts

AWS CLI

下列命令會列出分段上傳至名為 的保存庫的上傳部分my-vault

aws glacier list-parts --account-id - --vault-name my-vault --upload-id "SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D"

輸出:

{ "MultipartUploadId": "SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D", "Parts": [ { "RangeInBytes": "0-1048575", "SHA256TreeHash": "e1f2a7cd6e047350f69b9f8cfa60fa606fe2f02802097a9a026360a7edc1f553" }, { "RangeInBytes": "1048576-2097151", "SHA256TreeHash": "43cf3061fb95796aed99a11a6aa3cd8f839eed15e655ab0a597126210636aee6" } ], "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault", "CreationDate": "2015-07-18T00:05:23.830Z", "PartSizeInBytes": 1048576 }

Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

如需使用 將分段上傳至 Amazon Glacier 的詳細資訊 AWS CLI,請參閱 AWS CLI 使用者指南 中的使用 Amazon Glacier。

  • 如需API詳細資訊,請參閱 命令參考 ListParts中的 。 AWS CLI

下列程式碼範例示範如何使用 list-provisioned-capacity

AWS CLI

擷取佈建的容量單位

下列list-provisioned-capacity範例會擷取指定帳戶之任何佈建容量單位的詳細資訊。

aws glacier list-provisioned-capacity \ --account-id 111122223333

輸出:

{ "ProvisionedCapacityList": [ { "CapacityId": "HpASAuvfRFiVDbOjMfEIcr8K", "ExpirationDate": "2020-03-18T19:59:24.000Z", "StartDate": "2020-02-18T19:59:24.912Z" } ] }

下列程式碼範例示範如何使用 list-tags-for-vault

AWS CLI

下列命令會列出套用到 my-vault 文件庫的標籤:

aws glacier list-tags-for-vault --account-id - --vault-name my-vault

輸出:

{ "Tags": { "date": "july2015", "id": "1234" } }

Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

  • 如需API詳細資訊,請參閱 命令參考 ListTagsForVault中的 。 AWS CLI

下列程式碼範例示範如何使用 list-vaults

AWS CLI

下列命令列出預設帳戶與區域的文件庫。

aws glacier list-vaults --account-id -

輸出:

{ "VaultList": [ { "SizeInBytes": 3178496, "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault", "LastInventoryDate": "2015-04-07T00:26:19.028Z", "VaultName": "my-vault", "NumberOfArchives": 1, "CreationDate": "2015-04-06T21:23:45.708Z" } ] }

Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

  • 如需API詳細資訊,請參閱 命令參考 ListVaults中的 。 AWS CLI

下列程式碼範例示範如何使用 purchase-provisioned-capacity

AWS CLI

購買佈建容量單位

下列purchase-provisioned-capacity範例會購買佈建容量單位。

aws glacier purchase-provisioned-capacity \ --account-id 111122223333

輸出:

{ "capacityId": "HpASAuvfRFiVDbOjMfEIcr8K" }

下列程式碼範例示範如何使用 remove-tags-from-vault

AWS CLI

下列命令date會從名為 的保存庫中移除具有 金鑰的標籤my-vault

aws glacier remove-tags-from-vault --account-id - --vault-name my-vault --tag-keys date

Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

下列程式碼範例示範如何使用 set-data-retrieval-policy

AWS CLI

下列命令會設定使用中帳戶的資料擷取政策:

aws glacier set-data-retrieval-policy --account-id - --policy file://data-retrieval-policy.json

data-retrieval-policy.json 是目前資料夾中JSON的檔案,指定資料擷取政策:

{ "Rules":[ { "Strategy":"BytesPerHour", "BytesPerHour":10737418240 } ] }

Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

下列命令會將資料擷取政策設定為FreeTier使用內嵌 JSON:

aws glacier set-data-retrieval-policy --account-id - --policy '{"Rules":[{"Strategy":"FreeTier"}]}'

如需政策格式的詳細資訊,請參閱 Amazon Glacier API參考中的設定資料擷取政策。

下列程式碼範例示範如何使用 set-vault-access-policy

AWS CLI

設定保存庫的存取政策

下列set-vault-access-policy範例會將許可政策連接至指定的保存庫。

aws glacier set-vault-access-policy \ --account-id 111122223333 \ --vault-name example_vault --policy '{"Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:ListJobs\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"},{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:UploadArchive\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"}]}"}'

此命令不會產生輸出。

下列程式碼範例示範如何使用 set-vault-notifications

AWS CLI

下列命令會設定名為 的保存庫SNS通知my-vault

aws glacier set-vault-notifications --account-id - --vault-name my-vault --vault-notification-config file://notificationconfig.json

notificationconfig.json 是目前資料夾中JSON的檔案,指定要發佈SNS的主題和事件:

{ "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault", "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"] }

Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

下列程式碼範例示範如何使用 upload-archive

AWS CLI

以下命令會將目前 archive.zip 資料夾中的封存上傳至名為 my-vault 的文件庫:

aws glacier upload-archive --account-id - --vault-name my-vault --body archive.zip

輸出:

{ "archiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw", "checksum": "969fb39823836d81f0cc028195fcdbcbbe76cdde932d4646fa7de5f21e18aa67", "location": "/0123456789012/vaults/my-vault/archives/kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw" }

Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

若要擷取上傳的封存,請使用 Amazon Glacier 啟動任務命令來啟動擷取任務。

  • 如需API詳細資訊,請參閱 命令參考 UploadArchive中的 。 AWS CLI

下列程式碼範例示範如何使用 upload-multipart-part

AWS CLI

下列命令會上傳封存的前 1 MiB (1024 x 1024 位元組) 部分:

aws glacier upload-multipart-part --body part1 --range 'bytes 0-1048575/*' --account-id - --vault-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ

Amazon Glacier 在執行操作時需要帳戶 ID 引數,但您可以使用連字號來指定使用中的帳戶。

內文參數會取得本機檔案系統上分段檔案的路徑。範圍參數會取得HTTP內容範圍,指出部分在已完成的封存中佔用的位元組。上傳 ID 由 aws glacier initiate-multipart-upload 命令傳回,也可以透過 aws glacier list-multipart-uploads 獲取。

如需使用 將分段上傳至 Amazon Glacier 的詳細資訊 AWS CLI,請參閱 AWS CLI 使用者指南 中的使用 Amazon Glacier。