IOS-文档中心-金山云

KS3 SDK for iOS使用指南

SDK下载地址

点击下载

开发前准备

SDK使用准备

申请AccessKey、SecretKey

SDK配置

SDK以动态库的形式呈现。请将KS3iOSSDK.framework添加到项目工程中。如果开发工具是Xcode6，请在project->target->General中的‘Embedded Binaries‘中添加KS3iOSSDK.framework。

运行环境

支持iOS6及以上版本

安全性

使用场景

由于在App端明文存储AccessKey、SecretKey是极不安全的，因此推荐的使用场景如下图所示：

KS3Client初始化

利用AccessKey、SecretKey初始化

对应的初始化代码如下：

[[KS3Client initialize] connectWithAccessKey:strAccessKey withSecretKey:strSecretKey];

常见术语介绍

Object（对象，文件）

在KS3中，用户操作的基本数据单元是Object。单个Object允许存储0~48.8TB的数据。 Object 包含key和data。其中，key是Object的名字；data是Object 的数据。key为UTF-8编码，且编码后的长度不得超过1024个字符。

Key（文件名）

即Object的名字，key为UTF-8编码，且编码后的长度不得超过1024个字符。Key中可以带有斜杠，当Key中带有斜杠的时候，将会自动在控制台里组织成目录结构。

其他术语请参考概念与术语

SDK介绍及使用

核心类介绍

KS3Client 封装接入Web Service的一系列操作，提供更加便利的接口以及回调。

为方便开发者使用，SDK在REST API接口返回值基础上进行了封装，具体更多封装类详情请见
SDK-REST API

资源管理操作

List Bucket 列出客户所有的Bucket信息
Create Bucket 创建一个新的Bucket
Delete Bucket 删除指定Bucket
Get Bucket ACL 获取Bucket的ACL
Put Bucket ACL 设置Bucket的ACL
Head Bucket 查询是否已经存在指定Bucket
Get Object 下载Object数据
Head Object 查询是否已经存在指定Object
Delete Object 删除指定Object
Get Object ACL 获得Bucket的acl
Put Object ACL 上传object的acl
List Objects 列举Bucket内的Object
Put Object 上传Object数据
Initiate Multipart Upload 调用这个接口会初始化一个分块上传
Upload Part 上传分块
List Parts 罗列出已经上传的块
Abort Multipart Upload 取消分块上传
Complete Multipart Upload 组装所有分块上传的文件
Multipart Upload Example Code 分块上传代码示例
Upload Manager 基于分块上传的简单上传接口

Service操作

List Bucket

列出客户所有的 Bucket 信息

方法名：

- (NSArray *)listBuckets:(KS3ListBucketsRequest *)request

参数说明：

返回结果：

客户所有的bucket列表，列表中每个元素是KS3Buckket对象

代码示例：

KS3ListBucketsRequest *request = [[KS3ListBucketsRequest alloc] init];
[request setBucket:@"bucket"];
NSArray *arrBuckets = [[KS3Client initialize] listBuckets:request];

Bucket操作

Creat Bucket

创建一个新的Bucket

方法名：

- (KS3CreateBucketResponse *)createBucket:(KS3CreateBucketRequest *)request

参数说明：

bucketName：指定的Bucket名称

返回结果：

创建Bucket的HTTP请求响应

代码示例：

KS3CreateBucketRequest *request = [[KS3CreateBucketRequest alloc] initWithName:@"bucket"];
KS3CreateBucketResponse *response = [[KS3Client initialize] createBucket:request];

Delete Bucket

删除指定Bucket

方法名：

- (KS3DeleteBucketResponse *)deleteBucket:(KS3DeleteBucketRequest *)bucketName;

参数说明：

bucketName ：指定的Bucket名称

返回结果：

删除Bucket的HTTP请求响应

代码示例：

KS3DeleteBucketRequest *request = [[KS3DeleteBucketRequest alloc] initWithName:@"bucket"];
KS3DeleteBucketResponse *response = [[KS3Client initialize] deleteBucket:request];

Get Bucket ACL

获取Bucket的ACL

方法名：

- (KS3GetACLResponse *)getBucketACL:(KS3GetACLRequest *)getACLRequest

