简介

对象（Object）是对象存储的基本单元，可理解为任何格式类型的数据，例如图片、文档和音视频文件等。存储桶（Bucket）是对象的载体，每个存储桶可容纳任意数量的对象。对象在 COS 中可指定为不同的存储类型，详情请参见 存储类型概述。

每个对象都由对象键（ObjectKey）、对象值（Value）、和对象元数据（Metadata）组成。

• 对象键（ObjectKey）：对象键是对象在存储桶中的唯一标识，可以通俗的理解为文件路径。在 API、SDK 示例中，对象的命名格式为<objectkey>。
• 对象值（Value）：即上传的对象本身，可以通俗的理解为文件内容（Object Content）。
• 对象元数据（Metadata）：是一组键值对，可以通俗的理解为文件的属性，例如文件的修改时间、存储类型等，您可以在上传对象后对其进行查询。

对象键

腾讯云对象存储 COS 中的对象需具有合法的对象键，对象键（ObjectKey）是对象在存储桶中的唯一标识。
例如：在对象的访问地址examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com/folder/picture.jpg 中，对象键为folder/picture.jpg。

命名规范

• 对象键的名称可以使用任何 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 中编码或引用，其中有些甚至是不可被打印的，因此浏览器可能无法处理它们，对于这些字符需要进行特殊处理。可能需要特殊处理的字符如下：

还有一些字符因为需要进行大量的特殊处理才能在所有应用程序间保持一致性，所以建议直接避免使用。需要避免的字符如下：

对象访问地址

对象的访问地址由存储桶访问地址和对象键组成，其结构形式为<存储桶域名>/<对象键> 。
例如：上传对象exampleobject.txt到广州（华南）的存储桶examplebucket-1250000000中，那么exampleobject.txt的访问地址是：examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com/exampleobject.txt。

文件夹和目录

对象存储中本身是没有文件夹和目录的概念的，对象存储不会因为上传对象project/a.txt而创建一个project文件夹。为了满足用户使用习惯，对象存储在控制台、COS browser 等图形化工具中模拟了「文件夹」或「目录」的展示方式，具体实现是通过创建一个键值为project/，内容为空的对象，展示方式上模拟了传统文件夹。

例如：通过 API、SDK 上传对象project/doc/a.txt ，分隔符/会模拟「文件夹」的展示方式，于是可以看到控制台上出现「文件夹」project和doc，其中doc是project下一级「文件夹」，并包含了a.txt。

注意：

存储桶中不同对象是扁平的分布到不同的分布式集群中的，因此无法直接获取某对象键前缀容量的大小，只能通过累加各对象的大小得到。

对于文件夹和目录进行删除操作，情况会比较复杂，详情如下：

对象元数据

对象元数据在对象中是一组键值对，是服务器以 HTTP 协议传 HTML 资料到浏览器前所送出的字符串，又称为 HTTP Header。通过在上传对象时修改 HTTP Header，可以改变页面的响应形式，或者传达配置信息，例如修改缓存时间。

对象元数据包括有两种元数据：系统元数据和用户定义的元数据。

说明：

修改对象的 HTTP Header 不会修改对象本身。

系统元数据

指对象的属性信息，例如对象修改时间、对象大小、存储类型等。

用户定义元数据

指的是对象的可自定义参数，如 Content-Type，Cache-Control，Expires，x-cos-meta-* 等。具体信息请参见 自定义对象 Headers。

对象操作

用户可以通过腾讯云控制台、工具、API、SDK 等多种方式管理对象。

注意：

按照支持的最大上传文件大小，划分为两种上传方式：简单上传 和 分块上传。

• 使用简单上传，对象大小限制在5GB以内。
• 使用分块上传，每块的大小限制在5GB以内，分块数量需要小于10000，即最大上传对象约为48.82TB，更多限制说明，请参见 规格与限制。

上传对象完成后，用户可以通过控制台对对象进行相关配置，具体请参见以下内容：

• 搜索对象
• 查看对象信息
• 设置对象的访问权限
• 设置自定义 Headers

对象子资源

COS 有与存储桶和对象相关联的子资源。子资源从属于对象，即子资源不会自行存在，它始终与某些其他实体（例如对象或存储桶）相关联。 访问控制列表（Access Control List）是指特定对象的访问控制信息列表，它是 COS 中对象的子资源。

访问控制列表包含可以识别被授权者和其被授予的许可的授权列表，来实现对对象的访问控制。创建对象时，ACL 将识别可以完全控制对象的对象所有者。用户可以检索对象 ACL 或将其替换为更新的授权列表。

说明：

对 ACL 的任何更新都需要替换现有 ACL。

访问权限类型

对象存储 COS 支持对象设置两种权限类型：公共权限和用户权限。
公共权限：包括继承权限、私有读写和公有读私有写。

• 继承权限：对象继承存储桶的权限，与存储桶的访问权限一致。当访问对象时，COS 读取到对象权限为继承存储桶权限，会匹配存储桶的权限，来响应访问。任何新对象被添加时，默认继承存储桶权限。
• 私有读写：当访问对象时，COS 读取到对象的权限为私有读写，此时无论存储桶为何种权限，对象都需要通过 请求签名 才可访问。
• 公有读私有写：当访问对象时，COS 读取到对象的权限为公有读，此时无论存储桶为何种权限，对象都可以被直接下载。

用户权限：主账号默认拥有对象所有权限（即完全控制）。另外 COS 支持添加子账号有数据读取、数据写入、权限读取、权限写入，甚至完全控制的最高权限。

适用场景

在私有读写的存储桶中对特定对象设置允许公有访问，或在公有读写存储桶中对特定对象设置需要鉴权才可访问。