简介
对象(Object)是对象存储的基本单元,可理解为任何格式类型的数据,例如图片、文档和音视频文件等。
准备工作
2. 拥有轻量对象存储(Lighthouse 版)服务的操作权限。主账号默认拥有所有权限,子账号需要在 访问管理服务 按需授权对象存储服务权限。
3. 已创建存储桶,并且拥有存储桶操作权限。
上传文件
1. 登录 轻量对象存储控制台。
2. 在存储桶卡片页面中单击需要存储对象的存储桶,进入存储桶的文件列表页面。
3. 在文件列表中,单击上传文件按钮;在弹出的窗口中,选中本地文件后单击上传。
注意:
部分浏览器不支持多文件上传,建议使用 IE10以上、Firefox、Chrome 等主流浏览器。
下载文件
1. 登录 轻量对象存储控制台。
2. 在存储桶卡片页面中单击对象所在的存储桶,进入存储桶的文件列表页面。
3. 在文件列表中,找到需下载的对象,并单击下载按钮;在弹出的窗口中单击确定后即可下载。
注意:
下载文件会产生下载流量费用,推荐您先购买套餐包用于抵扣流量费用。
删除文件
1. 登录 轻量对象存储控制台。
2. 在存储桶卡片页面中单击对象所在的存储桶,进入存储桶的文件列表页面。
3. 在文件列表中,找到需删除的对象,并单击删除按钮;在弹出的窗口中单击确定后即可删除。
注意:
删除文件后,文件无法再恢复,请慎重执行删除操作。
分享文件
1. 登录 轻量对象存储控制台。
2. 在存储桶卡片页面中单击对象所在的存储桶,进入存储桶的文件列表页面。
3. 在文件列表中,找到需分享的对象,并单击更多 > 快速分享链接。
4. 在弹出的窗口中,选择分享的链接类型,单击复制链接即可进行分享。
注意:
携带签名的分享链接具有更高的安全性,这类链接默认具有2小时有效性。不携带签名的分享链接在私有读写的情况下,不可被匿名用户访问。
重命名文件
1. 登录 轻量对象存储控制台。
2. 在存储桶卡片页面中单击对象所在的存储桶,进入存储桶的文件列表页面。
3. 在文件列表中,找到需重命名的对象,并单击更多 > 重命名。
4. 在弹出的窗口中,输入新的文件名称,单击确认后即可完成重命名。
注意:
重命名需要遵循文件命名规范,请参考注意事项中的说明。

移动文件
1. 登录轻量对象存储控制台。
2. 在存储桶卡片页面中单击对象所在的存储桶,进入存储桶的文件列表页面。
3. 在文件列表中,单击更多 > 移动。
4. 在弹出的窗口中,选择目标文件夹,单击确定后即可完成移动。
注意:
文件移动后,如果目标文件夹有同名文件,会执行覆盖操作,请谨慎评估后进行移动操作。

设置文件权限
1. 登录 轻量对象存储控制台。
2. 在存储桶卡片页面中单击对象所在的存储桶,进入存储桶的文件列表页面。
3. 在文件列表中,找到需设置权限的对象,并单击更多 > 设置权限。
4. 在弹出的窗口中,可按需切换文件权限。
注意:
默认情况下,文件继承存储桶权限。不推荐设置为公有读私有写,因为这样可能会导致文件被盗刷。


新建文件夹
1. 登录 轻量对象存储控制台。
2. 在存储桶卡片页面中单击需要的存储桶,进入存储桶的文件列表。
3. 在文件列表中,单击新建文件夹按钮;在弹出的窗口中,输入文件夹名称并单击确定即可。
注意:
文件夹命名需要遵循文件命名规范,请参考以下注意事项中的说明。


