文档 | 腾讯云

请输入关键字

Recent Pages

文档

Download PDF

删除对象

最后更新时间：2021-06-11 16:47:09

下载PDF

简介

本文档提供关于对象的删除操作相关的 API 概览以及 SDK 示例代码。

API	操作名	操作描述
DELETE Object	删除单个对象	在存储桶中删除指定对象
DELETE Multiple Objects	删除多个对象	在存储桶中批量删除对象

SDK API 参考

SDK 所有接口的具体参数与方法说明，请参考 SDK API。

删除对象

功能说明

删除指定的对象（DELETE Object）。

示例代码一：删除单个对象

Objective-C

objective-c
QCloudDeleteObjectRequest* deleteObjectRequest = [QCloudDeleteObjectRequest new];
// 存储桶名称，格式为 BucketName-APPID
deleteObjectRequest.bucket = @"examplebucket-1250000000";

// 对象键，是对象在 COS 上的完整路径，如果带目录的话，格式为 "video/xxx/movie.mp4"
deleteObjectRequest.object = @"exampleobject";
[deleteObjectRequest setFinishBlock:^(id outputObject, NSError *error) {
   // outputObject 包含所有的响应 http 头部
   NSDictionary* info = (NSDictionary *) outputObject;
}];
[[QCloudCOSXMLService defaultCOSXML] DeleteObject:deleteObjectRequest];

说明：

更多完整示例，请前往 GitHub 查看。

Swift

swift
let deleteObject = QCloudDeleteObjectRequest.init();
// 存储桶名称，格式为 BucketName-APPID
deleteObject.bucket = "examplebucket-1250000000";

// 对象键，是对象在 COS 上的完整路径，如果带目录的话，格式为 "video/xxx/movie.mp4"
deleteObject.object = "exampleobject";
deleteObject.finishBlock = {(result,error)in
   if let result = result {
       // result 包含响应的 header 信息
   } else {
       print(error!);
   }
}
QCloudCOSXMLService.defaultCOSXML().deleteObject(deleteObject);

说明：

更多完整示例，请前往 GitHub 查看。

示例代码二：删除目录

Objective-C

objective-c
QCloudGetBucketRequest* request = [QCloudGetBucketRequest new];
// 存储桶名称，格式为 BucketName-APPID
request.bucket = @"examplebucket-1250000000";
// 单次返回的最大条目数量，默认1000
request.maxKeys = 100;
//要删除的目录名称：带'/'
request.prefix = @"prefix";
[request setFinishBlock:^(QCloudListBucketResult * result, NSError* error) {
   if(!error){
       NSMutableArray *deleteInfosArr = [NSMutableArray array];
       for (QCloudBucketContents *content in result.contents) {
           QCloudDeleteMultipleObjectRequest *delteRequest = [QCloudDeleteMultipleObjectRequest new];
           delteRequest.bucket = request.bucket;
            QCloudDeleteObjectInfo *object = [QCloudDeleteObjectInfo new];
           object.key = content.key;
           [deleteInfosArr addObject:object];
       }

       QCloudDeleteInfo *deleteInfos = [QCloudDeleteInfo new];
       deleteInfos.objects = [deleteInfosArr copy];

       QCloudDeleteMultipleObjectRequest *delteRequest = [QCloudDeleteMultipleObjectRequest new];
       delteRequest.bucket = @"examplebucket-1250000000";
       delteRequest.deleteObjects = deleteInfos;
       [delteRequest setFinishBlock:^(QCloudDeleteResult *outputObject, NSError *error) {
           NSLog(@"outputObject = %@",outputObject);
       }];
        [[QCloudCOSXMLService defaultCOSXML] DeleteMultipleObject:delteRequest];

   }
}];
[[QCloudCOSXMLService defaultCOSXML] GetBucket:request];

说明：

更多完整示例，请前往 GitHub 查看。

Swift

swift
let getBucketReq = QCloudGetBucketRequest.init();

// 存储桶名称，格式为 BucketName-APPID
getBucketReq.bucket = "examplebucket-1250000000";

// 单次返回的最大条目数量，默认1000
getBucketReq.maxKeys = 100;

//要删除的目录名称：带'/'
getBucketReq.prefix = "dir/";

