文档

删除Bucket

更新时间:

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

前提条件

  • 已删除云盒Bucket中所有文件(Object)。

    • 手动删除少量Object的具体操作,请参见删除Object

    • 如果您的Object数量较多,建议结合生命周期规则进行批量删除。删除大量文件的具体操作,请参见生命周期规则

    重要

    如果Bucket已开启版本控制,请确保删除Bucket内所有当前版本和历史版本Object。

  • 已删除云盒Bucket中因分片上传或断点续传产生的碎片(Part)。

操作步骤

使用OSS控制台

  1. 登录OSS管理控制台

  2. 在左侧导航栏,选择数据服务 > 云盒Bucket,然后在Bucket列表中单击目标Bucket。

  3. 在左侧导航栏,单击删除Bucket

  4. 单击删除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。