Doc AWS SDK Examples GitHub リポジトリには、他にも SDK の例があります。 AWS
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
を使用した 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を使用して取得することもできます。CLI を使用した Amazon Glacier AWS へのマルチパートアップロードの詳細については、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=july2015Amazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
-
API の詳細については、「AWS CLI コマンドリファレンス」の「AddTagsToVault
」を参照してください。
-
次の例は、complete-multipart-upload を使用する方法を説明しています。
- AWS CLI
-
次のコマンドは、3 MiB アーカイブのマルチパートアップロードを完了します。
aws glacier complete-multipart-upload --archive-size3145728--checksum9628195fcdbcbbe76cdde456d4646fa7de5f219fb39823836d81f0cc0e18aa67--upload-id19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ--account-id - --vault-namemy-vaultAmazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
アップロード ID は
aws glacier initiate-multipart-uploadコマンドによって返され、aws glacier list-multipart-uploadsを使用して取得することもできます。チェックサムパラメータは、アーカイブの SHA-256 ツリーハッシュを 16 進数で取得します。CLI を使用した Amazon Glacier AWS へのマルチパートアップロードの詳細については、「 CLI AWS ユーザーガイド」のAmazon Glacier の使用」を参照してください。
-
API の詳細については、AWS CLI コマンドリファレンスの「CompleteMultipartUpload
」を参照してください。
-
次の例は、complete-vault-lock を使用する方法を説明しています。
- AWS CLI
-
進行中のボールトロックプロセスを完了するには
次の
complete-vault-lockの例では、指定されたボールトの進行中のロック進行状況を完了し、ボールトロックのロック状態をLockedに設定します。initiate-lock-processを実行すると、lock-idパラメータの値を取得します。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-namemy-vault--account-id -Amazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
-
API の詳細については、「AWS CLI コマンドリファレンス」の「CreateVault
」を参照してください。
-
次の例は、delete-archive を使用する方法を説明しています。
- AWS CLI
-
ボールトからアーカイブを削除するには
次の
delete-archiveの例では、example_vaultから指定されたアーカイブを削除します。aws glacier delete-archive \ --account-id111122223333\ --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-id111122223333\ --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-id111122223333\ --vault-nameexample_vaultこのコマンドでは何も出力されません。
-
API の詳細については、「AWS CLI コマンドリファレンス」の「DeleteVaultNotifications
」を参照してください。
-
次の例は、delete-vault を使用する方法を説明しています。
- AWS CLI
-
次のコマンドでは、
my-vaultという名前のボールトが削除されます。aws glacier delete-vault --vault-namemy-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-namemy-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_XqlNHS61dsO4CnMWoutput.jsonjob-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-id111122223333\ --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.jsonjob-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
」を参照してください。
-
次の例は、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 を出力します。
aws glacier upload-multipart-partでアーカイブの各部分をアップロードするときは、アップロード ID を使用します。CLI を使用した Amazon Glacier AWS へのマルチパートアップロードの詳細については、AWS 「 CLI ユーザーガイド」のAmazon Glacier の使用」を参照してください。-
API の詳細については、「AWS CLI コマンドリファレンス」の「InitiateMultipartUpload
」を参照してください。
-
次の例は、initiate-vault-lock を使用する方法を説明しています。
- AWS CLI
-
ボールトロック処理を開始するには
次の
initiate-vault-lockの例では、指定されたボールトにボールトロックポリシーをインストールし、ボールトロックのロック状態をInProgressに設定します。ボールトロック処理を完了するには、24 時間以内にcomplete-vault-lockを呼び出してボールトロックの状態をLockedに設定します。aws glacier initiate-vault-lock \ --account-id - \ --vault-nameMyVaultName\ --policyfile://vault_lock_policy.jsonvault_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 の詳細については、「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-vaultAmazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
CLI を使用した Amazon Glacier AWS へのマルチパートアップロードの詳細については、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 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
CLI を使用した Amazon Glacier AWS へのマルチパートアップロードの詳細については、AWS 「 CLI ユーザーガイド」のAmazon Glacier の使用」を参照してください。
-
API の詳細については、「AWS CLI コマンドリファレンス」の「ListParts
」を参照してください。
-
次の例は、list-provisioned-capacity を使用する方法を説明しています。
- AWS CLI
-
プロビジョニングされたキャパシティーユニットを取得するには
次の
list-provisioned-capacityの例では、指定されたアカウントのプロビジョニングされたキャパシティユニットの詳細を取得します。aws glacier list-provisioned-capacity \ --account-id111122223333出力:
{ "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-id111122223333出力:
{ "capacityId": "HpASAuvfRFiVDbOjMfEIcr8K" }-
API の詳細については、「AWS CLI コマンドリファレンス」の「PurchaseProvisionedCapacity
」を参照してください。
-
次の例は、remove-tags-from-vault を使用する方法を説明しています。
- AWS CLI
-
次のコマンドは、
my-vaultという名前のボールトからdateキーを持つタグを削除します。aws glacier remove-tags-from-vault --account-id - --vault-namemy-vault--tag-keysdateAmazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
-
API の詳細については、「AWS CLI コマンドリファレンス」の「RemoveTagsFromVault
」を参照してください。
-
次の例は、set-data-retrieval-policy を使用する方法を説明しています。
- AWS CLI
-
次のコマンドは、使用中アカウントのデータ取得ポリシーを設定します。
aws glacier set-data-retrieval-policy --account-id - --policyfile://data-retrieval-policy.jsondata-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
」を参照してください。
-
次の例は、set-vault-access-policy を使用する方法を説明しています。
- AWS CLI
-
ボールトのアクセスポリシーを設定するには
次の
set-vault-access-policyの例では、指定されたボールトにアクセス許可ポリシーをアタッチします。aws glacier set-vault-access-policy \ --account-id111122223333\ --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
-
次のコマンドは、
my-vaultという名前のボールトの SNS 通知を設定します。aws glacier set-vault-notifications --account-id - --vault-namemy-vault--vault-notification-configfile://notificationconfig.jsonnotificationconfig.jsonは、現在のフォルダにある JSON ファイルで、公開する SNS トピックとイベントを指定します。{ "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 --bodypart1--range 'bytes 0-1048575/*'--account-id - --vault-namemy-vault--upload-id19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJAmazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
body パラメータは、ローカルファイルシステム上のパートファイルへのパスを受け取ります。range パラメータは、完了したアーカイブ内でそのパートが占めるバイト数を示す HTTP コンテンツ範囲を受け取ります。アップロード ID は
aws glacier initiate-multipart-uploadコマンドによって返され、aws glacier list-multipart-uploadsを使用して取得することもできます。CLI を使用した Amazon Glacier AWS へのマルチパートアップロードの詳細については、AWS 「 CLI ユーザーガイド」のAmazon Glacier の使用」を参照してください。
-
API の詳細については、「AWS CLI コマンドリファレンス」の「UploadMultipartPart
」を参照してください。
-