此页面仅适用于使用保管库的 S3 Glacier 服务的现有客户以及 2012 年以RESTAPI来的原始客户。
如果您正在寻找档案存储解决方案,我们建议您在亚马逊 S3、S3 Glacier 即时检索、S3 Glacier 灵活检索和 S3 Glacier Deep Archive Dee p Archive 中使用 S3 Glacier 存储类。要了解有关这些存储选项的更多信息,请参阅 Amazon S3 用户指南中的 S3 Glacier 存储类
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用Amazon SDK for .NET将档案上传到 S3 Glacier 中的文件库
以下 C# 代码示例使用Amazon SDK for .NET高级 API 将示例档案上传到文件库。在代码示例中,请注意以下情况:
-
该示例为指定的 Amazon S3 Glacier 区域端点创建
ArchiveTransferManager
类的实例。 -
该代码示例使用美国西部(俄勒冈州)区域 (
us-west-2
)。 -
该示例使用
Upload
类的ArchiveTransferManager
API 操作上传档案。对于小型档案,此操作会将档案直接上传到 S3 Glacier。对于大型档案,此操作将使用 S3 Glacier 的分段上传 API 操作将上传内容拆分为多个部分,以便在将数据流式传输到 S3 Glacier 时出错的情况下更好地进行错误恢复。
有关如何运行以下示例的分步说明,请参阅“运行代码示例”。您必须更新文件库名称和待上传档案文件名称旁显示的代码。
注意
S3 Glacier 在文件库中保留一份所有档案的清单。当您上传以下示例中的档案时,该档案直到文件库清单已更新后才会在管理控制台的文件库中显示。此更新通常每天进行一次。
例 —使用Amazon SDK for .NET 高级 API 上传档案
using System; using Amazon.Glacier; using Amazon.Glacier.Transfer; using Amazon.Runtime; namespace glacier.amazon.com.docsamples { class ArchiveUploadHighLevel_GettingStarted { static string vaultName = "examplevault"; static string archiveToUpload = "*** Provide file name (with full path) to upload ***"; public static void Main(string[] args) { try { var manager = new ArchiveTransferManager(Amazon.RegionEndpoint.USWest2); // Upload an archive. string archiveId = manager.Upload(vaultName, "getting started archive test", archiveToUpload).ArchiveId; Console.WriteLine("Copy and save the following Archive ID for the next step."); Console.WriteLine("Archive ID: {0}", archiveId); Console.WriteLine("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(); } } }