使用的 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。

如需API詳細資訊，請參閱命令參考 AbortMultipartUpload中的。 AWS CLI

下列程式碼範例示範如何使用 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。

如需API詳細資訊，請參閱命令參考 CompleteMultipartUpload中的。 AWS CLI

下列程式碼範例示範如何使用 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

如需API詳細資訊，請參閱命令參考 CompleteVaultLock中的。 AWS CLI

下列程式碼範例示範如何使用 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

此命令不會產生輸出。

如需API詳細資訊，請參閱命令參考 DeleteVaultAccessPolicy中的。 AWS CLI

下列程式碼範例示範如何使用 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詳細資訊，請參閱命令參考 DeleteVaultNotifications中的。 AWS CLI

下列程式碼範例示範如何使用 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-job 和 aws 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 引數，但您可以使用連字號來指定使用中的帳戶。

如需API詳細資訊，請參閱命令參考 GetDataRetrievalPolicy中的。 AWS CLI

下列程式碼範例示範如何使用 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\"}]}"
    }
}

如需API詳細資訊，請參閱命令參考 GetVaultAccessPolicy中的。 AWS CLI

下列程式碼範例示範如何使用 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）。

如需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 引數，但您可以使用連字號來指定使用中的帳戶。

如需API詳細資訊，請參閱命令參考 GetVaultNotifications中的。 AWS CLI

下列程式碼範例示範如何使用 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。

如需API詳細資訊，請參閱命令參考 InitiateMultipartUpload中的。 AWS CLI

下列程式碼範例示範如何使用 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鎖定政策）。

如需API詳細資訊，請參閱命令參考 InitiateVaultLock中的。 AWS CLI

下列程式碼範例示範如何使用 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。

如需API詳細資訊，請參閱命令參考 ListMultipartUploads中的。 AWS CLI

下列程式碼範例示範如何使用 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"
        }
    ]
}

如需API詳細資訊，請參閱命令參考 ListProvisionedCapacity中的。 AWS CLI

下列程式碼範例示範如何使用 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"
}

如需API詳細資訊，請參閱命令參考 PurchaseProvisionedCapacity中的。 AWS CLI

下列程式碼範例示範如何使用 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 引數，但您可以使用連字號來指定使用中的帳戶。

如需API詳細資訊，請參閱命令參考 RemoveTagsFromVault中的。 AWS CLI

下列程式碼範例示範如何使用 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參考中的設定資料擷取政策。

如需API詳細資訊，請參閱命令參考 SetDataRetrievalPolicy中的。 AWS CLI

下列程式碼範例示範如何使用 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詳細資訊，請參閱命令參考 SetVaultAccessPolicy中的。 AWS CLI

下列程式碼範例示範如何使用 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 引數，但您可以使用連字號來指定使用中的帳戶。

如需API詳細資訊，請參閱命令參考 SetVaultNotifications中的。 AWS CLI

下列程式碼範例示範如何使用 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。

如需API詳細資訊，請參閱命令參考 UploadMultipartPart中的。 AWS CLI

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

Amazon S3 控制項

Secrets Manager

使用 的 S3 Glacier 範例 AWS CLI

主題

動作

使用的 S3 Glacier 範例 AWS CLI