本文档介绍高性能桶(Rapid Bucket)SDK 的使用方式。目前提供 Go 与 Python 两种语言的高性能桶 SDK,二者均基于对应的腾讯云 COS SDK,面向高性能桶场景提供存储桶与对象的读写能力。
SDK 定位
高性能桶 SDK 在对应语言 COS SDK 的基础上,针对高性能桶的会话鉴权做了适配:在需要时自动完成会话创建、凭证签名与缓存复用,业务代码无需手动管理临时凭证,具体接口、参数与行为以对应高性能桶 SDK 文档为准。
Go SDK:基于 github.com/tencentyun/cos-go-sdk-v5,通过
RapidCredentialTransport 使用基础凭证完成自动会话鉴权。Python SDK:基于 cos-python-sdk-v5,
CosS3Client 在识别到高性能桶后自动完成 CreateSession、签名与按桶缓存复用。文档结构
本 SDK 文档涵盖以下操作分类:
存储桶操作:创建存储桶、删除存储桶、查询存储桶、查询存储桶列表、创建访问会话。
对象操作:上传对象、下载对象、删除对象、复制对象等。
分块上传操作:适用于大文件的分块上传。
存储桶策略:设置存储桶策略、获取存储桶策略、删除存储桶策略。
Python 高级传输接口:上传本地文件、下载到本地文件、高级复制对象、上传可读流。
Python 访问授权:预签名 URL 的生成、使用与有效期。
开始使用
建议先阅读对应语言的快速入门,了解环境要求、SDK 安装、鉴权说明与客户端初始化方式,再根据需要查阅各接口的详细文档。SDK 调用返回的错误处理方式请参见异常处理。
Go SDK:Go SDK 快速入门、Go SDK 异常处理
Python SDK:Python SDK 快速入门、Python SDK 异常处理
Python 的自动传输与临时授权用法: