本文介紹如何單個或者大量刪除檔案。
警告
檔案一旦刪除將無法恢複,請謹慎使用刪除操作。
注意事項
刪除檔案時,您需要具有對Object所在Bucket的寫入權限。
使用本文樣本前您需要先通過自訂網域名、STS等方式建立OSSClient,具體請參見如何初始化Android端OSSClient執行個體。
單個刪除檔案
以下代碼用於刪除examplebucket中的exampleobject.txt檔案。
// 建立刪除請求。
// 依次填寫Bucket名稱(例如examplebucket)和Object完整路徑(例如exampledir/exampleobject.txt)。Object完整路徑中不能包含Bucket名稱。
DeleteObjectRequest delete = new DeleteObjectRequest("examplebucket", "exampledir/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);
oss.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());
}
}
});
相關文檔
刪除單個檔案
關於刪除單個檔案的API介面說明,請參見DeleteObject。
刪除多個檔案
關於刪除多個檔案的API介面說明,請參見DeleteMultipleObjects。
關於初始化OSSClient,請參見如何初始化Android端OSSClient執行個體。