全部产品
Search
文档中心

对象存储 OSS:删除云盒Bucket

更新时间:Sep 15, 2026

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

前提条件

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

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

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

    重要

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

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

操作步骤

使用OSS控制台

  1. 登录OSS管理控制台。

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

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

  4. 单击删除Bucket,然后按照页面指引完成删除操作。

使用阿里云SDK

支持通过Java、Python、Go SDK删除云盒Bucket(Java SDK要求3.15.0及以上版本,Python SDK V2要求1.1.1及以上版本,Go SDK V2要求v1.2.1及以上版本)。云盒场景下,Python、Go SDK的操作调用方式与公共云OSS一致,创建客户端的方式请参见SDK支持。

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实例。
        // 当OSSClient实例不再使用时,调用shutdown方法以释放资源。
        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();
            }
        }
    }
}
import alibabacloud_oss_v2 as oss

# 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

# 使用SDK的默认配置。
cfg = oss.config.load_default()
cfg.credentials_provider = credentials_provider
# 填写云盒Bucket所在地域,例如cn-hangzhou。
cfg.region = "cn-hangzhou"
# 填写云盒ID。设置云盒ID后,SDK会自动将签名产品切换为oss-cloudbox。
cfg.cloud_box_id = "cb-f8z7yvzgwfkl9q0h****"
# 填写云盒Bucket的数据域名,格式为CloudboxId.Region.oss-cloudbox.aliyuncs.com。
cfg.endpoint = "cb-f8z7yvzgwfkl9q0h****.cn-hangzhou.oss-cloudbox.aliyuncs.com"

# 创建OSS客户端。
client = oss.Client(cfg)

# 删除云盒Bucket。填写云盒Bucket名称,例如examplebucket。
result = client.delete_bucket(oss.DeleteBucketRequest(
    bucket="examplebucket"
))

print(f'status code: {result.status_code},'
      f' request id: {result.request_id}')
package main

import (
	"context"
	"log"

	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)

func main() {
	// 使用SDK的默认配置,并从环境变量中获取访问凭证。
	// 运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		// 填写云盒Bucket所在地域,例如cn-hangzhou。
		WithRegion("cn-hangzhou").
		// 填写云盒Bucket的数据域名,格式为CloudboxId.Region.oss-cloudbox.aliyuncs.com。
		WithEndpoint("cb-f8z7yvzgwfkl9q0h****.cn-hangzhou.oss-cloudbox.aliyuncs.com").
		// 填写云盒ID。设置云盒ID后,SDK会自动将签名产品切换为oss-cloudbox。
		WithCloudBoxId("cb-f8z7yvzgwfkl9q0h****")

	// 创建OSS客户端。
	client := oss.NewClient(cfg)

	// 删除云盒Bucket。填写云盒Bucket名称,例如examplebucket。
	request := &oss.DeleteBucketRequest{
		Bucket: oss.Ptr("examplebucket"),
	}
	result, err := client.DeleteBucket(context.TODO(), request)
	if err != nil {
		log.Fatalf("failed to delete bucket %v", err)
	}
	log.Printf("delete bucket result:%#v\n", result)
}

使用命令行工具ossutil

关于使用ossutil删除Bucket的具体操作, 请参见delete-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。