如何通过JavaSDK删除存储空间_对象存储(OSS)-阿里云帮助中心

如果您希望某个存储空间（Bucket）停止计费，需要删除该Bucket。如果您希望OSS服务停止计费，以达到关闭OSS服务的效果，需要删除当前账号下的所有Bucket。

警告

删除Bucket后，该Bucket名称会被释放，删除的Bucket名称存在被其他人占用的风险。若需保留名称，建议您清空Bucket内容而非删除Bucket。
删除Bucket后，Bucket中的数据无法恢复，请在删除前确认数据已不再使用。如果需要继续使用Bucket中的数据，请提前做好备份。关于备份的更多信息，请参见备份Bucket。

注意事项

本文以华东1（杭州）外网Endpoint为例。如果您希望通过与OSS同地域的其他阿里云产品访问OSS，请使用内网Endpoint。关于OSS支持的Region与Endpoint的对应关系，请参见OSS地域和访问域名。
本文以从环境变量读取访问凭证为例。如何配置访问凭证，请参见Java配置访问凭证。
本文以OSS域名新建OSSClient为例。如果您希望通过自定义域名、STS等方式新建OSSClient，请参见常见场景配置示例。

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限，需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。

API	Action	说明
DeleteBucket	`oss:DeleteBucket`	删除Bucket。

删除Bucket前需要清理的资源

删除Bucket前要清理资源，大部分用户往往Bucket中只有文件，少量用户使用了高级功能会涉及其他配置项。OSS控制台支持自动检测需要清理的资源，建议使用OSS控制台清理。

（大部分用户涉及清理的资源）Bucket中的所有文件。
如果文件数量较少，可以选择手动删除。如果文件数量较多，可以选择使用生命周期自动批量删除。此外，如果Bucket开启了版本控制，需要清理所有当前版本和历史版本的文件。
（少量用户使用了高级功能涉及清理的配置项）
- 分片上传或断点续传产生的碎片（Part）。具体操作，请参见删除碎片。
- 接入点。具体操作，请参见接入点。
- 对象FC接入点。具体操作，请参见对象FC接入点。
- 加速器。具体操作，请参见删除加速器。
- Livechannel。具体操作，请参见DeleteLiveChannel。

示例代码

以下代码用于删除存储空间examplebucket：

import com.aliyun.oss.*;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.common.comm.SignVersion;

public class Demo {

    public static void main(String[] args) throws Exception {
        // Endpoint以华东1（杭州）为例，其它Region请按实际情况填写。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // 填写Bucket名称，例如examplebucket。
        String bucketName = "examplebucket";
        // 填写Bucket所在地域。以华东1（杭州）为例，Region填写为cn-hangzhou。
        String region = "cn-hangzhou";

        // 创建OSSClient实例。
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(clientBuilderConfiguration)
                .region(region)
                .build();

        try {
            // 删除存储空间。
            ossClient.deleteBucket(bucketName);
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

Java删除存储空间

注意事项

权限说明

删除Bucket前需要清理的资源

示例代码

相关文档