此页面仅适用于使用文件库和 2012 年原始 REST API 的 S3 Glacier 服务的现有客户。
如果您正在寻找归档存储解决方案,建议使用 Amazon S3 中的 S3 Glacier 存储类 S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive。要了解有关这些存储选项的更多信息,请参阅《Amazon S3 用户指南》中的 S3 Glacier 存储类
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用 Amazon S3 Glacier 中检索文件库元数据 适用于 .NET 的 Amazon SDK
检索文件库的文件库元数据
您可以检索特定文件库或特定 Amazon 区域内所有文件库的元数据。以下是使用 适用于 .NET 的 Amazon SDK低级 API 检索特定文件库的文件库元数据的步骤。
-
创建
AmazonGlacierClient
类(客户端)的实例。您需要指定文件库所在的 Amazon 区域。您使用此客户端执行的所有操作都适用于该 Amazon 区域。
-
通过创建一个
DescribeVaultRequest
类的实例提供请求信息。Amazon S3 Glacier(S3 Glacier)要求您提供文件库名称和您的账户 ID。如果您不提供账户 ID,则系统会使用与您提供来对请求签名的证书相关联的账户 ID。有关更多信息,请参阅 适用于 .NET 的 Amazon SDK 与 Amazon S3 Glacier 搭配使用。
-
以参数形式提供请求对象,运行
DescribeVault
方法。S3 Glacier 返回的文件库元数据信息在
DescribeVaultResult
对象中提供。
以下 C# 代码段说明了前面的步骤。此代码段检索美国西部(俄勒冈州)区域中现有文件库的元数据信息。
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 的信息,请参阅描述文件库(获取文件库)。
检索一个区域所有文件库的文件库元数据
您还可以使用该ListVaults
方法检索特定 Amazon 区域中所有文件库的元数据。
以下 C# 代码段检索美国西部(俄勒冈州)区域中的文件库的列表。该请求会将响应中返回的文件库数限制为 5 个。然后,该代码段会进行一系列ListVaults
调用,以从该 Amazon 地区检索整个保管库列表。
AmazonGlacierClient client; client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2); string lastMarker = null; Console.WriteLine("\n List of vaults in your account in the specific Amazon 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
值,则 S3 Glacier 最多返回 S3 Glacier API 设置的 10 个文件库。
请注意,列表中返回的每个文件库的信息与您通过调用特定文件库的 DescribeVault
方法获取的信息相同。
注意
ListVaults
方法会调用底层 REST API(请参阅“列出文件库(获取文件库)”)。
示例:使用的低级 API 检索文件库元数据 适用于 .NET 的 Amazon SDK
有关工作代码示例,请参阅“示例:使用的低级 API 进行文件库操作 适用于 .NET 的 Amazon SDK”。该 C# 代码示例会创建文件库并检索文件库元数据。