Overview

简单复制对象的方法.

功能描述

COS 中复制对象可以完成如下功能:

创建一个新的对象副本.

复制对象并更名，删除原始对象，实现重命名

修改对象的存储类型，在复制时选择相同的源和目标对象键，修改存储类型.

在不同的腾讯云 COS 地域复制对象.

修改对象的元数据，在复制时选择相同的源和目标对象键，并修改其中的元数据,复制对象时，默认将继承原对象的元数据， 但创建日期将会按新对象的时间计算.

当复制的对象小于等于 5 GB ，可以使用简单复制（https://cloud.tencent.com/document/product/436/14117)..)

当复制对象超过 5 GB 时，必须使用分块复制（https://cloud.tencent.com/document/product/436/14118 ） 来实现复制.

关于简单复制接口的具体描述，请查看https://cloud.tencent.com/document/product/436/10881.

示例

@code

QCloudPutObjectCopyRequest* request = [[QCloudPutObjectCopyRequest alloc] init];

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

 // 对象键，是对象在 COS 上的完整路径，如果带目录的话，格式为 "dir1/object1"
 request.object = @"exampleobject";

 // 是否拷贝元数据，枚举值：Copy，Replaced，默认值 Copy。
 // 假如标记为 Copy，忽略 Header 中的用户元数据信息直接复制
 // 假如标记为 Replaced，按 Header 信息修改元数据。当目标路径和原路径一致，即用户试图修改元数据时，必须为 Replaced
 request.metadataDirective = @"Copy";

 // 定义 Object 的 ACL 属性，有效值：private，public-read，default。
 // 默认值：default（继承 Bucket 权限）。
 // 注意：当前访问策略条目限制为1000条，如果您无需进行 Object ACL 控制，请填 default
 // 或者此项不进行设置，默认继承 Bucket 权限。
 request.accessControlList = @"default";

 // 源对象所在的路径
 request.objectCopySource =
 @"sourcebucket-1250000000.cos.ap-guangzhou.myqcloud.com/sourceObject";

 // 指定源文件的 versionID，只有开启或开启后暂停的存储桶，才会响应此参数
 request.versionID = @"objectVersion1";

 [request setFinishBlock:^(QCloudCopyObjectResult * _Nonnull result,
                           NSError * _Nonnull error) {
     // result 返回具体信息

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