# AWS CLI を使用する Amazon Glacier の例
次のコード例は、Amazon Glacier で AWS Command Line Interface を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。
*アクション*はより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。
各例には完全なソースコードへのリンクが含まれており、コードの設定方法と実行方法に関する手順を確認できます。
**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` を使用して取得することもできます。
AWS CLI を使用した Amazon Glacier へのマルチパートアップロードの詳細については、「*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 ロックポリシー)](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` という名前のボールトに 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](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 ツリーハッシュを 16 進数で取得します。
ツリーハッシュの計算に関する手順を含め、AWS CLI を使用した Amazon Glacier へのマルチパートアップロードの詳細については、「*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 ロックポリシー)](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**
次のコマンドは、ファイルごとに 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 を出力します。`aws glacier upload-multipart-part` でアーカイブの各部分をアップロードするときは、アップロード ID を使用します。AWS CLI を使用した Amazon Glacier へのマルチパートアップロードの詳細については、「*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 ロックポリシー)](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 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
AWS CLI を使用した Amazon Glacier へのマルチパートアップロードの詳細については、「*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 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
AWS CLI を使用した Amazon Glacier へのマルチパートアップロードの詳細については、「*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 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
アップロードしたアーカイブを取得するには、aws glacier initiate-job コマンドを使用して取得ジョブを開始します。
+ 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 引数が必要ですが、ハイフンを使用して使用中のアカウントを指定できます。
body パラメータは、ローカルファイルシステム上のパートファイルへのパスを受け取ります。range パラメータは、完了したアーカイブ内でそのパートが占めるバイト数を示す HTTP コンテンツ範囲を受け取ります。アップロード ID は `aws glacier initiate-multipart-upload` コマンドによって返され、`aws glacier list-multipart-uploads` を使用して取得することもできます。
AWS CLI を使用した Amazon Glacier へのマルチパートアップロードの詳細については、「*AWS CLI ユーザーガイド*」の「Amazon Glacier の使用」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UploadMultipartPart](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-multipart-part.html)」を参照してください。