删除文件碎片
您可以进入文件碎片管理项查看未完成上传的文件碎片,并对其进行删除。
注意:
上传对象过程中,暂停上传或取消上传的文件都会显示在文件碎片管理项。上传完成后,方可在文件列表里找到已上传的文件。
文件碎片和正常的对象一样会占用存储空间,所以会产生存储容量费用。
1. 登录 轻量对象存储控制台。
2. 在存储桶卡片页面中单击需要新建文件夹的存储桶,进入存储桶的文件列表页面。
3. 在文件列表中,单击文件碎片,在展开的文件碎片页面,即可查看未完成上传的碎片文件。
4. 单击文件碎片右侧的删除,即可对某个未完成上传的碎片文件进行删除。您也可以单击上方的清空碎片,一键删除全部未完成上传的碎片文件。

注意事项
命名规范
存储桶中的文件名称需要遵循相应的命名规范:
可以使用任何 UTF-8 字符,为了确保名称与其他应用程序的最大兼容性,推荐使用英文大小写字母、数字,即[a-z,A-Z,0-9]及其组合。
编码长度最大为850个字节。
不允许以正斜线
/
或者反斜线\\
开头。不支持 ASCII 控制字符中的字符上(↑),字符下(↓),字符右(→),字符左(←),分别对应 CAN(24),EM(25),SUB(26),ESC(27)。
对于特殊字符,例如
*
、%
等字符,尽量避免直接作为文件名使用。说明:
如果用户上传的文件或文件夹的名字带有中文,在访问和请求这个文件或文件夹时,中文部分将按照 URL Encode 规则转化为百分号编码。
例如:对
文档.doc
进行访问的时候,文件名称为:文档.doc
,实际读取的按 URL Encode 规则转化的百分号编码为:%e6%96%87%e6%a1%a3.doc
。以下是有效的对象键命名示例:
doc/exampleobject
my.great_photos-2016/01/me.jpg
videos/2016/birthday/video.wmv
特殊字符
有些字符在对象键中可能需要以十六进制形式在 URL 中编码或引用,其中有些甚至是不可被打印的,因此浏览器可能无法处理它们,对于这些字符需要进行特殊处理。可能需要特殊处理的字符如下:
, | : | ; | = |
& | $ | @ | + |
? | ASCII 字符范围:00-1F 十六进制(0-31 十进制)以及7F(127 十进制) | (空格) | |
还有一些字符因为需要进行大量的特殊处理才能在所有应用程序间保持一致性,所以建议直接避免使用。需要避免的字符如下:
` | ^ | " | \\ |
{ | } | [ | ] |
~ | % | # | | |
* | > | < | ASCII 128-255 十进制 |
访问地址
访问地址由存储桶访问地址和文件名称组成,其结构形式为
<存储桶域名>/<文件名称>
。
例如:上传文件exampleobject.txt
到广州(华南)的存储桶examplebucket-1250000000
中,那么exampleobject.txt
的访问地址是:examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com/exampleobject.txt
。文件夹和目录
轻量对象存储(Lighthouse 版)中本身是没有文件夹和目录的概念的,轻量对象存储(Lighthouse 版)不会因为上传对象
project/a.txt
而创建一个project
文件夹。为了满足用户使用习惯,我们在控制台等图形化工具中模拟了「文件夹」或「目录」的展示方式,具体实现是通过创建一个键值为project/
,内容为空的对象,展示方式上模拟了传统文件夹。例如:通过 API、SDK 上传对象
project/doc/a.txt
,分隔符/
会模拟「文件夹」的展示方式,于是可以看到控制台上出现「文件夹」project
和doc
,其中doc
是project
下一级「文件夹」,并包含了a.txt
。注意:
存储桶中不同对象是扁平的分布到不同的分布式集群中的,因此无法直接获取某对象键前缀容量的大小,只能通过累加各对象的大小得到。
对于文件夹和目录进行删除操作,情况会比较复杂,详情如下:
删除途径 | 删除文件或文件夹 | 结果 |
控制台 | 文件夹 project | 对象键前缀为 project/ 的全部对象都会被删除 |
控制台 | 文件 project/doc/a.txt | project 和doc 文件夹仍会保留 |
API、SDK | 文件 project/ 或project/doc/ | 对象 project/doc/a.txt 仍会保留。如果想将文件夹内的对象一并删除,则需要用代码遍历实现删除文件夹内文件的功能 |