对象存储
数据库产品文档捉虫活动邀您参加！> HOT
文档中心>对象存储>附录>历史版本>历史版本 SDK>C++ SDK

C++ SDK

最近更新时间：2020-02-12 13:52:48

我的收藏

本页目录：

注意
您目前查阅的是历史版本 SDK 文档，已不再更新和维护，我们建议您查阅新版 SDK 文档。

开发准备

相关资源

开发环境

1. 安装 openssl 的库和头文件。
2. 安装 curl 的库和头文件。
3. 安装 jsoncpp 的库和头文件。
4. 安装 boost 的库和头文件。
5. 安装 cmake 工具。
6. 登录 腾讯云控制台 获取 APPID、SecretID、SecretKey。
注意
1. 本 SDK 仅适用于 Linux 系统和编译环境，暂不支持 Windows 环境。
2. sdk 中提供了curl 和 jsoncpp 的库以及头文件，以上库编译好后替换掉 sdk 中相应的库和头文件即可，如果以上库已经安装到系统里，也可删除 sdk 中相应的库和头文件。
3. curl 默认不支持多线程环境，如果项目使用多线程，在编译 curl 执行 configure 时需指定 --enable-ares 参数来开启异步 DNS 解析，依赖 c-ares 库，如果系统没有，可到 c-ares 下载安装。
4. jsoncpp 的 1.y.x 版本需要 c++11 的支持，如果编译器不支持，可以换成 0.y.x 版本。 （本版本 SDK 基于 JSON API 封装组成）

SDK 配置

直接下载 github 上提供的源代码，集成到您的开发环境。
执行下面的命令 ：
cd ${cos-cpp-sdk} 
mkdir -p build 
cd build 
cmake .. 
make
cos_demo.cpp 里面有常见 API 的例子。生成的 cos_demo 可以直接运行，生成的静态库名称为：libcossdk.a。生成的 libcossdk.a 放到您自己的工程里 lib 路径下，include 目录拷贝到自己的工程的 include 路径下。

生成签名

多次有效签名

方法原型

static string AppSignMuti(const uint64_t appId, 
                          const string &secretId, 
                          const string &secretKey, 
                          const uint64_t expired_time, 
                          const string &bucketName);

参数说明

参数名
类型
是否必填
默认值
参数描述
appId
uint64_t
是
无
项目 App ID
secretId
String
是
无
用户 Secret ID
secretKey
String
是
无
用户 SecretKey
expired_time
uint64_t
否
无
过期时间，Unix 时间戳
bucketName
String
否
无
bucket 名称

返回结果说明

返回值：签名字符串

示例

uint64_t expired = time(NULL) + 60;
string sign = Auth::AppSignMuti(10000000,"SecretId","SecretKey",expired,"bucketName");

单次有效签名

方法原型

static string AppSignOnce(const uint64_t appId, 
                          const string &secretId, 
                          const string &secretKey, 
                          const string &path, 
                          const string &bucketName);

参数说明

参数名
类型
必须
默认值
参数描述
appId
uint64_t
是
无
项目 App ID
secretId
String
是
无
项目 SecretID
secretKey
String
是
无
项目 SecretKey
bucketName
String
否
无
bucket名称
path
String
是
无
文件路径，以斜杠开头，例如/filepath/filename，为文件在此 bucketname 下的全路径

返回值说明

返回值：签名字符串

示例

string path= "/myFloder/myFile.rar";
sign = Auth::AppSignOnce(10000000, "SecretId", "SecretKey", path, bucketName);

初始化操作

初始化

接口说明：在使用 COS 操作之前，需要首先进行 COS 系统参数的设置，然后分别创建 CosConfig 以及 CosAPI 对象，COS 的操作都是基于 CosAPI 对象进行的。

配置文件

"AppID":********,
"SecretID":"*********************************",
"SecretKey":"********************************",
"Region":"sh",   //COS区域, 华东园区：sh ；华南园区：gz ；华北园区：tj ；上传和下载域名均是跟此有关系，因此一定要保证正确
"SignExpiredTime":360, //签名超时时间
"CurlConnectTimeoutInms":180,  //http超时时间
"CurlGlobalConnectTimeoutInms":360, //
"UploadSliceSize":1048576, //文件分片大小，可选值有524288、1048576、2097152、3145728
"IsUploadTakeSha":0, //文件上传时是否携带文件sha值，0：不携带，1：携带
"DownloadDomainType":2, //下载域名类型,1:cdn,2:cos,3:innercos,4:自定义域名
"SelfDomain":"",//自定义域名
"UploadThreadPoolSize":5, //单文件分片上传线程池大小
"AsynThreadPoolSize":2, //异步上传下载线程池大小
"LogoutType":1 //日志输出类型,0:不输出,1:输出到屏幕,2输出到syslog

