を使用した S3 Glacier の例 AWS CLI - AWS Command Line Interface

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

を使用した 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-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 詳細については、AWS CLI 「 コマンドリファレンスAbortMultipartUpload」の「」を参照してください。

次の例は、abort-vault-lock を使用する方法を説明しています。

AWS CLI

進行中のボールトロックプロセスを中止するには

次のabort-vault-lock例では、指定されたボールトからボールトロックポリシーを削除し、ボールトロックのロック状態をロック解除にリセットします。

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

このコマンドでは何も出力されません。

詳細については、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-name my-vault --tags id=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 --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 ツリーハッシュを 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-name MyVaultName \ --lock-id 9QZgEXAMPLEPhvL6xEXAMPLE

このコマンドでは何も出力されません。

詳細については、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-name example_vault \ --archive-id Sc0u9ZP8yaWkmh-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-name example_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-name example_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-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 詳細については、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-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」の「」を参照してください。

次の例は、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」の「」を参照してください。

次のコード例は、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 詳細については、AWS CLI 「 コマンドリファレンスGetVaultLock」の「」を参照してください。

次の例は、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」の「」を参照してください。

次のコード例は、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 は、ジョブのタイプ、アーカイブ 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-size 1048576 --vault-name my-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。ボールトロックの状態を に設定するには、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 デベロッパーガイド」の「ボールトロックの開始 (POSTロックポリシー)」を参照してください。 Amazon Glacier API

  • API 詳細については、AWS CLI 「 コマンドリファレンスInitiateVaultLock」の「」を参照してください。

次のコード例は、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」の「」を参照してください。

次のコード例は、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 詳細については、AWS CLI 「 コマンドリファレンスListMultipartUploads」の「」を参照してください。

次の例は、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 詳細については、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-name my-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-name my-vault --tag-keys date

Amazon Glacier では、オペレーションを実行する際にアカウント ID 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。

  • API 詳細については、AWS CLI 「 コマンドリファレンスRemoveTagsFromVault」の「」を参照してください。

次の例は、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 詳細については、AWS CLI 「 コマンドリファレンスSetDataRetrievalPolicy」の「」を参照してください。

次のコード例は、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」の「」を参照してください。

次の例は、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 は、発行する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-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 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。

アップロードしたアーカイブを取得するには、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-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_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」の「」を参照してください。