**このページは、ボールトと 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 でのボールトメタデータの取得 AWS SDK for Java
<a name="retrieving-vault-info-sdk-java"></a>

**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)

## 特定のボールトのボールトメタデータの取得
<a name="retrieve-vault-info-sdk-java-lowlevel-one-vault"></a>

特定のボールトまたは特定の 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)」を参照してください。

## リージョン内のすべてのボールトのボールトメタデータの取得
<a name="retrieve-vault-info-sdk-java-lowlevel-all-vaults"></a>

`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<DescribeVaultOutput> 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 によるボールトメタデータの取得
<a name="retrieving-vault-info-sdk-java-example"></a>

コード例については、「[例: AWS SDK for Java を使用したボールトの作成](creating-vaults-sdk-java.md#creating-vaults-sdk-java-example)」を参照してください。この Java コード例では、ボールトを作成し、ボールトメタデータを取得します。