getBucketReq.setFinish { (result, error) in
   if let result = result {
       let contents = result.contents;
       let infos = NSMutableArray.init();
       for content in contents {
           let info = QCloudDeleteObjectInfo.init();
           info.key = content.key;
           infos.add(info);
       }
       let mutipleDel = QCloudDeleteMultipleObjectRequest.init();
       // 要删除的文件集合
       let deleteInfos = QCloudDeleteInfo.init();
       // 存储桶名称，格式为 BucketName-APPID
       mutipleDel.bucket = "examplebucket-1250000000";

       deleteInfos.objects = infos as! [QCloudDeleteObjectInfo];

       // 布尔值，这个值决定了是否启动 Quiet 模式：
       // true：启动 Quiet 模式
       // false：启动 Verbose 模式
       // 默认值为 False
       deleteInfos.quiet = false;

       // 封装了需要批量删除的多个对象的信息
       mutipleDel.deleteObjects = deleteInfos;

       mutipleDel.setFinish { (result, error) in
           if let result = result {
               let deleted = result.deletedObjects
               let failed = result.deletedFailedObjects
           } else {
               print(error!);
           }
       }
       QCloudCOSXMLService.defaultCOSXML().deleteMultipleObject(mutipleDel);
   } else {
       print(error!);
   }
}
QCloudCOSXMLService.defaultCOSXML().getBucket(getBucketReq);

说明：

更多完整示例，请前往 GitHub 查看。

删除多个对象

功能说明

批量删除多个对象（DELETE Multiple Objects）。

示例代码一：批量删除对象

Objective-C

objective-c
QCloudDeleteMultipleObjectRequest* delteRequest = [QCloudDeleteMultipleObjectRequest new];
delteRequest.bucket = @"examplebucket-1250000000";
// 要删除的单个文件
QCloudDeleteObjectInfo* deletedObject0 = [QCloudDeleteObjectInfo new];
// 对象键，是对象在 COS 上的完整路径，如果带目录的话，格式为 "video/xxx/movie.mp4"
deletedObject0.key = @"exampleobject";
// 要删除的文件集合
QCloudDeleteInfo* deleteInfo = [QCloudDeleteInfo new];
// 布尔值，这个值决定了是否启动 Quiet 模式：
// true：启动 Quiet 模式
// false：启动 Verbose 模式
// 默认值为 False
deleteInfo.quiet = NO;
// 存放需要删除对象信息的数组
deleteInfo.objects = @[deletedObject0];
// 封装了需要批量删除的多个对象的信息
delteRequest.deleteObjects = deleteInfo;
[delteRequest setFinishBlock:^(QCloudDeleteResult* outputObject,
                              NSError *error) {
   // 可以从 outputObject 中获取 response 中 etag 或者自定义头部等信息

}];
[[QCloudCOSXMLService defaultCOSXML] DeleteMultipleObject:delteRequest];

说明：

更多完整示例，请前往 GitHub 查看。

Swift

swift
let mutipleDel = QCloudDeleteMultipleObjectRequest.init();
// 存储桶名称，格式为 BucketName-APPID
mutipleDel.bucket = "examplebucket-1250000000";
// 要删除的单个文件
let info1 = QCloudDeleteObjectInfo.init();
// 对象键，是对象在 COS 上的完整路径，如果带目录的话，格式为 "video/xxx/movie.mp4"
info1.key = "exampleobject";
let info2 = QCloudDeleteObjectInfo.init();
// 要删除的文件集合
let deleteInfos = QCloudDeleteInfo.init();
// 存放需要删除对象信息的数组
deleteInfos.objects = [info1,info2];
// 布尔值，这个值决定了是否启动 Quiet 模式：
// true：启动 Quiet 模式
// false：启动 Verbose 模式
// 默认值为 False
deleteInfos.quiet = false;
// 封装了需要批量删除的多个对象的信息
mutipleDel.deleteObjects = deleteInfos;
mutipleDel.setFinish { (result, error) in
   if let result = result {
       let deleted = result.deletedObjects
       let failed = result.deletedFailedObjects
   } else {
       print(error!);
   }
}
QCloudCOSXMLService.defaultCOSXML().deleteMultipleObject(mutipleDel);

说明：

更多完整示例，请前往 GitHub 查看。

示例代码二：删除带指定前缀的对象

Objective-C

