Amazon Glacier
开发人员指南 (API 版本 2012-06-01)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

使用AWS SDK for Java在 Amazon Glacier 中检索文件库元数据

取回文件库的文件库元数据

您可以取回特定文件库或特定区域所有文件库的元数据。以下是使用适用于 Java 的 AWS 开发工具包低级 API 检索特定文件库的文件库元数据的步骤。

  1. 创建 AmazonGlacierClient 类(客户端)的实例。

    您需要指定文件库所在的 AWS 区域。您使用此客户端执行的所有操作都会应用到该区域。

  2. 通过创建一个 DescribeVaultRequest 类的实例提供请求信息。

    Amazon Glacier 要求您提供文件库名称和您的账户 ID。如果您不提供账户 ID,则系统会使用与您提供来对请求签名的证书相关联的账户 ID。有关更多信息,请参阅 在 Amazon Glacier 中使用 AWS SDK for Java

  3. 以参数形式提供请求数据元,以执行 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 的信息,请参阅描述文件库(获取文件库)

取回一个区域所有文件库的文件库元数据

此外,您还可以使用 listVaults 方法来取回特定区域所有文件库的元数据。

以下 Java 代码段会取回 us-west-2 区域的文件库的列表。该请求会将响应中返回的文件库数限制为 5 个。然后,该代码段会进行一系列 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 设置的 1000 个文件库。如果有更多文件库要列出,则响应 marker 字段会包含文件库的Amazon 资源名称 (ARN),新请求会从该名称处继续列表;否则,marker 字段为空。

请注意,列表中返回的每个文件库的信息与您通过调用特定文件库的 describeVault 方法获取的信息相同。

注意

listVaults 方法会调用底层 REST API(请参阅“列出文件库(获取文件库)”)。

示例:使用适用于 Java 的 AWS 开发工具包取回文件库元数据

有关工作代码示例,请参阅“示例:使用AWS SDK for Java创建文件库”。该 Java 代码示例会创建文件库并取回文件库元数据。