COS API 对象构造原型

CosConfig(const string& config_file);
CosAPI(CosConfig& config);

目录操作

创建目录

接口说明：用于目录的创建，调用者可以通过此接口在指定 bucket 下创建目录。

方法原型

string CosAPI::FolderCreate(FolderCreateReq& request);

参数说明

参数名
类型
默认值
参数描述
request
FolderCreateReq
无
目录创建请求类型
request成员
类型
默认值
设置方法
描述
bucket
string
无
构造函数
bucket 名称
cosPath
string
无
构造函数
上传的目标路径
bizAttr
string
空字符串
构造函数
文件夹属性

返回结果说明

通过函数返回值返回请求结果的json字符串
参数名
类型
参数描述
code
Int
返回码，成功时为 0
message
String
描述信息
data
Array
返回数据，请参考《Restful API 创建目录》

示例

FolderCreateReq folderCreateReq(bucket,folder,folder_biz_attr);
string rsp = cos.FolderCreate(folderCreateReq);

目录更新

接口说明：用于目录业务自定义属性的更新，可以通过此接口更新业务的自定义属性字段。

方法原型

string FolderUpdate(FolderUpdateReq& request);

参数说明

参数名
类型
默认值
参数描述
request
FolderUpdateReq
无
目录更新请求类型
参数名
类型
默认值
设置方法
参数描述
bucket
String
无
构造函数
bucket名称
cosPath
String
无
构造函数
目录的全路径
bizAttr
string
空
构造函数
文件夹属性

返回结果说明

通过函数返回值返回请求结果的json字符串
参数名
类型
参数描述
code
Int
返回码，成功时为 0
message
String
描述信息
data
Array
返回数据，请参考《Restful API 目录更新》

示例

FolderUpdateReq folderUpdateReq(bucket,folder, folder_biz_attr);
string rsp = cos.FolderUpdate(folderUpdateReq);

目录查询

接口说明：用于目录属性的查询，可以通过此接口查询目录的属性。

方法原型

string CosAPI::FolderStat(FolderStatReq& request);

参数说明

参数名
类型
默认值
参数描述
request
FolderStatReq
无
目录查询请求类型
参数名
类型
默认值
设置方法
参数描述
bucket
String
无
构造函数
bucket名称
cosPath
String
无
构造函数
目录的全路径

返回结果说明

通过函数返回值返回请求结果的json字符串
参数名
类型
参数描述
code
Int
返回码，成功时为0
message
String
描述信息

示例

FolderStatReq folderStatReq(bucket,folder);
string rsp = cos.FolderStat(folderStatReq);

目录删除

接口说明：用于目录的删除，可以通过此接口删除空目录，如果目录中存在有效文件或目录，将不能删除。

方法原型

string CosAPI::FolderDelete(FolderDeleteReq& request);

参数说明

参数名
类型
默认值
参数描述
request
FolderDeleteReq
无
目录删除请求类型
参数名
类型
默认值
设置方法
参数描述
bucket
String
无
构造函数
bucket名称
cosPath
String
无
构造函数
目录的全路径

返回结果说明

通过函数返回值返回请求结果的json字符串
参数名
类型
参数描述
code
Int
返回码，成功时为 0
message
String
描述信息

示例

FolderDeleteReq folderDeleteReq(bucket,folder);
string rsp = cos.FolderDelete(folderDeleteReq);

目录列表

接口说明：用于列举目录下文件和目录，可以通过此接口查询目录下的文件和目录属性。

方法原型

string CosAPI::FolderList(FolderListReq& request);

参数说明

参数名
类型
默认值
参数描述
request
FolderListReq
无
目录列表请求类型
参数名
类型
默认值
设置方法
参数描述
bucket
String
无
构造函数
bucket 名称
cosPath
String
无
构造函数
目录的全路径
listNum
int
1000
构造函数
查询数目，最大为1000
context
string
空字符串
构造函数
查询上下文。查看第一页，则传空字符串；若需翻页，需要将前一页查询响应中的 context 设置到参数中

返回结果说明

通过函数返回值返回请求结果的 json 字符串
参数名
类型
是否必然返回
参数描述
code
Int
是
返回码，成功时为 0
message
String
是
描述信息
data
Array
是
返回数据，请参考《Restful API 目录列表》

示例

FolderListReq folderListReq(bucket,folder);
string rsp = cos.FolderList(folderListReq);

文件操作

文件上传

接口说明：文件上传，包括单文件上传和分片上传（大于8M的文件需要通过将文件内容进行分片上传）。

方法原型

string CosAPI::FileUpload(FileUploadReq& request);

参数说明

