删除场景（Java SDK）--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

删除场景（Java SDK）

最近更新时间：2024.02.04 18:31:02首次发布时间：2023.01.19 14:37:16

本文介绍删除对象的常用场景代码。

注意事项

要删除对象，您的账号必须具备 tos:DeleteObject 权限，具体操作请参见权限配置指南。
要删除多版本对象，您的账号必须具备tos:DeleteObjectVersion权限，具体操作请参见权限配置指南。
请您谨慎使用删除操作，文件删除后将无法恢复。

删除单个对象

关于删除单个普通对象的操作示例，请参见删除指定对象。

删除指定版本对象

关于删除单个多版本对象的操作示例，请参见删除指定版本对象。

删除指定目录下的所有对象

注意

此操作会删除指定目录下的所有对象，请谨慎使用。

关于删除指定目录下所有对象的操作示例，请参见删除桶中指定前缀的对象。

删除指定目录下的所有多版本对象

注意

此操作会删除指定目录下的所有多版本对象，请谨慎使用。

关于删除指定目录下所有对象所有版本的操作示例，请参见删除多版本对象——删除指定前缀下的所有对象。

清空桶内指定前缀下所有对象的未合并的分片上传任务

以下代码展示如何删除桶 bucket-example 中指定前缀下所有对象的未合并的分片上传任务。

import com.volcengine.tos.TOSV2;
import com.volcengine.tos.TOSV2ClientBuilder;
import com.volcengine.tos.TosClientException;
import com.volcengine.tos.TosServerException;
import com.volcengine.tos.model.object.*;

public class AbortMultipartUploadWithPrefixExample {
    public static void main(String[] args) {
        String endpoint = "your endpoint";
        String region = "your region";
        String accessKey = System.getenv("TOS_ACCESS_KEY");
        String secretKey = System.getenv("TOS_SECRET_KEY");

        String bucketName = "bucket-example";
        String prefix = "example_dir/";

        TOSV2 tos = new TOSV2ClientBuilder().build(region, endpoint, accessKey, secretKey);

        try{
            boolean isTruncated = true;
            String keyMarker = null;
            String uploadIdMarker = null;
            while (isTruncated) {
                ListMultipartUploadsV2Input input = new ListMultipartUploadsV2Input().setBucket(bucketName)
                        .setKeyMarker(keyMarker).setUploadIDMarker(uploadIdMarker).setPrefix(prefix);
                ListMultipartUploadsV2Output output = tos.listMultipartUploads(input);
                System.out.printf("listMultipartUploads succeed, is truncated? %b, next uploadIDMarker is %s, " +
                        "next keyMarker is %s.\n", output.isTruncated(), output.getNextUploadIdMarker(), output.getNextKeyMarker());
                if (output.getUploads() != null) {
                    for (int i = 0; i < output.getUploads().size(); i++) {
                        ListedUpload upload = output.getUploads().get(i);
                        AbortMultipartUploadInput abort = new AbortMultipartUploadInput().setBucket(bucketName)
                                .setKey(upload.getKey()).setUploadID(upload.getUploadID());
                        tos.abortMultipartUpload(abort);
                        System.out.println("Aborted upload is " + upload);
                    }
                }
                isTruncated = output.isTruncated();
                keyMarker = output.getNextKeyMarker();
                uploadIdMarker = output.getNextUploadIdMarker();
            }
        } catch (TosClientException e) {
            // 操作失败，捕获客户端异常，一般情况是请求参数错误，此时请求并未发送
            System.out.println("abortMultipartUpload failed");
            System.out.println("Message: " + e.getMessage());
            if (e.getCause() != null) {
                e.getCause().printStackTrace();
            }
        } catch (TosServerException e) {
            // 操作失败，捕获服务端异常，可以获取到从服务端返回的详细错误信息
            System.out.println("abortMultipartUpload failed");
            System.out.println("StatusCode: " + e.getStatusCode());
            System.out.println("Code: " + e.getCode());
            System.out.println("Message: " + e.getMessage());
            System.out.println("RequestID: " + e.getRequestID());
        } catch (Throwable t) {
            // 作为兜底捕获其他异常，一般不会执行到这里
            System.out.println("abortMultipartUpload failed");
            System.out.println("unexpected exception, message: " + t.getMessage());
        }
    }
}