使用AWS SDK for Java在单个操作中上传档案 - Amazon S3 Glacier

此页面仅适用于使用保管库的 S3 Glacier 服务的现有客户以及 2012 年以RESTAPI来的原始客户。

如果您正在寻找档案存储解决方案,我们建议您在亚马逊 S3、S3 Glacier 即时检索、S3 Glacier 灵活检索和 S3 Glacier Deep Archive Dee p Archive 中使用 S3 Glacier 存储类。要了解有关这些存储选项的更多信息,请参阅 Amazon S3 用户指南中的 S3 Glacier 存储类和使用 S3 Glacier 存储类的长期数据存储。这些存储类别使用 Amazon S3API,适用于所有区域,并且可以在 Amazon S3 控制台中进行管理。它们提供存储成本分析、存储镜头、高级可选加密功能等功能。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

使用AWS SDK for Java在单个操作中上传档案

适用于 Java 的 Amazon SDK 提供的高级和低级 API 都提供了上传档案的方法。

使用AWS SDK for Java的高级 API 上传档案

该高级 API 的 ArchiveTransferManager 类提供了您可以用来将档案上传到文件库的 upload 方法。

注意

您可以使用 upload 方法上传小型或大型档案。根据您要上传的档案大小,此方法会确定是在单一操作中上传档案,还是使用分段上传 API 分段上传档案。

示例:使用AWS SDK for Java的高级 API 上传档案

以下 Java 代码示例将档案上传到美国西部(俄勒冈州)区域 (us-west-2) 中的文件库 (examplevault)。有关受支持 AWS 区域和端点的列表,请参阅访问 Amazon S3 Glacier

有关如何运行以下示例的分步说明,请参阅使用 Eclipse 运行 Amazon S3 Glacier 的 Java 示例。您需要更新目标上传文件库名称和待上传文件名称旁显示的代码。

import java.io.File; import java.io.IOException; import java.util.Date; import com.amazonaws.auth.profile.ProfileCredentialsProvider; import com.amazonaws.services.glacier.AmazonGlacierClient; import com.amazonaws.services.glacier.transfer.ArchiveTransferManager; import com.amazonaws.services.glacier.transfer.UploadResult; public class ArchiveUploadHighLevel { public static String vaultName = "*** provide vault name ***"; public static String archiveToUpload = "*** provide name of file to upload ***"; public static AmazonGlacierClient client; public static void main(String[] args) throws IOException { ProfileCredentialsProvider credentials = new ProfileCredentialsProvider(); client = new AmazonGlacierClient(credentials); client.setEndpoint("https://glacier.us-west-2.amazonaws.com/"); try { ArchiveTransferManager atm = new ArchiveTransferManager(client, credentials); UploadResult result = atm.upload(vaultName, "my archive " + (new Date()), new File(archiveToUpload)); System.out.println("Archive ID: " + result.getArchiveId()); } catch (Exception e) { System.err.println(e); } } }

使用AWS SDK for Java低级 API 在单个操作中上传档案

该低级 API 为所有归档操作提供了方法。下面是使用 AWS SDK for Java 上传存档的步骤。

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

    您需要指定要上传档案的 AWS 区域。您使用此客户端执行的所有操作都会应用到该 AWS 区域。

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

    除了您要上传的数据以外,您还需要提供有效负载的校验和(SHA-256 树形哈希)、文件库名称、数据的内容长度和您的账户 ID。

    如果您不提供账户 ID,则系统会使用与您提供来对请求签名的证书相关联的账户 ID。有关更多信息,请参阅将 AWS SDK for Java 与 Amazon S3 Glacier 结合使用

  3. 以参数形式提供请求对象,运行 uploadArchive 方法。

    作为响应,Amazon S3 Glacier (S3 Glacier) 返回新上传的档案的档案 ID。

以下 Java 代码段说明了前面的步骤。

AmazonGlacierClient client; UploadArchiveRequest request = new UploadArchiveRequest() .withVaultName("*** provide vault name ***") .withChecksum(checksum) .withBody(new ByteArrayInputStream(body)) .withContentLength((long)body.length); UploadArchiveResult uploadArchiveResult = client.uploadArchive(request); System.out.println("Location (includes ArchiveID): " + uploadArchiveResult.getLocation());

示例:使用AWS SDK for Java低级 API 在单个操作中上传档案

以下 Java 代码示例使用AWS SDK for Java将档案上传到文件库 (examplevault)。有关如何运行以下示例的分步说明,请参阅使用 Eclipse 运行 Amazon S3 Glacier 的 Java 示例。您需要更新目标上传文件库名称和待上传文件名称旁显示的代码。

import java.io.ByteArrayInputStream; import java.io.File; import java.io.FileInputStream; import java.io.IOException; import java.io.InputStream; import com.amazonaws.auth.profile.ProfileCredentialsProvider; import com.amazonaws.services.glacier.AmazonGlacierClient; import com.amazonaws.services.glacier.TreeHashGenerator; import com.amazonaws.services.glacier.model.UploadArchiveRequest; import com.amazonaws.services.glacier.model.UploadArchiveResult; public class ArchiveUploadLowLevel { public static String vaultName = "*** provide vault name ****"; public static String archiveFilePath = "*** provide to file upload ****"; public static AmazonGlacierClient client; public static void main(String[] args) throws IOException { ProfileCredentialsProvider credentials = new ProfileCredentialsProvider(); client = new AmazonGlacierClient(credentials); client.setEndpoint("https://glacier.us-east-1.amazonaws.com/"); try { // First open file and read. File file = new File(archiveFilePath); InputStream is = new FileInputStream(file); byte[] body = new byte[(int) file.length()]; is.read(body); // Send request. UploadArchiveRequest request = new UploadArchiveRequest() .withVaultName(vaultName) .withChecksum(TreeHashGenerator.calculateTreeHash(new File(archiveFilePath))) .withBody(new ByteArrayInputStream(body)) .withContentLength((long)body.length); UploadArchiveResult uploadArchiveResult = client.uploadArchive(request); System.out.println("ArchiveID: " + uploadArchiveResult.getArchiveId()); } catch (Exception e) { System.err.println("Archive not uploaded."); System.err.println(e); } } }