文件 AWS 開發套件範例 GitHub 儲存庫中有更多可用的 [AWS SDK 範例](https://github.com/awsdocs/aws-doc-sdk-examples)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 的 Amazon Glacier 範例 AWS CLI
下列程式碼範例示範如何使用 AWS Command Line Interface 搭配 Amazon Glacier 執行動作和實作常見案例。
*Actions* 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。
每個範例均包含完整原始碼的連結，您可在連結中找到如何設定和執行內容中程式碼的相關指示。
**Topics**
+ [動作](#actions)
## 動作
### `abort-multipart-upload`
以下程式碼範例顯示如何使用 `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` 獲取。
如需使用 CLI 將分段上傳至 Amazon Glacier AWS 的詳細資訊，請參閱《*AWS CLI 使用者指南*》中的使用 Amazon Glacier。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中 [AbortMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/abort-multipart-upload.html)。
### `abort-vault-lock`
以下程式碼範例顯示如何使用 `abort-vault-lock`。
**AWS CLI**
**中止進行中保存庫鎖定程序**
下列 `abort-vault-lock` 範例會從指定的保存庫中刪除保存庫鎖定政策，並將保存庫鎖定的鎖定狀態重設為解除鎖定。
```
aws glacier abort-vault-lock \
--account-id - \
--vault-name MyVaultName
```
此命令不會產生輸出。
如需詳細資訊，請參閱《*Amazon Glacier API 開發人員指南*》中的[中止保存庫鎖定 (DELETE lock-policy)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-AbortVaultLock.html)。
+ 如需 API 詳細資訊，請參閱《*AWS CLI 命令參考*》中的 [AbortVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/abort-vault-lock.html)。
### `add-tags-to-vault`
以下程式碼範例顯示如何使用 `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 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [AddTagsToVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/add-tags-to-vault.html)。
### `complete-multipart-upload`
以下程式碼範例顯示如何使用 `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 樹雜湊函數。
如需使用 CLI 分段上傳至 Amazon Glacier AWS 的詳細資訊，包括計算樹雜湊的指示，請參閱《*AWS CLI 使用者指南*》中的使用 Amazon Glacier。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CompleteMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/complete-multipart-upload.html)。
### `complete-vault-lock`
以下程式碼範例顯示如何使用 `complete-vault-lock`。
**AWS CLI**
**完成進行中保存庫鎖定程序**
下列`complete-vault-lock`範例會完成指定保存庫的進行中鎖定進度，並將保存庫鎖定的鎖定狀態設定為 `Locked`。執行 `initiate-lock-process` 時，您會取得 `lock-id` 參數的值。
```
aws glacier complete-vault-lock \
--account-id - \
--vault-name MyVaultName \
--lock-id 9QZgEXAMPLEPhvL6xEXAMPLE
```
此命令不會產生輸出。
如需詳細資訊，請參閱《*Amazon Glacier API 開發人員指南*》中的[完成保存庫鎖定 (POST lockId)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-CompleteVaultLock.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CompleteVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/complete-vault-lock.html)。
### `create-vault`
以下程式碼範例顯示如何使用 `create-vault`。
**AWS CLI**
以下命令建立一個名為 `my-vault` 的文件庫：
```
aws glacier create-vault --vault-name my-vault --account-id -
```
Amazon Glacier 在執行操作時需要帳戶 ID 引數，但您可以使用連字號來指定使用中的帳戶。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CreateVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/create-vault.html)。
### `delete-archive`
以下程式碼範例顯示如何使用 `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 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteArchive](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-archive.html)。
### `delete-vault-access-policy`
以下程式碼範例顯示如何使用 `delete-vault-access-policy`。
**AWS CLI**
**移除保存庫的存取政策**
下列 `delete-vault-access-policy` 範例會移除指定保存庫的存取政策。
```
aws glacier delete-vault-access-policy \
--account-id 111122223333 \
--vault-name example_vault
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault-access-policy.html)。
### `delete-vault-notifications`
以下程式碼範例顯示如何使用 `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
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault-notifications.html)。
### `delete-vault`
以下程式碼範例顯示如何使用 `delete-vault`。
**AWS CLI**
以下命令刪除一個名為 `my-vault` 的文件庫：
```
aws glacier delete-vault --vault-name my-vault --account-id -
```
此命令不會產生任何輸出。Amazon Glacier 在執行操作時需要帳戶 ID 引數，但您可以使用連字號來指定使用中的帳戶。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault.html)。
### `describe-job`
以下程式碼範例顯示如何使用 `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-job` 和 `aws glacier list-jobs` 的輸出中找到。Amazon Glacier 在執行操作時需要帳戶 ID 引數，但您可以使用連字號來指定使用中的帳戶。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/describe-job.html)。
### `describe-vault`
以下程式碼範例顯示如何使用 `describe-vault`。
**AWS CLI**
以下命令會擷取名為 `my-vault` 的文件庫資料：
```
aws glacier describe-vault --vault-name my-vault --account-id -
```
Amazon Glacier 在執行操作時需要帳戶 ID 引數，但您可以使用連字號來指定使用中的帳戶。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/describe-vault.html)。
### `get-data-retrieval-policy`
以下程式碼範例顯示如何使用 `get-data-retrieval-policy`。
**AWS CLI**
下列命令會取得使用中帳戶的資料擷取政策：
```
aws glacier get-data-retrieval-policy --account-id -
```
輸出：
```
{
"Policy": {
"Rules": [
{
"BytesPerHour": 10737418240,
"Strategy": "BytesPerHour"
}
]
}
}
```
Amazon Glacier 在執行操作時需要帳戶 ID 引數，但您可以使用連字號來指定使用中的帳戶。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetDataRetrievalPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-data-retrieval-policy.html)。
### `get-job-output`
以下程式碼範例顯示如何使用 `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 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetJobOutput](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-job-output.html)。
### `get-vault-access-policy`
以下程式碼範例顯示如何使用 `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\"}]}"
}
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-access-policy.html)。
### `get-vault-lock`
以下程式碼範例顯示如何使用 `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 lock-policy)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-GetVaultLock.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-lock.html)。
### `get-vault-notifications`
以下程式碼範例顯示如何使用 `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 引數，但您可以使用連字號來指定使用中的帳戶。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-notifications.html)。
### `initiate-job`
以下程式碼範例顯示如何使用 `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"
}
```
封存 ID 可在 `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 詳細資訊，請參閱《*AWS CLI 命令參考*》中的 [InitiateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-job.html)。
### `initiate-multipart-upload`
以下程式碼範例顯示如何使用 `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。使用 `aws glacier upload-multipart-part` 上傳封存的每個部分時，請使用上傳 ID。如需使用 CLI 將分段上傳至 Amazon Glacier AWS 的詳細資訊，請參閱《*AWS CLI 使用者指南*》中的使用 Amazon Glacier。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [InitiateMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-multipart-upload.html)。
### `initiate-vault-lock`
以下程式碼範例顯示如何使用 `initiate-vault-lock`。
**AWS CLI**
**啟動保存庫鎖定程序**
下列 `initiate-vault-lock` 範例會在指定的保存庫上安裝保存庫鎖定政策，並將保存庫鎖的鎖定狀態設定為 `InProgress`。您必須在 24 小時內呼叫 `complete-vault-lock` 來完成此程序，將保存庫鎖定的狀態設定為 `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 lock-policy)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-InitiateVaultLock.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [InitiateVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-vault-lock.html)。
### `list-jobs`
以下程式碼範例顯示如何使用 `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 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-jobs.html)。
### `list-multipart-uploads`
以下程式碼範例顯示如何使用 `list-multipart-uploads`。
**AWS CLI**
下列命令顯示名為 `my-vault` 的保存庫的所有進行中分段上傳：
```
aws glacier list-multipart-uploads --account-id - --vault-name my-vault
```
Amazon Glacier 在執行操作時需要帳戶 ID 引數，但您可以使用連字號來指定使用中的帳戶。
如需使用 CLI 將分段上傳至 Amazon Glacier AWS 的詳細資訊，請參閱《*AWS CLI 使用者指南*》中的使用 Amazon Glacier。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListMultipartUploads](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-multipart-uploads.html)。
### `list-parts`
以下程式碼範例顯示如何使用 `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 引數，但您可以使用連字號來指定使用中的帳戶。
如需使用 CLI 將分段上傳至 Amazon Glacier AWS 的詳細資訊，請參閱《*AWS CLI 使用者指南*》中的使用 Amazon Glacier。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListParts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-parts.html)。
### `list-provisioned-capacity`
以下程式碼範例顯示如何使用 `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"
}
]
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListProvisionedCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-provisioned-capacity.html)。
### `list-tags-for-vault`
以下程式碼範例顯示如何使用 `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 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListTagsForVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-tags-for-vault.html)。
### `list-vaults`
以下程式碼範例顯示如何使用 `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 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListVaults](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-vaults.html)。
### `purchase-provisioned-capacity`
以下程式碼範例顯示如何使用 `purchase-provisioned-capacity`。
**AWS CLI**
**購買佈建的容量單位**
下列 `purchase-provisioned-capacity` 範例會購買佈建的容量單位。
```
aws glacier purchase-provisioned-capacity \
--account-id 111122223333
```
輸出：
```
{
"capacityId": "HpASAuvfRFiVDbOjMfEIcr8K"
}
```
+ 如需 API 詳細資訊，請參閱《*AWS CLI 命令參考*》中的 [PurchaseProvisionedCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/purchase-provisioned-capacity.html)。
### `remove-tags-from-vault`
以下程式碼範例顯示如何使用 `remove-tags-from-vault`。
**AWS CLI**
下列命令會從名為 `my-vault` 的保存庫中移除具有金鑰 `date` 的標籤：
```
aws glacier remove-tags-from-vault --account-id - --vault-name my-vault --tag-keys date
```
Amazon Glacier 在執行操作時需要帳戶 ID 引數，但您可以使用連字號來指定使用中的帳戶。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [RemoveTagsFromVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/remove-tags-from-vault.html)。
### `set-data-retrieval-policy`
以下程式碼範例顯示如何使用 `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 引數，但您可以使用連字號來指定使用中的帳戶。
下列命令會使用內嵌 JSON，將資料擷取政策設定為 `FreeTier`：
```
aws glacier set-data-retrieval-policy --account-id - --policy '{"Rules":[{"Strategy":"FreeTier"}]}'
```
如需有關政策格式的詳細資訊，請參閱《*Amazon Glacier API 參考*》中的設定資料擷取政策。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [SetDataRetrievalPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-data-retrieval-policy.html)。
### `set-vault-access-policy`
以下程式碼範例顯示如何使用 `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\"}]}"}'
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [SetVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-vault-access-policy.html)。
### `set-vault-notifications`
以下程式碼範例顯示如何使用 `set-vault-notifications`。
**AWS CLI**
下列命令可為名為 `my-vault` 的文件庫設定 SNS 通知：
```
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 引數，但您可以使用連字號來指定使用中的帳戶。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [SetVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-vault-notifications.html)。
### `upload-archive`
以下程式碼範例顯示如何使用 `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 詳細資訊，請參閱《AWS CLI 命令參考》**的 [UploadArchive](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-archive.html)。
### `upload-multipart-part`
以下程式碼範例顯示如何使用 `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` 獲取。
如需使用 CLI 將分段上傳至 Amazon Glacier AWS 的詳細資訊，請參閱《*AWS CLI 使用者指南*》中的使用 Amazon Glacier。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UploadMultipartPart](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-multipart-part.html)。