翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
を使用した S3 Glacier の例 AWS CLI
次のコード例は、S3 Glacier AWS Command Line Interface で を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。
アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。
各例には、完全なソースコードへのリンクが含まれています。ここでは、コンテキストでコードを設定および実行する方法の手順を確認できます。
トピック
アクション
次のコード例は、abort-multipart-upload
を使用する方法を示しています。
- AWS CLI
-
次のコマンドは、 という名前のボールトへの進行中のマルチパートアップロードを削除します
my-vault
。aws glacier abort
-
multipart-upload --account-id - --vault-namemy-vault
--upload-id19gaRezEXAMPLES6Ry5YYdqthHOC_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 詳細については、AWS CLI 「 コマンドリファレンスAbortMultipartUpload
」の「」を参照してください。
-
次の例は、abort-vault-lock
を使用する方法を説明しています。
- AWS CLI
-
進行中のボールトロックプロセスを中止するには
次の
abort-vault-lock
例では、指定されたボールトからボールトロックポリシーを削除し、ボールトロックのロック状態をロック解除にリセットします。aws glacier abort
-
vault-lock \ --account-id - \ --vault-nameMyVaultName
このコマンドでは何も出力されません。
詳細については、Amazon Glacier APIデベロッパーガイド」の「ボールトロックの中止 (DELETEロックポリシー)」を参照してください。
-
API 詳細については、AWS CLI 「 コマンドリファレンスAbortVaultLock
」の「」を参照してください。
-
次のコード例は、add-tags-to-vault
を使用する方法を示しています。
- AWS CLI
-
次のコマンドは、
my-vault
という名前のボールトに 2 つのタグを追加します。aws glacier add
-
tags-to-vault --account-id - --vault-namemy-vault
--tagsid=1234,date=july2015
Amazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
-
API 詳細については、AWS CLI 「 コマンドリファレンスAddTagsToVault
」の「」を参照してください。
-
次の例は、complete-multipart-upload
を使用する方法を説明しています。
- AWS CLI
-
次のコマンドは、3 MiB アーカイブのマルチパートアップロードを完了します。
aws glacier complete-multipart-upload --archive-size
3145728
--checksum9628195fcdbcbbe76cdde456d4646fa7de5f219fb39823836d81f0cc0e18aa67
--upload-id19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ
-
-account-id - --vault-namemy-vault
Amazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
アップロード ID は
aws glacier initiate-multipart-upload
コマンドによって返され、aws glacier list-multipart-uploads
を使用して取得することもできます。チェックサムパラメータは、アーカイブの SHA-256 ツリーハッシュを 16 進数で取得します。を使用した Amazon Glacier へのマルチパートアップロードの詳細については AWS CLI、 AWS CLIユーザーガイドのAmazon Glacier の使用」を参照してください。
-
API 詳細については、AWS CLI 「 コマンドリファレンスCompleteMultipartUpload
」の「」を参照してください。
-
次のコード例は、complete-vault-lock
を使用する方法を示しています。
- AWS CLI
-
進行中のボールトロックプロセスを完了するには
次の
complete-vault-lock
例では、指定されたボールトの進行中のロックの進行状況を完了し、ボールトロックのロック状態を に設定しますLocked
。を実行すると、lock-id
パラメータの値を取得しますinitiate-lock-process
。aws glacier complete
-
vault-lock \ --account-id - \ --vault-nameMyVaultName
\ --lock-id9QZgEXAMPLEPhvL6xEXAMPLE
このコマンドでは何も出力されません。
詳細については、Amazon Glacier APIデベロッパーガイド」の「完全なボールトロック (POST lockId)」を参照してください。
-
API 詳細については、AWS CLI 「 コマンドリファレンスCompleteVaultLock
」の「」を参照してください。
-
次の例は、create-vault
を使用する方法を説明しています。
- AWS CLI
-
次のコマンドでは、
my-vault
という名前の新しいボールトが作成されます。aws glacier create-vault --vault-name
my-vault
-
-account-id -Amazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
-
API 詳細については、AWS CLI 「 コマンドリファレンスCreateVault
」の「」を参照してください。
-
次の例は、delete-archive
を使用する方法を説明しています。
- AWS CLI
-
ボールトからアーカイブを削除するには
次の
delete-archive
の例では、example_vault
から指定されたアーカイブを削除します。aws glacier delete-archive \ --account-id
111122223333
\ --vault-nameexample_vault
\ --archive-idSc0u9ZP8yaWkmh-XGlIvAVprtLhaLCGnNwNl5I5x9HqPIkX5mjc0DrId3Ln-Gi_k2HzmlIDZUz117KSdVMdMXLuFWi9PJUitxWO73edQ43eTlMWkH0pd9zVSAuV_XXZBVhKhyGhJ7w
このコマンドでは何も出力されません。
-
API 詳細については、AWS CLI 「 コマンドリファレンスDeleteArchive
」の「」を参照してください。
-
次のコード例は、delete-vault-access-policy
を使用する方法を示しています。
- AWS CLI
-
ボールトのアクセスポリシーを削除するには
次の
delete-vault-access-policy
例では、指定されたボールトのアクセスポリシーを削除します。aws glacier delete-vault-access-policy \ --account-id
111122223333
\ --vault-nameexample_vault
このコマンドでは何も出力されません。
-
API 詳細については、AWS CLI 「 コマンドリファレンスDeleteVaultAccessPolicy
」の「」を参照してください。
-
次のコード例は、delete-vault-notifications
を使用する方法を示しています。
- AWS CLI
-
ボールトSNSの通知を削除するには
次の
delete-vault-notifications
例では、Amazon Simple Notification Service (Amazon SNS) によって指定されたボールトに対して送信された通知を削除します。aws glacier delete-vault-notifications \ --account-id
111122223333
\ --vault-nameexample_vault
このコマンドでは何も出力されません。
-
API 詳細については、AWS CLI 「 コマンドリファレンスDeleteVaultNotifications
」の「」を参照してください。
-
次のコード例は、delete-vault
を使用する方法を示しています。
- AWS CLI
-
次のコマンドでは、
my-vault
という名前のボールトが削除されます。aws glacier delete-vault --vault-name
my-vault
-
-account-id -このコマンドでは、出力が生成されません。Amazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
-
API 詳細については、AWS CLI 「 コマンドリファレンスDeleteVault
」の「」を参照してください。
-
次の例は、describe-job
を使用する方法を説明しています。
- AWS CLI
-
次のコマンドは、
my-vault
という名前のボールトでのインベントリ取得ジョブに関する情報を取得します。aws glacier describe
-
job --account-id - --vault-namemy-vault
--job-idzbxcm3Z_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
」の「」を参照してください。
-
次の例は、describe-vault
を使用する方法を説明しています。
- AWS CLI
-
次のコマンドは、
my-vault
という名前のボールトに関するデータを取得します。aws glacier describe-vault --vault-name
my-vault
-
-account-id -Amazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
-
API 詳細については、AWS CLI 「 コマンドリファレンスDescribeVault
」の「」を参照してください。
-
次のコード例は、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
」の「」を参照してください。
-
次のコード例は、get-job-output
を使用する方法を示しています。
- AWS CLI
-
次のコマンドは、ボールトインベントリジョブの出力を、現在のディレクトリの
output.json
という名前のファイルに保存します。aws glacier get
-
job-output --account-id - --vault-namemy-vault
--job-idzbxcm3Z_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
」の「」を参照してください。
-
次の例は、get-vault-access-policy
を使用する方法を説明しています。
- AWS CLI
-
ボールトのアクセスポリシーを取得するには
次の
get-vault-access-policy
例では、指定されたボールトのアクセスポリシーを取得します。aws glacier get-vault-access-policy \ --account-id
111122223333
\ --vault-nameexample_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
」の「」を参照してください。
-
次のコード例は、get-vault-lock
を使用する方法を示しています。
- AWS CLI
-
ボールトロックの詳細を取得するには
次の
get-vault-lock
例では、指定されたボールトのロックに関する詳細を取得しました。aws glacier get
-
vault-lock \ --account-id - \ --vault-nameMyVaultName
出力:
{ "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 詳細については、AWS CLI 「 コマンドリファレンスGetVaultLock
」の「」を参照してください。
-
次の例は、get-vault-notifications
を使用する方法を説明しています。
- AWS CLI
-
次のコマンドは、
my-vault
という名前のボールトの通知設定の説明を取得します。aws glacier get
-
vault-notifications --account-id - --vault-namemy-vault
出力:
{ "vaultNotificationConfig": { "Events": [ "InventoryRetrievalCompleted", "ArchiveRetrievalCompleted" ], "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault" } }
ボールトに通知が設定されていない場合、エラーが返されます。Amazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
-
API 詳細については、AWS CLI 「 コマンドリファレンスGetVaultNotifications
」の「」を参照してください。
-
次のコード例は、initiate-job
を使用する方法を示しています。
- AWS CLI
-
次のコマンドは、ボールト のインベントリを取得するジョブを開始します
my-vault
。aws glacier initiate
-
job --account-id - --vault-namemy-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-namemy-vault
--job-parametersfile://job-archive-retrieval.json
job-archive-retrieval.json
は、ジョブのタイプ、アーカイブ ID、およびいくつかのオプションパラメータを指定するローカルフォルダ内のJSONファイルです。{ "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 詳細については、AWS CLI 「 コマンドリファレンスInitiateJob
」の「」を参照してください。
-
次のコード例は、initiate-multipart-upload
を使用する方法を示しています。
- AWS CLI
-
次のコマンドは、ファイルごとに 1 MiB (1024 x 1024 バイト) のパートサイズ
my-vault
で という名前のボールトへのマルチパートアップロードを開始します。aws glacier initiate
-
multipart-upload --account-id - --part-size1048576
--vault-namemy-vault
--archive-description"multipart upload test"
アーカイブの説明パラメータはオプションです。Amazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
このコマンドは、成功するとアップロード ID を出力します。でアーカイブの各部分をアップロードするときは、アップロード ID を使用します
aws glacier upload-multipart-part
。を使用した Amazon Glacier へのマルチパートアップロードの詳細については AWS CLI、 AWS CLI ユーザーガイドのAmazon Glacier の使用」を参照してください。-
API 詳細については、AWS CLI 「 コマンドリファレンスInitiateMultipartUpload
」の「」を参照してください。
-
次の例は、initiate-vault-lock
を使用する方法を説明しています。
- AWS CLI
-
ボールトロックプロセスを開始するには
次の
initiate-vault-lock
例では、指定されたボールトにボールトロックポリシーをインストールし、ボールトロックのロック状態を に設定しますInProgress
。ボールトロックの状態を に設定するには、24complete-vault-lock
時間以内に を呼び出してプロセスを完了する必要がありますLocked
。aws glacier initiate
-
vault-lock \ --account-id - \ --vault-nameMyVaultName
\ --policyfile://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 デベロッパーガイド」の「ボールトロックの開始 (POSTロックポリシー)」を参照してください。 Amazon Glacier API
-
API 詳細については、AWS CLI 「 コマンドリファレンスInitiateVaultLock
」の「」を参照してください。
-
次のコード例は、list-jobs
を使用する方法を示しています。
- AWS CLI
-
次のコマンドは、
my-vault
という名前のボールトで進行中のジョブと最近完了したジョブを一覧表示します。aws glacier list
-
jobs --account-id - --vault-namemy-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
」の「」を参照してください。
-
次のコード例は、list-multipart-uploads
を使用する方法を示しています。
- AWS CLI
-
次のコマンドは、 という名前のボールトに対して進行中のすべてのマルチパートアップロードを示しています
my-vault
。aws glacier list
-
multipart-uploads --account-id - --vault-namemy-vault
Amazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
を使用した Amazon Glacier へのマルチパートアップロードの詳細については AWS CLI、 AWS CLI ユーザーガイドのAmazon Glacier の使用」を参照してください。
-
API 詳細については、AWS CLI 「 コマンドリファレンスListMultipartUploads
」の「」を参照してください。
-
次の例は、list-parts
を使用する方法を説明しています。
- AWS CLI
-
次のコマンドは、 という名前のボールトへのマルチパートアップロード用にアップロードされたパートを一覧表示します
my-vault
。aws glacier list
-
parts --account-id - --vault-namemy-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 詳細については、AWS CLI 「 コマンドリファレンスListParts
」の「」を参照してください。
-
次の例は、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
」の「」を参照してください。
-
次のコード例は、list-tags-for-vault
を使用する方法を示しています。
- AWS CLI
-
次のコマンドは、
my-vault
という名前のボールトに適用されたタグを一覧表示します。aws glacier list
-
tags-for-vault --account-id - --vault-namemy-vault
出力:
{ "Tags": { "date": "july2015", "id": "1234" } }
Amazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
-
API 詳細については、AWS CLI 「 コマンドリファレンスListTagsForVault
」の「」を参照してください。
-
次の例は、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
」の「」を参照してください。
-
次のコード例は、purchase-provisioned-capacity
を使用する方法を示しています。
- AWS CLI
-
プロビジョニングされたキャパシティーユニットを購入するには
次の
purchase-provisioned-capacity
例では、プロビジョニングされたキャパシティユニットを購入します。aws glacier purchase-provisioned-capacity \ --account-id
111122223333
出力:
{ "capacityId": "HpASAuvfRFiVDbOjMfEIcr8K" }
-
API 詳細については、AWS CLI 「 コマンドリファレンスPurchaseProvisionedCapacity
」の「」を参照してください。
-
次のコード例は、remove-tags-from-vault
を使用する方法を示しています。
- AWS CLI
-
次のコマンドは、 という名前のボールト
date
から キーを持つタグを削除しますmy-vault
。aws glacier remove
-
tags-from-vault --account-id - --vault-namemy-vault
--tag-keysdate
Amazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
-
API 詳細については、AWS CLI 「 コマンドリファレンスRemoveTagsFromVault
」の「」を参照してください。
-
次の例は、set-data-retrieval-policy
を使用する方法を説明しています。
- AWS CLI
-
次のコマンドは、使用中アカウントのデータ取得ポリシーを設定します。
aws glacier set
-
data-retrieval-policy --account-id - --policyfile://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 詳細については、AWS CLI 「 コマンドリファレンスSetDataRetrievalPolicy
」の「」を参照してください。
-
次のコード例は、set-vault-access-policy
を使用する方法を示しています。
- AWS CLI
-
ボールトのアクセスポリシーを設定するには
次の
set-vault-access-policy
例では、指定されたボールトにアクセス許可ポリシーをアタッチします。aws glacier set-vault-access-policy \ --account-id
111122223333
\ --vault-nameexample_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
」の「」を参照してください。
-
次の例は、set-vault-notifications
を使用する方法を説明しています。
- AWS CLI
-
次のコマンドは、 という名前のボールトSNSの通知を設定します
my-vault
。aws glacier set
-
vault-notifications --account-id - --vault-namemy-vault
--vault-notification-configfile://notificationconfig.json
notificationconfig.json
は、発行するSNSトピックとイベントを指定する現在のフォルダ内のJSONファイルです。{ "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault", "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"] }
Amazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
-
API 詳細については、AWS CLI 「 コマンドリファレンスSetVaultNotifications
」の「」を参照してください。
-
次のコード例は、upload-archive
を使用する方法を示しています。
- AWS CLI
-
次のコマンドは、
archive.zip
という名前の現在のフォルダにあるアーカイブを、my-vault
という名前のボールトにアップロードします。aws glacier upload
-
archive --account-id - --vault-namemy-vault
--bodyarchive.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 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
アップロードしたアーカイブを取得するには、aws glacier initiate-job コマンドを使用して取得ジョブを開始します。
-
API 詳細については、AWS CLI 「 コマンドリファレンスUploadArchive
」の「」を参照してください。
-
次の例は、upload-multipart-part
を使用する方法を説明しています。
- AWS CLI
-
次のコマンドは、アーカイブの最初の 1 MiB (1024 x 1024 バイト) の部分をアップロードします。
aws glacier upload-multipart-part --body
part1
--range 'bytes 0-1048575/*
'-
-account-id - --vault-namemy-vault
--upload-id19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ
Amazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
body パラメータは、ローカルファイルシステム上のパートファイルへのパスを受け取ります。range パラメータは、完了したアーカイブでパーツが占有するバイト数を示すHTTPコンテンツ範囲を取得します。アップロード ID は
aws glacier initiate-multipart-upload
コマンドによって返され、aws glacier list-multipart-uploads
を使用して取得することもできます。を使用した Amazon Glacier へのマルチパートアップロードの詳細については AWS CLI、 AWS CLI ユーザーガイドのAmazon Glacier の使用」を参照してください。
-
API 詳細については、AWS CLI 「 コマンドリファレンスUploadMultipartPart
」の「」を参照してください。
-