参数说明：

getACLRequest：获取Bucket ACL的KS3GetACLRequest对象

返回结果：

获取Bucket ACL的HTTP请求响应

代码示例：

KS3GetACLRequest * getACLRequest = [[KS3GetACLRequest alloc] initWithName: @"blues111"];
KS3GetACLResponse * response = [[KS3Client initialize] getBucketACL: getACLRequest];
KS3BucketACLResult * result = response.listBucketsResult;
if (response.httpStatusCode == 200) {
    NSLog(@"Get bucket acl success!");

    NSLog(@"Bucket owner ID:          %@", result.owner.ID);
    NSLog(@"Bucket owner displayName: %@", result.owner.displayName);

    for (KS3Grant * grant in result.accessControlList) {
        NSLog(@"%@", grant.grantee.ID);
        NSLog(@"%@", grant.grantee.displayName);
        NSLog(@"%@", grant.grantee.URI);
        NSLog(@"%@", grant.permission);
    }
} 
else {
    NSLog(@"Get bucket acl error: %@", response.error.description);
}

Put Bucket ACL

设置Bucket的ACL，以AccessControlList

方法名：

- (KS3SetGrantACLResponse *)setGrantACL:(KS3SetGrantACLRequest *)setGrantACLRequest;

参数说明：

setGrantACLRequest：设置Bucket Grant ACL的KS3SetGrantACLRequest对象

返回结果：

设置Bucket Grant ACL的HTTP请求响应

代码示例：

KS3GrantAccessControlList * acl = [[KS3GrantAccessControlList alloc] init];
//设置权限为公共读
[acl setGrantControlAccess: KingSoftYun_Grant_Permission_Read];
//设置被授权人的id和name
acl.identifier = @"523678123";
acl.displayName = @"blues111";
KS3SetGrantACLRequest * request = [[KS3SetGrantACLRequest alloc] initWithName: @""accessACL: acl];
KS3SetGrantACLResponse * response = [[KS3Client initialize] setGrantACL: request];
if (response.httpStatusCode == 200) {
    NSLog(@"Set grant acl success!");
} 
else {
    NSLog(@"Set grant acl error: %@", response.error.description);
}

Head Bucket

查询是否已经存在指定Bucket

方法名：

- (KS3HeadBucketResponse *)headBucket:(KS3HeadBucketRequest *)headBucketRequest

参数说明：

headBucketRequest:查询是否已存在指定的Bucket的KS3HeadBucketRequest请求

返回结果：

查询是否已存在指定的Bucket的HTTP请求响应

代码示例：

KS3HeadBucketRequest * request = [[KS3HeadBucketRequest alloc] initWithName: @"blues111"];
KS3HeadBucketResponse * response = [[KS3Client initialize] headBucket: request];
if (response.httpStatusCode == 200) {
    NSLog(@"Head bucket success!");
} 
else {
    NSLog(@"Head bucket error: %@", response.error.description);
}

Object操作

Get Object

下载该Object数据

方法名：

- (KS3DownLoad *)downloadObjectWithBucketName:(NSString *)strBucketName key:(NSString *)strObject downloadBeginBlock:(KS3DownloadBeginBlock)downloadBeginBlock downloadFileCompleteion:(KS3DownloadFileCompleteionBlock)downloadFileCompleteion downloadProgressChangeBlock:(KS3DownloadProgressChangeBlock)downloadProgressChangeBlock failedBlock:(KS3DownloadFailedBlock)failedBlock;

参数说明：

strBucketName：指定的Bucket名称
strObjName：指定的Object名称
downloadBeginBlock：表示下载开始的block
downloadFileCompleteion：表示下载完成后的block
downloadProgressChangeBlock:表示下载中的block
failedBlock：表示错误处理的block

返回结果：

下载Object的KS3DownLoad对象

代码示例：

[[KS3Client initialize] downloadObjectWithBucketName: @"photo_hor.jpeg"key: @"alert1"downloadBeginBlock: ^(KS3DownLoad * aDownload, NSURLResponse * responseHeaders) {

}downloadFileCompleteion: ^(KS3DownLoad * aDownload, NSString * filePath) {

}downloadProgressChangeBlock: ^(KS3DownLoad * aDownload, double newProgress) {

}failedBlock: ^(KS3DownLoad * aDownload, NSError * error) {

}];