objective-c
QCloudGetBucketRequest* request = [QCloudGetBucketRequest new];
// 存储桶名称，格式为 BucketName-APPID
request.bucket = @"examplebucket-1250000000";
// 单次返回的最大条目数量，默认1000
request.maxKeys = 100;
//如果要删除指定前缀的文件:prefix为文件名前缀
request.prefix = @"prefix";
[request setFinishBlock:^(QCloudListBucketResult * result, NSError* error) {
   if(!error){
       NSMutableArray *deleteInfosArr = [NSMutableArray array];
       for (QCloudBucketContents *content in result.contents) {
           QCloudDeleteMultipleObjectRequest *delteRequest = [QCloudDeleteMultipleObjectRequest new];
           delteRequest.bucket = request.bucket;
            QCloudDeleteObjectInfo *object = [QCloudDeleteObjectInfo new];
           object.key = content.key;
           [deleteInfosArr addObject:object];
       }

       QCloudDeleteInfo *deleteInfos = [QCloudDeleteInfo new];
       deleteInfos.objects = [deleteInfosArr copy];

       QCloudDeleteMultipleObjectRequest *delteRequest = [QCloudDeleteMultipleObjectRequest new];
       delteRequest.bucket = @"examplebucket-1250000000";
       delteRequest.deleteObjects = deleteInfos;
       [delteRequest setFinishBlock:^(QCloudDeleteResult *outputObject, NSError *error) {
           NSLog(@"outputObject = %@",outputObject);
       }];
        [[QCloudCOSXMLService defaultCOSXML] DeleteMultipleObject:delteRequest];

   }
}];
[[QCloudCOSXMLService defaultCOSXML] GetBucket:request];

说明：

更多完整示例，请前往 GitHub 查看。

Swift

swift
let getBucketReq = QCloudGetBucketRequest.init();

// 存储桶名称，格式为 BucketName-APPID
getBucketReq.bucket = "examplebucket-1250000000";

// 单次返回的最大条目数量，默认1000
getBucketReq.maxKeys = 100;

//如果要删除指定前缀的文件:prefix为文件名前缀
getBucketReq.prefix = "dir/";

getBucketReq.setFinish { (result, error) in
   if let result = result {
       let contents = result.contents;
       let infos = NSMutableArray.init();
       for content in contents {
           let info = QCloudDeleteObjectInfo.init();
           info.key = content.key;
           infos.add(info);
       }
       let mutipleDel = QCloudDeleteMultipleObjectRequest.init();
       // 要删除的文件集合
       let deleteInfos = QCloudDeleteInfo.init();
       // 存储桶名称，格式为 BucketName-APPID
       mutipleDel.bucket = "examplebucket-1250000000";

       deleteInfos.objects = infos as! [QCloudDeleteObjectInfo];

       // 布尔值，这个值决定了是否启动 Quiet 模式：
       // true：启动 Quiet 模式
       // false：启动 Verbose 模式
       // 默认值为 False
       deleteInfos.quiet = false;

       // 封装了需要批量删除的多个对象的信息
       mutipleDel.deleteObjects = deleteInfos;

       mutipleDel.setFinish { (result, error) in
           if let result = result {
               let deleted = result.deletedObjects
               let failed = result.deletedFailedObjects
           } else {
               print(error!);
           }
       }
       QCloudCOSXMLService.defaultCOSXML().deleteMultipleObject(mutipleDel);
   } else {
       print(error!);
   }
}
QCloudCOSXMLService.defaultCOSXML().getBucket(getBucketReq);

说明：

更多完整示例，请前往 GitHub 查看。

关于腾讯云
服务与支持
资源
用户中心
7x24 咨询热线
- 中国香港
  +852 800-964-163 (免费)
- +852 800 906 020 (免费)
- 美国
  +1 888-652-2736 (免费)
- +1 844 606 0804 (免费)
- 加拿大
  +1 888 605 7930 (免费)
- 英国
  +44 808 196 4551 (免费)
- 澳大利亚
  +61 1300 986 386 (免费)
- 韩国
  +82 080-899-3166 (免费；当地时间：9:00—12:00, 13:00-18:00)
- 更多本地服务热线陆续新增中

Recent Pages

删除对象

简介

SDK API 参考

删除对象

功能说明

示例代码一：删除单个对象

示例代码二：删除目录

删除多个对象

功能说明

示例代码一：批量删除对象

示例代码二：删除带指定前缀的对象

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？

关于腾讯云

服务与支持

资源

用户中心

7x24 咨询热线

注册

登录

Recent Pages

删除对象

简介

SDK API 参考

删除对象

功能说明

示例代码一：删除单个对象

示例代码二：删除目录

删除多个对象

功能说明

示例代码一：批量删除对象

示例代码二：删除带指定前缀的对象

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？

关于腾讯云

服务与支持

资源

用户中心

7x24 咨询热线