项目的来由:做基于Django个人网站时,采用了腾讯云的对象存储服务,当时发现他们并没有提供基于py3的sdk,然后就有了这个项目,另外此项目SDK已多次在我的其他项目中集成,使用较稳定,可放心使用。
调用格式:
from cos_lib3.cos import Cos
cos = Cos(app_id=<appid>, secret_id='<secret_id>', secret_key='<secret_key>', region='<地域:sh(华东),gz(华南),tj(华北)>')
bucket = cos.get_bucket("<bucket名称>")
样例调用:
from cos_lib3.cos import Cos
cos = Cos(app_id=123456789, secret_id='AKIDpTgPyrRUh6cS77PTGVtHZKklTBCurQq2', secret_key='2o5eXbkgNxJ2jWnZ67z1vlIVDxfAQ', region='tj')
bucket = cos.get_bucket("test")
格式如下:
bucket.create_folder('<目录名称>')
格式如下:
bucket.query_folder('<目录名称>')
调用格式1:
rst = bucket.list_folder(dir_name='<目录名称>')
print(rst)
调用格式2(查询某个目录下特定的特定前缀的文件):
rst = bucket.list_folder(dir_name='<目录名称>', prefix='<前缀>')
print(rst)
调用格式3(查询某个目录下的文件,并限定查询数量):
rst = bucket.list_folder(dir_name='<目录名称>', num=<查询的数量>)
print(rst)
调用格式4(综合格式2,3)
rst = bucket.list_folder(dir_name='<目录名称>', prefix='<前缀>', num=<查询数量>)
调用格式
rst = bucket.delete_folder('<目录名称>')
print(rst)
调用格式1(文件上传到bucket的根目录):
bucket.upload_file(real_file_path='<文件的在本地的路径>', file_name='<文件在bucket的名称>')
调用格式2(文件上传到bucket的特定的目录)
bucket.upload_file(real_file_path='<文件的在本地的路径>', file_name='<文件在bucket的名称>', dir_name='<目录名称>')
bucket.upload_slice_file(real_file_path='<文件的在本地的路径>',slice_size=1048576,file_name='<文件在bucket的名称>')
样例调用
real_file_path = (r'C:\Users\ZhangPeng\Desktop\01.zip')
# slice_size为分片大小,单位为Byte,有效值:1048576(1MB),如非必要,请勿修改!!
slice_size = 1048576
# file_name为文件在bucket中存储的名称
file_name = '01.zip'
bucket.upload_slice_file(real_file_path, slice_size, file_name)
调用格式
bucket.move_file(source_fileid='<源文件的路径>', dest_fileid='目标文件的路径')
调用格式
bucket.copy_file(source_fileid='<源文件路径>', dest_fileid='目标文件路径')
调用格式
bucket.delete_file('<文件的绝对路径>')
调用格式如下:
bucket.upload_file_from_url("http://sucai.qqjay.com/qqjayxiaowo/201210/26/1.jpg", file_name="777.jpg", dir_name=None)
第一个参数为文件的url地址,
第二个参数为放在云存储上的显示的文件的文件名,
第三个参数为文件在云存储上的文件目录,可以为None,此时放在根目录上
首先获取上传之后的返回值 如:data = bucket.upload_file(real_file_path='<文件的在本地的路径>', file_name='<文件在bucket的名称>')
得到的data 的值形如:
{'source_url': 'http://test-125255866665.costj.myqcloud.com/777.jpg', 'access_url': 'http://test-125255866665.file.myqcloud.com/777.jpg', 'url': 'http://tj.file.myqcloud.com/files/v2/125255866665/test/777.jpg', 'vid': '8fea559ee6578acf89698bef7ae5b6551494676054', 'resource_path': '/125255866665/test/777.jpg'}
下面我们来解析这个data字符串,得到access_url字段的值并输出:
access_url = eval(data).get("access_url")
print(access_url)
腾讯云的对象存储服务完全是支持https的,如果你获取到的链接并不是https形式的,尝试使用replace函数把‘http://’ 直接替换成 ‘https://’ 试试
感谢开源社区的热心成员,他们提供了分片上传的代码,经过测试,可以放心使用!
请报告issue
初始化 cos时:
正确填写region参数,在 COS 控制台 => bucket列表 => 基础配置=>所属地区
如 北京 (bj), region='bj'
以下表格摘自官网文档于(2018-04-13)
地域 | 地域简称 | 默认下载域名 | 上传域名 |
---|---|---|---|
北京一区(华北) | tj | <bucketname-APPID>.costj.myqcloud.com | tj.file.myqcloud.com |
北京 | bj | <bucketname-APPID>.cosbj.myqcloud.com | bj.file.myqcloud.com |
上海(华东) | sh | <bucketname-APPID>.cossh.myqcloud.com | sh.file.myqcloud.com |
广州(华南) | gz | <bucketname-APPID>.cosgz.myqcloud.com | gz.file.myqcloud.com |
成都(西南) | cd | <bucketname-APPID>.coscd.myqcloud.com | cd.file.myqcloud.com |
新加坡 | sgp | <bucketname-APPID>.cossgp.myqcloud.com | sgp.file.myqcloud.com |
香港 | hk | <bucketname-APPID>.coshk.myqcloud.com | hk.file.myqcloud.com |
多伦多 | ca | <bucketname-APPID>.cosca.myqcloud.com | ca.file.myqcloud.com |
法兰克福 | ger | <bucketname-APPID>.cosger.myqcloud.com | ger.file.myqcloud.com |
如果代码配置没有错误,检查下电脑的时间是不是对的
在本项目的发展过程中得到了来自开源社区的很多成员的宝贵意见以及无私帮助,为这个项目发展做出的极大的贡献,
特别是以下用户:
fushall1104:帮助修复命名上的一处bug
a270443177:提供分片上传的代码
zhangpengpengpeng:帮助测试分片上传功能
xfdywy:提出一个配置region可能遇到的问题
本项目遵循Apache协议,完全开源,文档齐全,永远免费(商用也是)