Head Object

查询是否已经存在指定Object

方法名：

- (KS3HeadObjectResponse *)headObject:(KS3HeadObjectRequest *)headObjectRequest

参数说明：

headObjectRequest：查询Object是否存在的KS3HeadObjectRequest对象

返回结果：

查询指定Object是否存在的HTTP请求响应

代码示例：

KS3HeadObjectRequest * headObjRequest = [[KS3HeadObjectRequest alloc] initWithName: strBucketName withKeyName: strObjectName];
KS3HeadObjectResponse * response = [[KS3Client initialize] headObject: headObjRequest];
if (response.httpStatusCode == 200) {
    NSLog(@"Head object success!");
} 
else {
    NSLog(@"Head object error: %@", response.error.description);
}

Delete Object

删除指定Object

方法名：

- (KS3DeleteObjectResponse *)deleteObject:(KS3DeleteObjectRequest *)deleteObjectRequest;

参数说明：

deleteObjectRequest：删除Object的KS3DeleteObjectRequest对象

返回结果：

删除指定Object是否存在的HTTP请求响应

代码示例：

KS3DeleteObjectRequest * deleteObjRequest = [[KS3DeleteObjectRequest alloc] initWithName: strBucketName withKeyName: strObjectName];
KS3DeleteObjectResponse * response = [[KS3Client initialize] deleteObject: deleteObjRequest];
if (response.httpStatusCode == 200) {
    NSLog(@"Delete object success!");
} 
else {
    NSLog(@"Delete object error: %@", response.error.description);
}

Get Object ACL

获得Object的acl

方法名：

- (KS3GetObjectACLResponse *)getObjectACL:(KS3GetObjectACLRequest *)getObjectACLRequest;

参数说明：

getObjectACLRequest：获取Object ACL的KS3GetObjectACLRequest对象

返回结果：

获取Object ACL的HTTP请求响应

代码示例：

KS3GetObjectACLRequest * getObjectACLRequest = [[KS3GetObjectACLRequest alloc] initWithName: strBucketName withKeyName: strObjectName];
KS3GetObjectACLResponse * response = [[KS3Client initialize] getObjectACL: getObjectACLRequest];
KS3BucketACLResult * result = response.listBucketsResult;
if (response.httpStatusCode == 200) {

    NSLog(@"Object owner ID:          %@", result.owner.ID);
    NSLog(@"Object owner displayName: %@", result.owner.displayName);

    for (KS3Grant * grant in result.accessControlList) {
        NSLog(@"%@", grant.grantee.ID);
        NSLog(@"%@", grant.grantee.displayName);
        NSLog(@"%@", grant.grantee.URI);
        NSLog(@"%@", grant.permission);
    }
} 
else {
    NSLog(@"Get object acl error: %@", response.error.description);
}

Put Object ACL

上传object的acl，以CannedAccessControlList形式

方法名：

- (KS3SetObjectACLResponse *)setObjectACL:(KS3SetObjectACLRequest *)setObjectACLRequest;

参数说明：

setObjectACLRequest：设置Object ACL的KS3SetObjectACLRequest对象

返回结果：

获取Object ACL的HTTP请求响应

代码示例：

KS3AccessControlList * acl = [[KS3AccessControlList alloc] init];
//设置object的ACL为私有
[acl setContronAccess: KingSoftYun_Permission_Private];
KS3SetObjectACLRequest * setObjectACLRequest = [[KS3SetObjectACLRequest alloc] initWithName: strBucketName withKeyName: strObjectName acl: acl];
KS3SetObjectACLResponse * response = [[KS3Client initialize] setObjectACL: setObjectACLRequest];
if (response.httpStatusCode == 200) {
    NSLog(@"Set object acl success!");
} 
else {
    NSLog(@"Set object acl error: %@", response.error.description);
}

上传object的acl，以AccessControlList形式

方法名：

- (KS3SetObjectGrantACLResponse *)setObjectGrantACL:(KS3SetObjectGrantACLRequest *)setObjectGrantACLRequest;

