删除云盒Bucket中不再需要保留的文件 - 对象存储 OSS

您可以通过多种方式删除云盒Bucket中不再需要保留的文件（Object）。

警告

Object删除后无法恢复，请在删除前确认Object已不再使用，请您谨慎操作。

删除规则

OSS支持手动或者自动删除单个或多个Object，删除规则说明如下：

手动删除

您可以通过OSS控制台、命令行工具ossutil、API、SDK、图形化管理工具ossbrowser的方式删除单个文件或多个文件。单次请求最多支持删除1000个文件，您可以通过多次请求实现删除更多文件或者文件夹。
自动删除

如果需要定期删除指定日期之前的文件，指定前缀的文件，或清空整个Bucket内的所有文件，推荐您配置生命周期规则自动删除文件。配置完成后，OSS会根据规则自动删除指定文件，减少删除请求次数，提升删除效率。更多信息，请参见云盒生命周期规则。

删除单个Object

使用阿里云SDK

支持通过Java、Python、Go SDK删除多个Object（Java SDK要求3.15.0及以上版本，Python SDK V2要求1.1.1及以上版本，Go SDK V2要求v1.2.1及以上版本）。云盒场景下，Python、Go SDK的操作调用方式与公共云OSS一致，创建客户端的方式请参见SDK支持。以下代码示例分别以Java、Python、Go SDK为例。

Java

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-hangzhou.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 = "cb-f8z7yvzgwfkl9q0h****";
        // 填写Object完整路径，完整路径中不能包含Bucket名称。
        String objectName = "exampleobject.txt";

        // 创建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 {
            // 删除文件或目录。如果要删除目录，目录必须为空。
            ossClient.deleteObject(bucketName, objectName);
        } 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();
            }
        }
    }
}

Python

# -*- coding: utf-8 -*-
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

# 设置Region为云盒所在的地域，例如cn-hangzhou。
cfg.region = "cn-hangzhou"

# 设置云盒ID。设置云盒ID后，SDK会自动将签名产品切换为oss-cloudbox。
cfg.cloud_box_id = "cb-f8z7yvzgwfkl9q0h****"

# 设置访问域名，格式为CloudboxId.Region.oss-cloudbox.aliyuncs.com。
cfg.endpoint = "cb-f8z7yvzgwfkl9q0h****.cn-hangzhou.oss-cloudbox.aliyuncs.com"

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

# 填写Bucket名称，例如examplebucket。
bucket_name = "examplebucket"
# 填写Object完整路径，完整路径中不能包含Bucket名称。
object_name = "exampleobject.txt"

# 删除单个Object。
result = client.delete_object(oss.DeleteObjectRequest(
    bucket=bucket_name,
    key=object_name,
))
print(f'status code: {result.status_code}')

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的默认配置，并设置访问凭证、地域、云盒ID及访问域名。
	// 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		// 设置Region为云盒所在的地域，例如cn-hangzhou。
		WithRegion("cn-hangzhou").
		// 设置访问域名，格式为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名称，例如examplebucket。
	bucketName := "examplebucket"
	// 填写Object完整路径，完整路径中不能包含Bucket名称。
	objectName := "exampleobject.txt"

	// 删除单个Object。
	result, err := client.DeleteObject(context.TODO(), &oss.DeleteObjectRequest{
		Bucket: oss.Ptr(bucketName),
		Key:    oss.Ptr(objectName),
	})
	if err != nil {
		log.Fatalf("failed to delete object %v", err)
	}
	log.Printf("delete object success, status code:%d\n", result.StatusCode)
}

使用命令行工具ossutil

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

使用REST API

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

关于删除单个Object的API接口说明，请参见DeleteObject。

删除多个Object