参数名
类型
默认值
参数描述
request
FileUploadReq
无
文件上传请求类型
参数名
类型
默认值
设置方法
参数描述
bucket
String
无
构造函数
bucket名字
srcPath
String
无
构造函数
待上传的本地文件路径
cosPath
String
无
构造函数
文件的全路径
bizAttr
string
无
setBizAttr()
文件属性
sliceSize
int
1048576
setSliceSize()
分片大小，可选值512K/1M/2M/3M；默认1M，均需转换为字节数值

返回结果说明

通过函数返回值返回请求结果的 json 字符串
参数名
类型
是否必然返回
参数描述
code
Int
是
返回码，成功时为 0
message
String
是
描述信息
data
Array
否
返回数据，请参考《Restful API 文件上传》

示例

FileUploadReq fileUploadReq(bucket, srcPath, dstPath);
string rsp = cos.FileUpload(fileUploadReq);

文件更新

接口说明：用于目录业务自定义属性的更新，可以通过此接口更新业务的自定义属性字段。

方法原型

string CosAPI::FileUpdate(FileUpdateReq& request);

参数说明

参数名
类型
默认值
参数描述
request
FileUpdateReq
无
文件更新请求类型
参数名
类型
是否必填
设置方法
参数描述
bucket
String
是
构造函数
bucket 名称
cosPath
String
是
构造函数
文件在对象存储服务端的路径
bizAttr
string
否
setBizAttr()
文件属性
authority
string
否
setAuthority()
文件权限，默认是继承 bucket 的权限合法取值: eInvalid(继承bucket), eWRPrivate(私有读写), eWPrivateRPublic(私有写, 公有读)
forbid
int
否
setForbid()
文件封禁标志
custom_header
map
否
setCustomHeader()
用户自定义属性
custom_header说明
参数名
类型
是否必填
参数描述
Cache-Control
string
否
参见 HTTP 的 Cache-Control
Content-Type
string
否
参见 HTTP 的 Content-Type
Content-Disposition
string
否
参见 HTTP 的 Content-Language
Content-Language
string
否
参见 HTTP 的 Content-Disposition
Content-Encoding
string
否
参见 HTTP 的 Content-Encoding
x-cos-meta-
string
否
自定义 HTTP 头，参数必须以 x-cos-meta-开头，值由用户定义，可设置多个
tips: custom_header 是整体覆盖式更新，即更新属性可以选择其中的某几个，如果本次只更新其中的某几个，其他的都会被抹掉。

返回结果说明

通过函数返回值返回请求结果的json字符串：
参数名
类型
是否必然返回
参数描述
code
Int
是
返回码，成功时为 0
message
String
是
描述信息

示例

FileUpdateReq fileUpdateReq(bucket,dstpath);
fileUpdateReq.setBizAttr(file_biz_attr);
fileUpdateReq.setAuthority(auth);
fileUpdateReq.setForbid(0);
fileUpdateReq.setCustomHeader(custom_header);
string rsp = cos.FileUpdate(fileUpdateReq);

文件查询

接口说明：用于文件的查询，可以通过此接口查询文件的各项属性信息。

方法原型

string CosAPI::FileStat(FileStatReq& request)

参数说明

参数名
类型
默认值
参数描述
request
FileStatReq
无
文件查询请求类型
FileStatReq
参数名
类型
是否必填
默认值
参数描述
bucket
String
是
无
bucket 名称
cosPath
String
是
无
文件在对象存储服务端的全路径

返回结果说明

通过函数返回值返回请求结果的json字符串
参数名
类型
必然返回
参数描述
code
Int
是
错误码，成功时为 0
message
String
是
错误信息
data
Array
是
返回数据，请参考《Restful API 文件查询》

示例

FileStatReq fileStatReq(bucket,dstpath);
string rsp = cos.FileStat(fileStatReq);

文件删除

接口说明：用于文件的删除，可以通过此接口删除已经上传的文件。

方法原型

FileDeleteReq fileDeleteReq(bucket,dstpath);
string rsp = cos.FileDelete(fileDeleteReq);

参数说明

参数名
类型
默认值
参数描述
request
FileDeleteReq
无
文件删除请求类型
FolderDeleteReq
参数名
类型
是否必填
默认值
参数描述
bucket
String
是
无
bucket 名称
cosPath
String
是
无
文件在对象存储服务端的全路径

返回结果说明

通过函数返回值返回请求结果的json字符串
参数名
类型
是否必然返回
参数描述
code
Int
是
返回码，成功时为 0
message
String
是
描述信息

示例

FileDeleteReq fileDeleteReq(bucket,dstpath);
string rsp = cos.FileDelete(fileDeleteReq);

中国站
文档反馈
文档活动
message-icon联系我们
目录