参数说明：

setObjectGrantACLRequest：设置Object Grant ACL的KS3SetObjectGrantACLRequest对象

返回结果：

获取Object Grant ACL的HTTP请求响应

代码示例：

KS3GrantAccessControlList * acl = [[KS3GrantAccessControlList alloc] init];
//设置权限为公共读
[acl setGrantControlAccess: KingSoftYun_Grant_Permission_Read];
//设置被授权人的id和name
acl.identifier = @"436749834";
acl.displayName = @"blues111";
KS3SetObjectGrantACLRequest * request = [[KS3SetObjectGrantACLRequest alloc] initWithName: @"blues111"withKeyName: @"500.txt"grantAcl: acl];
KS3SetObjectGrantACLResponse * response = [[KS3Client initialize] setObjectGrantACL: request];
if (response.httpStatusCode == 200) {
    NSLog(@"Set object grant acl success!");
} 
else {
    NSLog(@"Set object grant acl error: %@", response.error.description);
}

List-Objects

列举Bucket内的Object

方法名：

- (KS3ListObjectsResponse *)listObjects:(KS3ListObjectsRequest *)listObjectsRequest;

参数说明：

listObjectsRequest：列举指定的Bucket内所有Object的KS3ListObjectsRequest对象，它可以设置prefix，marker，maxKeys，delimiter四个指定的属性。prefix：限定返回的Object名字都以制定的prefix前缀开始。类型：字符串默认：无；marker：从一个指定的名字marker开始列出Object的名字。类型：字符串默认值：无；maxKeys：设定返回的Object名字数量，返回的数量有可能比设定的少，但是绝不会比设定的多，如果还存在没有返回的Object名字，返回的结果包含<IsTruncated>true</IsTruncated>。类型：字符串默认：10000；delimiter：delimiter是用来对Object名字进行分组的一个字符。包含指定的前缀到第一次出现的delimiter字符的所有Object名字作为一组结果CommonPrefix。类型：字符串默认值：无

返回结果：

列举指定Bucket内所有Object的HTTP请求响应

代码示例：

KS3ListObjectsRequest * listObjectRequest = [[KS3ListObjectsRequest alloc] initWithName: @"blues111"];
KS3ListObjectsResponse * response = [[KS3Client initialize] listObjects: listObjectRequest];
KS3ListObjectsResult * _result = response.listBucketsResult;
NSMutableArray * _arrObjects = response.listBucketsResult.objectSummaries;

for (KS3ObjectSummary * objectSummary in _arrObjects) {
    NSLog(@"%@", objectSummary.Key);
    NSLog(@"%@", objectSummary.owner.ID);
}
NSLog(@"%@", _result.bucketName);
NSLog(@"%ld", _result.objectSummaries.count);
NSLog(@"%ld", _result.commonPrefixes.count);

NSLog(@"KS3ListObjectsResponse %d", response.httpStatusCode);

Put-Object

上传Object数据

方法名：

- (KS3PutObjectResponse *)putObject:(KS3PutObjectRequest *)putObjectRequest;

参数说明：

putObjectRequest：上传指定的Object的KS3PutObjectRequest对象。它需要设置指定的Bucket的名称和Object的名称

返回结果：

上传指定的Object的HTTP请求响应

代码示例：

1.普通上传

/* 一定要实现委托方法 (这种情况如果实现委托，返回的reponse一般返回为nil，具体获取返回对象需要到委托方法里面获取，如果不实现委托，reponse不会为nil*/
KS3PutObjectRequest *putObjRequest = [[KS3PutObjectRequest alloc] initWithName:@"testcreatebucket-wf111" withAcl:nil grantAcl:nil];
//设置object权限为公开读
KS3AccessControlList *acl = [[KS3AccessControlList alloc] init];
[acl setContronAccess:KingSoftYun_Permission_Public_Read];
[putObjRequest setAcl:acl];
putObjRequest.delegate = self;
NSString *fileName = [[NSBundle mainBundle] pathForResource:@"test" ofType:@"jpg"];
putObjRequest.data = [NSData dataWithContentsOfFile:fileName options:NSDataReadingMappedIfSafe error:nil];
putObjRequest.filename = [fileName lastPathComponent];

