对象存储 OSS 开发人员指南

开发人员指南

OSS 基本概念介绍

本部分将向您介绍本产品中涉及的几个基本概念以便于您更好地理解对象存储 OSS 产品。

存储空间（Bucket） 存储空间是您用于存储对象（Object）的容器，所有的对象都必须隶属于某个存储空间。您可以设置和修改存 储空间属性用来控制地域、访问权限、生命周期等，这些属性设置直接作用于该存储空间内所有对象，因此您 可以通过灵活创建不同的存储空间来完成不同的管理功能。 同一个存储空间的内部是扁平的，没有文件系统的目录等概念，所有的对象都直接隶属于其对应的存 储空间。 每个用户可以拥有多个存储空间。

存储空间的名称在 OSS 范围内必须是全局唯一的，一旦创建之后无法修改名称。 存储空间内部的对象数目没有限制。

存储空间的命名规范如下： 只能包括小写字母，数字和短横线（-）。 必须以小写字母或者数字开头。 长度必须在3-63字节之间。

对象/文件（Object） 对象是 OSS 存储数据的基本单元，也被称为 OSS 的文件。对象由元信息（Object Meta），用户数据 （Data）和文件名（Key）组成。对象由存储空间内部唯一的 Key 来标识。对象元信息是一个键值对，表示了 对象的一些属性，比如最后修改时间、大小等信息，同时用户也可以在元信息中存储一些自定义的信息。

根据不同的上传方式，对象的大小限制是不一样的。分片上传 最大支持 48.8TB 的对象大小，其他的上传方式 最大支持 5GB。 对象的生命周期是从上传成功到被删除为止。在整个生命周期内，对象信息不可变更。重复上传同名的对象会 覆盖之前的对象，因此，OSS 不支持修改文件的部分内容等操作。 OSS 提供了 追加上传 功能，用户可以使用该功能不断地在Object尾部追加写入数据。

对象的命名规范如下：

使用UTF-8编码。 长度必须在1-1023字节之间。 不能以“/”或者“\”字符开头。

注意：对象名称需要区分大小写。如无特殊说明，本文档中的对象、文件称谓等同于 Object。