当您不再需要保留某个云盒Bucket时,可将其删除,以免产生额外费用。
前提条件
-
已删除云盒Bucket中所有文件(Object)。
-
手动删除少量Object的具体操作,请参见删除云盒Object。
-
如果您的Object数量较多,建议结合生命周期规则进行批量删除。删除大量文件的具体操作,请参见云盒生命周期规则。
重要如果Bucket已开启版本控制,请确保删除Bucket内所有当前版本和历史版本Object。
-
-
已删除云盒Bucket中因分片上传或断点续传产生的碎片(Part)。
操作步骤
使用OSS控制台
登录OSS管理控制台。
-
在左侧导航栏,选择数据服务 > 云盒Bucket,然后在Bucket列表中单击目标Bucket。
-
在左侧导航栏,单击删除 Bucket。
- 单击删除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。