[[KS3Client initialize] putObject:putObjRequest];

2.有些情况下，如果希望KS3上传文件完成后通知服务端，需要注册回调参数。使用方法：

/* 一定要实现委托方法 (这种情况如果实现委托，返回的reponse一般返回为nil，具体获取返回对象需要到委托方法里面获取，如果不实现委托，reponse不会为nil*/
KS3PutObjectRequest *putObjRequest = [[KS3PutObjectRequest alloc] initWithName:@"testcreatebucket-wf111" withAcl:nil grantAcl:nil];
//设置object权限为公开读
KS3AccessControlList *acl = [[KS3AccessControlList alloc] init];
[acl setContronAccess:KingSoftYun_Permission_Public_Read];
[putObjRequest setAcl:acl];
putObjRequest.delegate = self;
NSString *fileName = [[NSBundle mainBundle] pathForResource:@"test" ofType:@"jpg"];
putObjRequest.data = [NSData dataWithContentsOfFile:fileName options:NSDataReadingMappedIfSafe error:nil];
putObjRequest.filename = [fileName lastPathComponent];
//设置回调函数
putObjRequest.callbackUrl = @"http://123.59.36.81/index.php/api/photos/callback";
//设置回调参数，回调参数支持自定义参数、常量和魔法变量。如下所示：kss-location和kss-name为自定义参数，key和etag为魔法变量。
//支持的魔法变量详见上传回调处理说明文档([https://docs.ksyun.com/documents/956](https://docs.ksyun.com/documents/956))
putObjRequest.callbackBody = @"location=${kss-location}&name=${kss-name}&uid=8888&objectKey=${key}&etag=${etag}";
//设置自定义参数，必须以"kss-"开始
putObjRequest.callbackParams = @{@"kss-location": @"china_location", @"kss-name": @"lulu_name"};

[[KS3Client initialize] putObject:putObjRequest];

Initiate Multipart Upload

调用这个接口会初始化一个分块上传，KS3 Server会返回一个upload id, upload id 用来标识属于当前object的具体的块，并且用来标识完成分块上传或者取消分块上传

方法名：

- (KS3MultipartUpload *)initiateMultipartUploadWithKey:(NSString *)theKey withBucket:(NSString *)theBucket

参数说明：

theKey：指定的Object名称
theBucket：指定的Bucket名称

返回结果：

初始化分块上传的HTTP响应，KS3MultipartUpload类型的对象里面包含了指定的Object名称，Bucket名称，此次上传的Upload ID，Object的Owner，初始化日期

代码示例：

KS3InitiateMultipartUploadRequest *request = [[KS3InitiateMultipartUploadRequest alloc] initWithKey:strObjectName inBucket:strBucketName acl:nil grantAcl:nil];
KS3MultipartUpload *upload = [[KS3Client initialize] initiateMultipartUploadWithRequest:request];

Upload Part

初始化分块上传后，上传分块接口。Part number 是标识每个分块的数字，介于0-10000之间。除了最后一块，每个块必须大于等于5MB，最后一块没有这个限制。

方法名：

- (KS3UploadPartResponse *)uploadPart:(KS3UploadPartRequest *)uploadPartRequest;

参数说明：

uploadPartRequest：上传块的KS3UploadPartRequest对象，它需要指定上传的Object名称，指定的Bucket的名称，分块的块号，此块的数据

返回结果：

块上传的HTTP请求响应

代码示例：

KS3UploadPartRequest *req = [[KS3UploadPartRequest alloc] initWithMultipartUpload:upload partNumber:partNumber data:data generateMD5:NO];
req.delegate = self;
KS3UploadPartResponse *response = [[KS3Client initialize] uploadPart:req];

List Parts

罗列出已经上传的块

方法名：

- (KS3ListPartsResponse *)listParts:(KS3ListPartsRequest *)listPartsRequest;

参数说明：

listPartsRequest：罗列已经上传的块的KS3ListPartsRequest对象，它包含指定的Object的名称，此次上传的Upload ID，maxParts，它表示块大小限制，类型：字符串，默认值：None，partNumberMarker，它表示块号标记，将返回大于此块号的分块，类型：字符串，默认值：None

