tencent cloud

智能媒资托管

产品简介
产品概述
功能介绍
产品优势
应用场景
基本概念
购买指南
快速入门
创建媒体库
发起请求
服务级 API 文档
History
Introduction
API Category
Making API Requests
PaaS Service APIs
Official Cloud Disk APIs
Data Types
Error Codes
业务级 API 文档
简介
访问令牌操作接口
租户空间操作接口
文件操作接口
目录或相簿操作接口
回收站操作接口
配额操作接口
查询任务操作接口
搜索操作接口
历史版本操作接口
目录和文件批量操作接口
收藏操作接口
Error Codes
SDK 文档
Android SDK
iOS SDK
鸿蒙 SDK
常见问题
企业网盘
产品简介
购买指南
快速入门
常见问题
Service Level Agreement
词汇表

上传

PDF
聚焦模式
字号
最后更新时间: 2026-01-07 10:49:05

简介

本文档提供关于文件上传的 API 概览以及 SDK 示例代码。

SDK API 参考

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

高级上传

功能说明

该上传方法内部会自动进行快速上传、简单上传、分块上传的逻辑。

开始上传或继续上传

QCloudCOSSMHUploadObjectRequest *uploadReq = [QCloudCOSSMHUploadObjectRequest new];
// confirmKey 若设置则视为继续上传,否则为新上传任务。
// 从 getConfirmKey 回调获取。
uploadReq.confirmKey = @"confirmKey";
// 设置要上传的目录所在 libraryId;
uploadReq.libraryId = @"libraryId";
// 设置要上传的目录所在 libraryId;
uploadReq.spaceId = @"spaceId";
// 上传的文件 URL 或者 data
uploadReq.body = @"uploadBody";
uploadReq.uploadPath = @"目标路径";
// confirmKey 回调
uploadReq.getConfirmKey = ^(NSString *_Nullable confirmKey) {
// confirmKey 在进行断点续传时需要,业务需要保存
};
// 上传进度回调
[uploadReq setSendProcessBlock:^(int64_t bytesSent, int64_t totalBytesSent, int64_t totalBytesExpectedToSend) {

}];
// 上传结果回调
[uploadReq setFinishBlock:^(QCloudSMHContentInfo *result, NSError *error) {

}];
// 发起上传
[[QCloudSMHService defaultSMHService] uploadObject:uploadReq];

暂停

上传时创建的 request 执行 cancel 方法。
[uploadReq cancel];

取消上传

上传时创建的 request 执行 abort 方法,可以在结束回调中做一些清理工作。
[uploadReq abort:^(id outputObject, NSError *error) {
// 结束回调
}];
说明:
若要实现 App 被 kill 之后再次打开继续续传,则需要业务端将 confirmkey 以及本次上传任务对应的 body、libraryId、spaceId、uploadPath 进行持久化,再次进入 App 时重新创建 request 并开始上传。

帮助和支持

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

填写满意度调查问卷,共创更好文档体验。

文档反馈