Overview

初始化分块上传的方法.

功能描述

使用分块上传对象时，首先要进行初始化分片上传操作，获取对应分块上传的 uploadId，用于后续上传操 作. 分块上传适合于在弱网络或高带宽环境下上传较大的对象。

SDK 支持自行切分对象并分别调用uploadPart(UploadPartRequest) 或者uploadPartAsync(UploadPartRequest, CosXmlResultListener)上传各 个分块.

关于初始化分块上传的描述，请查看 https://cloud.tencent.com/document/product/436/7746.

示例

@code

QCloudInitiateMultipartUploadRequest* initRequest = [QCloudInitiateMultipartUploadRequest new];

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

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

// 将作为对象的元数据返回
initRequest.cacheControl = @"cacheControl";

initRequest.contentDisposition = @"contentDisposition";

// 定义 Object 的 ACL 属性。有效值：private，public-read-write，public-read；默认值：private
initRequest.accessControlList = @"public";

// 赋予被授权者读的权限。
initRequest.grantRead = @"grantRead";

// 赋予被授权者写的权限
initRequest.grantWrite = @"grantWrite";

// 赋予被授权者读写权限。 grantFullControl == grantWrite + grantRead
initRequest.grantFullControl = @"grantFullControl";

[initRequest setFinishBlock:^(QCloudInitiateMultipartUploadResult* outputObject,
                              NSError *error) {
    // 获取分块上传的 uploadId，后续的上传都需要这个 ID，请保存以备后续使用
    self->uploadId = outputObject.uploadId;

}];

[[QCloudCOSXMLService defaultCOSXML] InitiateMultipartUpload:initRequest];