返回结果：

罗列已经上传的块的HTTP请求响应，它包含了类型为KS3ListPartsResult的请求的结果，它包含指定的Bucket名称，指定的Object名称，此次上传的Upload ID，partNumberMarker，它表示块号标记，将返回大于此块号的分块，maxParts，它表示块大小限制，isTruncated，它表示是否取完分块，Owner它表示创建分块上传的用户

代码示例：

KS3ListPartsRequest *req2 = [[KS3ListPartsRequest alloc] initWithMultipartUpload:_muilt];
KS3ListPartsResponse *response2 = [[KS3Client initialize] listParts:req2];

Abort Multipart Upload

取消分块上传。

方法名：

- (KS3AbortMultipartUploadResponse *)abortMultipartUpload:(KS3AbortMultipartUploadRequest *)abortMultipartRequest

参数说明：

abortMultipartRequest：取消分块上传的KS3AbortMultipartUploadRequest对象，它需要使用KS3MultipartUpload对象来初始化，初始化包括指定的Bucket名称，Object的名称，分块上传的Upload ID

返回结果：

取消上传的HTTP请求响应

代码示例：

KS3AbortMultipartUploadRequest * request = [[KS3AbortMultipartUploadRequest alloc] initWithMultipartUpload: _muilt];
KS3AbortMultipartUploadResponse * response = [[KS3Client initialize] abortMultipartUpload: request];
if (response.httpStatusCode == 204) {
    NSLog(@"Abort multipart upload success!");
} 
else {
    NSLog(@"error: %@", response.error.description);
}

Complete Multipart Upload

组装之前上传的块，然后完成分块上传。通过你提供的xml文件，进行分块组装。在xml文件中，块号必须使用升序排列。必须提供每个块的ETag值。

方法名：

- (KS3CompleteMultipartUploadResponse *)completeMultipartUpload:(KS3CompleteMultipartUploadRequest *)completeMultipartUploadRequest;

参数说明：

completeMultipartUploadRequest：组装上传所有块的KS3CompleteMultipartUploadRequest对象，它包含指定的Bucket名称，Object名称，此次上传的Upload ID，需要组装的所有块的信息数据

返回结果：

组装所有块的HTTP请求响应

代码示例：

KS3ListPartsResponse * response2 = [[KS3Client initialize] listParts: req2];
KS3CompleteMultipartUploadRequest * req = [[KS3CompleteMultipartUploadRequest alloc] initWithMultipartUpload: _muilt];
for (KS3Part * part in response2.listResult.parts) { 
    [req addPartWithPartNumber: part.partNumber withETag: part.etag];
} 
[[KS3Client initialize] completeMultipartUpload: req];

Multipart Upload Example Code

分块上传代码示例

NSFileHandle * fileHandle = [NSFileHandle fileHandleForReadingAtPath: [[NSBundle mainBundle] pathForResource: @"bugDownload"ofType: @"txt"]];
long long fileLength = [[fileHandle availableData] length];
long long partLength = 5 * 1024.0 * 1024.0;
_partInter = (ceilf((float) fileLength / (float) partLength)); [fileHandle seekToFileOffset: 0];

KS3InitiateMultipartUploadRequest * _muilt = [[KS3Client initialize] initiateMultipartUploadWithKey: @"500.txt"withBucket: @"blues111"inBucket: strBucketName acl: nil grantAcl: nil];
for (NSInteger i = 0; i < _partInter; i++) {
    NSData * data = nil;
    if (i == _partInter - 1) {
        data = [fileHandle readDataToEndOfFile];
    } 
    else {
        data = [fileHandle readDataOfLength: partLength]; 
        [fileHandle seekToFileOffset: partLength * (i + 1)];
    }
    KS3UploadPartRequest * req = [[KS3UploadPartRequest alloc] initWithMultipartUpload: _muilt];
    req.delegate = self;
    req.data = data;
    req.partNumber = (int32_t) i + 1;
    req.contentLength = data.length; [[KS3Client initialize] uploadPart: req];
}

