使用 适用于 Java 的 Amazon SDK - Amazon S3 Glacier
示例：使用删除档案 适用于 Java 的 Amazon SDK
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

此页面仅适用于使用文件库和 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 存储类和使用 S3 Glacier 存储类的长期数据存储。这些存储类使用 Amazon S3 API，适用于所有区域，并且可以在 Amazon S3 控制台中管理。它们提供存储成本分析、Storage Lens 存储分析功能、高级可选加密功能等功能。

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

使用 适用于 Java 的 Amazon SDK

以下是使用 适用于 Java 的 Amazon SDK 低级 API 删除档案的步骤。

  1. 创建 AmazonGlacierClient 类（客户端）的实例。

    您需要指定存储要删除的档案的 Amazon 区域。您使用此客户端执行的所有操作都适用于该 Amazon 区域。

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

    您需要提供档案 ID、文件库名称和您的账户 ID。如果您不提供账户 ID，则系统会使用与您提供来对请求签名的证书相关联的账户 ID。有关更多信息，请参阅 适用于 Java 的 Amazon SDK 与 Amazon S3 Glacier 搭配使用。

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

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

AmazonGlacierClient client;

DeleteArchiveRequest request = new DeleteArchiveRequest()
    .withVaultName("*** provide a vault name ***")
    .withArchiveId("*** provide an archive ID ***");

client.deleteArchive(request);

注意

有关底层 REST API 的信息，请参阅删除档案。

示例：使用删除档案 适用于 Java 的 Amazon SDK

以下 Java 代码示例 适用于 Java 的 Amazon SDK 使用删除档案。有关如何运行此示例的 step-by-step说明，请参阅使用 Eclipse 运行 Amazon S3 Glacier 的 Java 示例。您需要更新文件库名称和待删除档案 ID 旁显示的代码。

import java.io.IOException;

import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.glacier.AmazonGlacierClient;
import com.amazonaws.services.glacier.model.DeleteArchiveRequest;

public class ArchiveDelete {

    public static String vaultName = "*** provide vault name ****";
    public static String archiveId = "*** provide archive ID***";
    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 {

            // Delete the archive.
            client.deleteArchive(new DeleteArchiveRequest()
                .withVaultName(vaultName)
                .withArchiveId(archiveId));
            
            System.out.println("Deleted archive successfully.");
            
        } catch (Exception e) {
            System.err.println("Archive not deleted.");
            System.err.println(e);
        }
    }
}