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

使用适用于 .NET 的 AWS 开发工具包在 Amazon Glacier 中创建文件库

适用于 .NET 的 AWS 开发工具包所提供的高级 API 和低级 API 各提供了一个方法来创建文件库。

使用适用于 .NET 的 AWS 开发工具包高级 API 创建文件库

该高级 API 的 ArchiveTransferManager 类提供了您可以用来在 AWS 区域创建文件库的 CreateVault 方法。

示例:使用适用于 .NET 的 AWS 开发工具包高级 API 进行文件库操作

以下 C# 代码示例在美国西部(俄勒冈)区域创建了文件库,然后删除了该文件库。有关您可以在其中创建文件库的 AWS 区域的列表,请参阅访问 Amazon Glacier

有关如何运行以下示例的分步说明,请参阅运行代码示例。您需要更新文件库名称旁显示的代码。

using System; using Amazon.Glacier; using Amazon.Glacier.Transfer; using Amazon.Runtime; namespace glacier.amazon.com.docsamples { class VaultCreateDescribeListVaultsDeleteHighLevel { static string vaultName = "*** Provide vault name ***"; public static void Main(string[] args) { try { var manager = new ArchiveTransferManager(Amazon.RegionEndpoint.USWest2); manager.CreateVault(vaultName); Console.WriteLine("Vault created. To delete the vault, press Enter"); Console.ReadKey(); manager.DeleteVault(vaultName); Console.WriteLine("\nVault deleted. To continue, press Enter"); Console.ReadKey(); } catch (AmazonGlacierException e) { Console.WriteLine(e.Message); } catch (AmazonServiceException e) { Console.WriteLine(e.Message); } catch (Exception e) { Console.WriteLine(e.Message); } Console.WriteLine("To continue, press Enter"); Console.ReadKey(); } } }

使用适用于 .NET 的 AWS 开发工具包低级 API 创建文件库

该低级 API 为所有文件库操作提供了方法,包括创建和删除文件库、获取文件库描述,以及获取特定区域创建的文件库的列表。以下是使用适用于 .NET 的 AWS 开发工具包创建文件库的步骤。

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

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

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

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

  3. 以参数形式提供请求数据元,以执行 CreateVault 方法。

    Amazon Glacier 返回的响应在 CreateVaultResponse 对象中提供。

示例:使用适用于 .NET 的 AWS 开发工具包低级 API 进行文件库操作

以下 C# 示例说明了前面的步骤。本示例将在 美国西部(俄勒冈)区域 中创建文件库。此外,该代码示例还取回了文件库信息,列出了同一区域的所有文件库,然后删除了创建的文件库。打印的 Location 是文件库的相对 URI,该 URI 包括您的账户 ID、区域和文件库名称。

注意

有关底层 REST API 的信息,请参阅创建文件库(设置文件库)

有关如何运行以下示例的分步说明,请参阅运行代码示例。您需要更新文件库名称旁显示的代码。

using System; using Amazon.Glacier; using Amazon.Glacier.Model; using Amazon.Runtime; namespace glacier.amazon.com.docsamples { class VaultCreateDescribeListVaultsDelete { static string vaultName = "*** Provide vault name ***"; static AmazonGlacierClient client; public static void Main(string[] args) { try { using (client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2)) { Console.WriteLine("Creating a vault."); CreateAVault(); DescribeVault(); GetVaultsList(); Console.WriteLine("\nVault created. Now press Enter to delete the vault..."); Console.ReadKey(); DeleteVault(); } } catch (AmazonGlacierException e) { Console.WriteLine(e.Message); } catch (AmazonServiceException e) { Console.WriteLine(e.Message); } catch (Exception e) { Console.WriteLine(e.Message); } Console.WriteLine("To continue, press Enter"); Console.ReadKey(); } static void CreateAVault() { CreateVaultRequest request = new CreateVaultRequest() { VaultName = vaultName }; CreateVaultResponse response = client.CreateVault(request); Console.WriteLine("Vault created: {0}\n", response.Location); } static void DescribeVault() { DescribeVaultRequest describeVaultRequest = new DescribeVaultRequest() { VaultName = vaultName }; 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 ); } static void GetVaultsList() { string lastMarker = null; Console.WriteLine("\n List of vaults in your account in the specific region ..."); do { ListVaultsRequest request = new ListVaultsRequest() { 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); } static void DeleteVault() { DeleteVaultRequest request = new DeleteVaultRequest() { VaultName = vaultName }; DeleteVaultResponse response = client.DeleteVault(request); } } }