// **** 分块上传的回调，每块上传结束后都会被调用
- (void) request: (KS3ServiceRequest * ) request didCompleteWithResponse: (KS3ServiceResponse * ) response {
    _upLoadCount++;
    if (_partInter == _upLoadCount) {
        KS3ListPartsRequest * req2 = [[KS3ListPartsRequest alloc] initWithMultipartUpload: _muilt];
        KS3ListPartsResponse * response2 = [[KS3Client initialize] listParts: req2];
        KS3CompleteMultipartUploadRequest * req = [[KS3CompleteMultipartUploadRequest alloc] initWithMultipartUpload: _muilt];
        NSLog(@" - - - - - %@", response2.listResult.parts);
        for (KS3Part * part in response2.listResult.parts) { [req addPartWithPartNumber: part.partNumber withETag: part.etag];
        } 
        [[KS3Client initialize] completeMultipartUpload: req];
    }
} 
- (void) request: (KS3ServiceRequest * ) request didFailWithError: (NSError * ) error {
    NSLog(@"error: %@", error.description);
}

Upload Manager

分块上传接口可以实现断点续传等功能，但是由于使用比较复杂，SDK提供了一个封装后的接口——Ks3UploadManager。

使用本接口首先需要初始化一个KS3UploadManager实例。

self.uploadManager = [KS3UploadManager sharedInstanceWithClient:[KS3Client initialize] authHandler:nil];

KS3UploadManager接受唯一参数是authHandler，此handler用于处理鉴权串签名，每次请求都会用本次请求的信息调用authHandler，handler方法内，请求鉴权服务器拿到签名串返回即可。

authHandler如果为nil，则需要在客户端设置AK、SK（这种方式不推荐）。设置方法为：[[KS3Client initialize] setCredentials:[[KS3Credentials alloc] initWithAccessKey:"YOUR_KS3_ACCESS_KEY" withSecretKey:"YOUR_KS3_SECRET_KEY"]];。

实例创建好后，可以调用上传方法：

// 读取文件信息
NSString * strFilePath = [[NSBundle mainBundle] pathForResource: @"7.6M"ofType: @"mov"];
NSData * data = [NSData dataWithContentsOfFile: strFilePath];

KS3AccessControlList * acl = [[KS3AccessControlList alloc] init]; [acl setContronAccess: KingSoftYun_Permission_Public_Read];

// 创建一次开始分块的请求
KS3UploadRequest * uploadRequest = [[KS3UploadRequest alloc] initWithKey: @"uploadmanager/sample.mov"inBucket: kUploadBucketName acl: acl grantAcl: nil]; [uploadRequest setCompleteRequest]; [uploadRequest setStrKS3Token: [KS3Util getAuthorization: uploadRequest]];

// 开始上传
[self.uploadManager putData: data request: uploadRequest blockSize: 1 * kMB progress: ^(NSString * key, double percent) {
    NSLog(@"objectKey: %@, progress %lf", key, percent);
}
cancelSignal: ^BOOL(NSString * key) {
    return false; // 修改这里进行取消
}
complete: ^(KS3Upload * upload, KS3Response * response) {
    NSLog(@"uploadId: %@, response %@", upload.uploadId, response);
}
error: ^(KS3Upload * upload, NSError * error) {
    NSLog(@"uploadId: %@, error: %@", upload.uploadId, error);
}];

目前此接口只支持使用NSData作为参数进行上传。

其它

完整示例，请见 KS3-iOS-SDK-Demo

计算资源

云监控

游戏服务

应用服务

管理与审计

网络

视频云服务

消息队列

人工智能

应用中间件

合规性

数据库

云安全

用户中心

存储与云分发

大数据

开发者工具

合作与生态

其它

产品简介

购买与计费

KS3资源包

快速入门

控制台快速入门

工具快速入门

SDK快速入门

用户指南

访问域名（Endpoint）

存储类型

空间管理（Bucket）

对象管理（Object）

控制台报表中心

访问权限管理

数据安全

图像处理

云监控

常用工具

工具

环境安装与配置

最佳实践

访问权限管理实践

API文档

请求签名

公共HTTP头

Bucket相关