对象存储 OSS：iOS删除文件

注意事项

• 使用本文示例前您需要先通过自定义域名、STS等方式新建OSSClient，具体请参见初始化。

• 删除文件时，您需要具有对Object所在Bucket的写权限。

删除单个文件

以下代码用于删除examplebucket中的exampleobject.txt文件。

OSSDeleteObjectRequest * delete = [OSSDeleteObjectRequest new];
// 填写Bucket名称，例如examplebucket
delete.bucketName = @"examplebucket";
// 填写不包含Bucket名称在内的Object完整路径，例如exampleobject.txt。
delete.objectKey = @"exampleobject.txt";

OSSTask * deleteTask = [client deleteObject:delete];

[deleteTask continueWithBlock:^id(OSSTask *task) {
    if (!task.error) {
        // ...
    }
    return nil;
}];
// 实现同步阻塞等待任务完成。
// [deleteTask waitUntilFinished];

批量删除文件

批量删除文件时，每次最多删除1000个文件。

返回结果包括如下两种模式，默认返回模式为简单模式，请根据实际选择返回模式。

• 详细模式（verbose）：设置quiet为NO，表示返回所有删除的文件列表。

• 简单模式（quiet）：未设置quiet或者设置quiet为YES，表示只返回删除失败的文件列表。

以下代码用于删除examplebucket中指定的多个文件且只返回删除失败的文件列表。

OSSDeleteMultipleObjectsRequest *request = [OSSDeleteMultipleObjectsRequest new];
// 填写Bucket名称，例如examplebucket。
request.bucketName = @"examplebucket";
// 填写需要删除的多个Object完整路径，Object完整路径中不能包含Bucket名称。
request.keys = @[@"exampleobject.txt", @"testfolder/sampleobject.txt"];
// 设置为简单模式，只返回删除失败的文件列表。
request.quiet = YES;

OSSTask * deleteMultipleObjectsTask = [client deleteMultipleObjects:request];
[deleteMultipleObjectsTask continueWithBlock:^id(OSSTask *task) {
    if (!task.error) {
        OSSDeleteMultipleObjectsResult *result = task.result;
        NSLog(@"delete objects: %@", result.deletedObjects);
    } else {
        NSLog(@"delete objects failed, error: %@", task.error);
    }
    return nil;
}];
// 实现同步阻塞等待任务完成。
// [deleteTask waitUntilFinished];

相关文档

• 删除单个文件

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

• 批量删除文件

  关于删除多个文件的API接口说明，请参见DeleteMultipleObjects。

• 关于初始化OSSClient，请参见如何初始化OSSClient实例。