本文介绍如何单个或者批量删除文件。
警告 文件一旦删除将无法恢复,请谨慎使用删除操作。
注意事项
删除文件时,您需要具有对Object所在Bucket的写权限。
单个删除文件
以下代码用于删除examplebucket中的exampleobject.txt文件。
// 创建删除请求。 // 填写Bucket名称和Object完整路径。Object完整路径中不能包含Bucket名称。 DeleteObjectRequest delete = new DeleteObjectRequest("examplebucket", "exampleobject.txt"); // 异步删除。 OSSAsyncTask deleteTask = oss.asyncDeleteObject(delete, new OSSCompletedCallback<DeleteObjectRequest, DeleteObjectResult>() { @Override public void onSuccess(DeleteObjectRequest request, DeleteObjectResult result) { Log.d("asyncDeleteObject", "success!"); } @Override public void onFailure(DeleteObjectRequest request, ClientException clientExcepion, ServiceException serviceException) { // 请求异常。 if (clientExcepion != null) { // 客户端异常,例如网络异常等。 clientExcepion.printStackTrace(); } if (serviceException != null) { // 服务端异常。 Log.e("ErrorCode", serviceException.getErrorCode()); Log.e("RequestId", serviceException.getRequestId()); Log.e("HostId", serviceException.getHostId()); Log.e("RawMessage", serviceException.getRawMessage()); } } });
批量删除文件
批量删除文件时,每次最多删除1000个文件。
返回结果包括如下两种模式,默认返回模式为详细模式,请根据实际选择返回模式。
- 详细模式(verbose):未设置isQuiet或者设置isQuiet为false,表示返回所有删除的文件列表。
- 简单模式(quiet):设置isQuiet为true,表示只返回删除失败的文件列表。
以下代码用于删除examplebucket中指定的多个文件且只返回删除失败的文件列表。
// 设置需要删除的多个Object完整路径。Object完整路径中不能包含Bucket名称。 List<String> objectKeys = new ArrayList<String>(); objectKeys.add("exampleobject.txt"); objectKeys.add("testfolder/sampleobject.txt"); // 设置为简单模式,只返回删除失败的文件列表。 DeleteMultipleObjectRequest request = new DeleteMultipleObjectRequest("examplebucket", objectKeys, true); mOss.asyncDeleteMultipleObject(request, new OSSCompletedCallback<DeleteMultipleObjectRequest, DeleteMultipleObjectResult>() { @Override public void onSuccess(DeleteMultipleObjectRequest request, DeleteMultipleObjectResult result) { Log.i("DeleteMultipleObject", "success"); } @Override public void onFailure(DeleteMultipleObjectRequest request, ClientException clientException, ServiceException serviceException) { // 请求异常。 if (clientException != null) { // 客户端异常,例如网络异常等。 clientException.printStackTrace(); } if (serviceException != null) { // 服务端异常。 Log.e("ErrorCode", serviceException.getErrorCode()); Log.e("RequestId", serviceException.getRequestId()); Log.e("HostId", serviceException.getHostId()); Log.e("RawMessage", serviceException.getRawMessage()); } } });