如何删除云盒Bucket_对象存储(OSS)-阿里云帮助中心

当您不再需要保留某个云盒Bucket时，可将其删除，以免产生额外费用。

前提条件

已删除云盒Bucket中所有文件（Object）。
- 手动删除少量Object的具体操作，请参见删除Object。
- 如果您的Object数量较多，建议结合生命周期规则进行批量删除。删除大量文件的具体操作，请参见生命周期规则。
重要
如果Bucket已开启版本控制，请确保删除Bucket内所有当前版本和历史版本Object。
已删除云盒Bucket中因分片上传或断点续传产生的碎片（Part）。

操作步骤

使用OSS控制台

登录OSS管理控制台。
在左侧导航栏，选择数据服务 > 云盒Bucket，然后在Bucket列表中单击目标Bucket。
在左侧导航栏，单击删除Bucket。
单击删除Bucket，然后按照页面指引完成删除操作。

使用阿里云SDK

仅支持通过Java SDK删除云盒Bucket，Java SDK要求3.15.0及以上版本。

import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.common.auth.DefaultCredentialProvider;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.ClientBuilderConfiguration;
import com.aliyun.oss.common.auth.CredentialsProviderFactory;
import com.aliyun.oss.common.auth.EnvironmentVariableCredentialsProvider;

public class Demo {

    public static void main(String[] args) throws Exception {
        // 填写云盒所在地域对应的Endpoint。
        String endpoint = "https://cb-f8z7yvzgwfkl9q0h****.cn-heyuan.oss-cloudbox.aliyuncs.com";
        // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // 填写云盒Bucket名称，例如examplebucket。
        String bucketName = "examplebucket";
        // 填写云盒Bucket所在地域。
        String region = "cn-hangzhou";
        // 填写云盒ID。
        String cloudBoxId = "cn-hangzhou-test-1";

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

        try {
            // 删除云盒Bucket。
            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();
            }
        }
    }
}

使用命令行工具ossutil

关于使用ossutil删除Bucket的具体操作，请参见删除Bucket。

使用REST API

如果您的程序自定义要求较高，您可以直接发起REST API请求。直接发起REST API请求需要手动编写代码计算签名。更多信息，请参见DeleteBucket。

常见问题

无法删除云盒Bucket怎么办？

无法删除的原因是云盒Bucket不为空或者权限不足，请按如下方式进行排查：

云盒Bucket不为空
云盒Bucket不为空不允许删除，请确保云盒Bucket中存储的文件（Object）和碎片（Part）已经全部删除。
权限不足
云盒Bucket为空，但是RAM用户权限不足。请按如下方式添加或修改权限：
- 没有oss-cloudbox:DeleteBucket权限：如果您作为RAM用户无法删除云盒Bucket，则请求拥有管理员权限的RAM用户在RAM Policy为您添加oss-cloudbox:DeleteBucket权限。
- oss-cloudbox:DeleteBucket授权效力为Deny：如果您在RAM Policy中拥有oss-cloudbox:DeleteBucket权限但仍然无法删除云盒Bucket，则Bucket Policy可能包含授权效力为Deny的oss-cloudbox:DeleteBucket权限。您必须将Deny修改为Allow或者直接删除此Bucket Policy，然后才能删除此Bucket。

删除云盒Bucket后，无法再次创建同名Bucket？

删除云盒Bucket后，需要等待数小时（通常为4到8个小时）才能再次创建同名的Bucket。请注意，删除Bucket后，任何人都可以使用该名称再次创建同名的Bucket。