**このページは、ボールトと 2012 年リリース当時の REST API を使用する、Amazon Glacier サービスの既存のお客様のみを対象としています。**
アーカイブストレージソリューションをお探しの場合は、Amazon S3 の Amazon Glacier ストレージクラス (S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval、S3 Glacier Deep Archive) を使用することをお勧めします。これらのストレージオプションの詳細については、「[Amazon Glacier ストレージクラス](https://aws.amazon.com/s3/storage-classes/glacier/)」を参照してください。
Amazon Glacier (元のスタンドアロンボールトベースのサービス) は、新規顧客を受け入れなくなりました。Amazon Glacier は、ボールトにデータを保存する独自の API を備えたスタンドアロンサービスであり、Amazon S3 および Amazon S3 Glacier ストレージクラスとは異なります。既存のデータは Amazon Glacier で無期限に安全性が確保され、引き続きアクセス可能です。移行は必要ありません。低コストの長期アーカイブストレージの場合、 は [Amazon S3 Glacier ストレージクラス](https://aws.amazon.com/s3/storage-classes/glacier/) AWS を推奨します。これにより、S3 バケットベースの APIs、低コスト、 AWS サービス統合で優れたカスタマーエクスペリエンスを実現できます。 AWS リージョン 拡張機能が必要な場合は、[Amazon Glacier ボールトから Amazon S3 Glacier ストレージクラスにデータを転送するためのAWS ソリューションガイダンス](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)を使用して、Amazon S3 Glacier ストレージクラスへの移行を検討してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Glacier でボールトメタデータを取得する
ボールトの 作成日、ボールトの中のアーカイブの数、すべてのアーカイブの合計サイズなど、ボールトに関する情報を返します。Amazon Glacier (Amazon Glacier) は、アカウント内の特定の AWS リージョンにある特定のボールトまたはすべてのボールトについて、この情報を取得するための API コールを提供します。
ボールトリストを取得すると、Amazon Glacier は、ボールト名の ASCII 値でソートされたリストを返します。リストには最大 1,000 のボールトが含まれます。リストを維持するマーカーに対するレスポンスを常に確認する必要があります。それ以上の項目が存在しない場合、マーカーフィールドは `null` です。レスポンスで返されるボールトの数を制限することもできます。レスポンスで多くのボールトが返されると、結果はページ分割されます。ボールトの次のセットを取得するには、追加リクエストを送信する必要があります。
**Topics**
+ [を使用した Amazon Glacier でのボールトメタデータの取得 AWS SDK for Java](retrieving-vault-info-sdk-java.md)
+ [を使用した Amazon Glacier でのボールトメタデータの取得 AWS SDK for .NET](retrieving-vault-info-sdk-dotnet.md)
+ [REST API を使用したボールトメタデータの取得](listing-vaults-rest-api.md)
+ [Amazon Glacier で AWS Command Line Interfaceを使用してボールトメタデータを取得する](retrieving-vault-info-cli.md)
# を使用した Amazon Glacier でのボールトメタデータの取得 AWS SDK for Java
**Topics**
+ [特定のボールトのボールトメタデータの取得](#retrieve-vault-info-sdk-java-lowlevel-one-vault)
+ [リージョン内のすべてのボールトのボールトメタデータの取得](#retrieve-vault-info-sdk-java-lowlevel-all-vaults)
+ [例: Amazon SDK for Java によるボールトメタデータの取得](#retrieving-vault-info-sdk-java-example)
## 特定のボールトのボールトメタデータの取得
特定のボールトまたは特定の AWS リージョンのすべてのボールトのメタデータを取得できます。以下に、Amazon SDK for Java の低レベル API を使用して特定のボールトのボールトメタデータを取得する手順を示します。
1. `AmazonGlacierClient` クラスのインスタンス（クライアント）を作成します。
ボールトが存在する AWS リージョンを指定する必要があります。このクライアントを使用して実行するすべてのオペレーションは、その AWS リージョンに適用されます。
1. `DescribeVaultRequest` クラスのインスタンスを作成することにより、リクエスト情報を指定します。
Amazon Glacier (Amazon Glacier) には、ボールト名とアカウント ID を指定する必要があります アカウント ID を指定しなかった場合には、リクエストに署名する際に使用した認証情報に関連付けられているアカウント ID が使用されます。詳細については、「[Amazon Glacier AWS SDK for Java での の使用](using-aws-sdk-for-java.md)」を参照してください。
1. リクエストオブジェクトをパラメータとして指定して、`describeVault` メソッドを実行します。
Amazon Glacier が返すボールトメタデータ情報は、`DescribeVaultResult` オブジェクトで使用できます。
以下の Java コードスニペットは、前述の手順を示しています。
```
DescribeVaultRequest request = new DescribeVaultRequest()
.withVaultName("*** provide vault name***");
DescribeVaultResult result = client.describeVault(request);
System.out.print(
"\nCreationDate: " + result.getCreationDate() +
"\nLastInventoryDate: " + result.getLastInventoryDate() +
"\nNumberOfArchives: " + result.getNumberOfArchives() +
"\nSizeInBytes: " + result.getSizeInBytes() +
"\nVaultARN: " + result.getVaultARN() +
"\nVaultName: " + result.getVaultName());
```
**注記**
基本となる REST API については、「[ボールトの説明 (GET vault)](api-vault-get.md)」を参照してください。
## リージョン内のすべてのボールトのボールトメタデータの取得
`listVaults` メソッドを使用して、特定の AWS リージョン内のすべてのボールトのメタデータを取得することもできます。
以下の Java コードスニペットにより、`us-west-2` リージョン内のボールトのリストを取得します。リクエストでは、レスポンスで返されるボールトの数を 5 に制限します。次に、コードスニペットは、 AWS リージョンからボールトリスト全体を取得するために一連の`listVaults`呼び出しを行います。
```
AmazonGlacierClient client;
client.setEndpoint("https://glacier.us-west-2.amazonaws.com/");
String marker = null;
do {
ListVaultsRequest request = new ListVaultsRequest()
.withLimit("5")
.withMarker(marker);
ListVaultsResult listVaultsResult = client.listVaults(request);
List vaultList = listVaultsResult.getVaultList();
marker = listVaultsResult.getMarker();
for (DescribeVaultOutput vault : vaultList) {
System.out.println(
"\nCreationDate: " + vault.getCreationDate() +
"\nLastInventoryDate: " + vault.getLastInventoryDate() +
"\nNumberOfArchives: " + vault.getNumberOfArchives() +
"\nSizeInBytes: " + vault.getSizeInBytes() +
"\nVaultARN: " + vault.getVaultARN() +
"\nVaultName: " + vault.getVaultName());
}
} while (marker != null);
```
このコードスニペットにおいて、リクエストの `Limit` の値を指定しなかった場合、Amazon Glacier は、Amazon Glacier API に定められているように、最大 10 個のボールトを返します。リストに表示するボールトがさらに存在する場合、レスポンスの `marker` フィールドにボールト Amazon リソースネーム (ARN) が含まれ、この中に新しいリクエストのリストの続きが含まれます。そうでない場合、`marker` フィールドは null になります。
リスト内の各ボールトに対して返される情報は、特定のボールトに対して `describeVault` メソッドを呼び出して取得する情報と同じであることに注意してください。
**注記**
`listVaults` メソッドは基本となる REST API を呼び出します (「[ボールトのリスト (GET vaults)](api-vaults-get.md)」を参照)。
## 例: Amazon SDK for Java によるボールトメタデータの取得
コード例については、「[例: AWS SDK for Java を使用したボールトの作成](creating-vaults-sdk-java.md#creating-vaults-sdk-java-example)」を参照してください。この Java コード例では、ボールトを作成し、ボールトメタデータを取得します。
# を使用した Amazon Glacier でのボールトメタデータの取得 AWS SDK for .NET
**Topics**
+ [特定のボールトのボールトメタデータの取得](#retrieve-vault-info-sdk-dotnet-lowlevel-one-vault)
+ [リージョン内のすべてのボールトのボールトメタデータの取得](#retrieve-vault-info-sdk-dotnet-lowlevel-all-vaults)
+ [例: の低レベル API を使用したボールトメタデータの取得 AWS SDK for .NET](#creating-vaults-sdk-dotnet-example)
## 特定のボールトのボールトメタデータの取得
特定のボールトまたは特定の AWS リージョンのすべてのボールトのメタデータを取得できます。以下に、 AWS SDK for .NETの低レベル API を使用して特定のボールトのボールトメタデータを取得する手順を示します。
1. `AmazonGlacierClient` クラスのインスタンス（クライアント）を作成します。
ボールトが存在する AWS リージョンを指定する必要があります。このクライアントを使用して実行するすべてのオペレーションは、その AWS リージョンに適用されます。
1. `DescribeVaultRequest` クラスのインスタンスを作成することにより、リクエスト情報を指定します。
Amazon Glacier (Amazon Glacier) には、ボールト名とアカウント ID を指定する必要があります アカウント ID を指定しなかった場合には、リクエストに署名する際に使用した認証情報に関連付けられているアカウント ID が使用されます。詳細については、「[Amazon Glacier でのAWS SDK for .NET の使用](using-aws-sdk-for-dot-net.md)」を参照してください。
1. リクエストオブジェクトをパラメータとして指定して、`DescribeVault` メソッドを実行します。
Amazon Glacier が返すボールトメタデータ情報は、`DescribeVaultResult` オブジェクトで使用できます。
以下の C\$1 コードスニペットは、前述の手順を示しています。このスニペットでは、米国西部（オレゴン）リージョン 内の既存のボールトのメタデータ情報を取得します。
```
AmazonGlacierClient client;
client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2);
DescribeVaultRequest describeVaultRequest = new DescribeVaultRequest()
{
VaultName = "*** Provide vault name ***"
};
DescribeVaultResponse describeVaultResponse = client.DescribeVault(describeVaultRequest);
Console.WriteLine("\nVault description...");
Console.WriteLine(
"\nVaultName: " + describeVaultResponse.VaultName +
"\nVaultARN: " + describeVaultResponse.VaultARN +
"\nVaultCreationDate: " + describeVaultResponse.CreationDate +
"\nNumberOfArchives: " + describeVaultResponse.NumberOfArchives +
"\nSizeInBytes: " + describeVaultResponse.SizeInBytes +
"\nLastInventoryDate: " + describeVaultResponse.LastInventoryDate
);
```
**注記**
基本となる REST API については、「[ボールトの説明 (GET vault)](api-vault-get.md)」を参照してください。
## リージョン内のすべてのボールトのボールトメタデータの取得
`ListVaults` メソッドを使用して、特定の AWS リージョン内のすべてのボールトのメタデータを取得することもできます。
次の C\$1 コードスニペットでは、米国西部（オレゴン）リージョン のボールトのリストを取得します。リクエストでは、レスポンスで返されるボールトの数を 5 に制限します。次に、コードスニペットは、 AWS リージョンからボールトリスト全体を取得するために一連の`ListVaults`呼び出しを行います。
```
AmazonGlacierClient client;
client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2);
string lastMarker = null;
Console.WriteLine("\n List of vaults in your account in the specific AWS Region ...");
do
{
ListVaultsRequest request = new ListVaultsRequest()
{
Limit = 5,
Marker = lastMarker
};
ListVaultsResponse response = client.ListVaults(request);
foreach (DescribeVaultOutput output in response.VaultList)
{
Console.WriteLine("Vault Name: {0} \tCreation Date: {1} \t #of archives: {2}",
output.VaultName, output.CreationDate, output.NumberOfArchives);
}
lastMarker = response.Marker;
} while (lastMarker != null);
```
このコードスニペットにおいて、リクエストの `Limit` の値を指定しなかった場合、Amazon Glacier は、Amazon Glacier API に定められているように、最大 10 個のボールトを返します。
リスト内の各ボールトに対して返される情報は、特定のボールトに対して `DescribeVault` メソッドを呼び出して取得する情報と同じであることに注意してください。
**注記**
`ListVaults` メソッドは基本となる REST API を呼び出します (「[ボールトのリスト (GET vaults)](api-vaults-get.md)」を参照)。
## 例: の低レベル API を使用したボールトメタデータの取得 AWS SDK for .NET
コード例については、「[例: の低レベル API を使用したボールトオペレーション AWS SDK for .NET](creating-vaults-dotnet-sdk.md#vault-operations-example-dotnet-lowlevel)」を参照してください。この C\$1 コード例では、ボールトを作成し、ボールトメタデータを取得します。
# REST API を使用したボールトメタデータの取得
REST API を使用してボールトをリストするには、「[ボールトのリスト (GET vaults)](api-vaults-get.md)」を参照してください。1 つのボールトを説明するには、「[ボールトの説明 (GET vault)](api-vault-get.md)」を参照してください。
# Amazon Glacier で AWS Command Line Interfaceを使用してボールトメタデータを取得する
この例では、Amazon Glacier (Amazon Glacier) を使用して AWS Command Line Interface (AWS CLI) 内のボールト情報とメタデータを取得する方法を示します。
**Topics**
+ [(前提条件) AWS CLI の設定](#Creating-Vaults-CLI-Setup)
+ [AWS CLI を使用したボールトメタデータの取得](#Retrieving-Vault-Metadata-CLI-Implementation)
## (前提条件) AWS CLI の設定
1. AWS CLI をダウンロードして設定します。手順については、*「AWS Command Line Interface ユーザーガイド」*の次のトピックを参照してください。
[ のインストールAWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)
[ の設定AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)
1. コマンドプロンプトで以下のコマンドを入力して、AWS CLI の設定を確認します。これらのコマンドは、いずれも認証情報を明示的に提供しないため、デフォルトプロファイルの認証情報が使用されます。
+ help コマンドを使用してください。
```
aws help
```
+ 設定したアカウントの Amazon Glacier ボールトのリストを取得するには、`list-vaults` コマンドを使用します。*123456789012* を自分の AWS アカウント ID に置き換えます。
```
aws glacier list-vaults --account-id 123456789012
```
+ AWS CLI の現在の設定データを確認するには、`aws configure list` コマンドを使用します。
```
aws configure list
```
## AWS CLI を使用したボールトメタデータの取得
+ 使用する`describe-vault`という名前のボールトを記述するコマンド*awsexampleVault*アカウントの下に*111122223333*。
```
aws glacier describe-vault --vault-name awsexamplevault --account-id 111122223333
```