阿里云 OSS开发使用文档

阿里云 OSS开发使用文档

阿里云 OSS（Object Storage Service）提供基于网络的数据存取服务。使用 OSS，可以通过网络随时存储和调用包括文本、图片、音频和视频等在内的各种结构化或非结构化数据文件。

阿里云 OSS 将数据文件以对象（object）的形式上传到存储空间（bucket）中。 通过OSS可以创建一个或者多个存储空间，然后向每个存储空间中添加一个或多个文件。也可以通过获取已上传文件的地址进行文件的分享和下载。还可以通过修改存储空间或文件的属性或元信息来设置相应的访问权限。本文档主要内容如下：

• 基本概念
• 开通阿里云 OSS服务
• 使用Java SDK操作OSS
• 其他

---

基本概念

• 存储空间（Bucket）
• 对象/文件（Object）
• Region（地域）
• Endpoint（访问域名）
• AccessKey（访问密钥）

存储空间（Bucket）

存储空间是用于存储对象（Object）的容器，所有的对象都必须隶属于某个存储空间。可以设置和修改存储空间属性用来控制地域、访问权限、生命周期等，这些属性设置直接作用于该存储空间内所有对象，因此可以通过灵活创建不同的存储空间来完成不同的管理功能。

• 同一个存储空间的内部是扁平的，没有文件系统的目录等概念，所有的对象都直接隶属于其对应的存储空间。
• 每个用户可以拥有多个存储空间。
• 存储空间的名称在 OSS 范围内必须是全局唯一的，一旦创建之后无法修改名称。
• 存储空间内部的对象数目没有限制。

存储空间的命名规范如下：

• 只能包括小写字母、数字和短横线（-）。
• 必须以小写字母或者数字开头和结尾。
• 长度必须在3-63字节之间。

对象/文件（Object）

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

根据不同的上传方式，对象的大小限制是不一样的。分片上传 最大支持 48.8TB 的对象大小，其他的上传方式最大支持 5GB。

对象的生命周期是从上传成功到被删除为止。在整个生命周期内，对象信息不可变更。重复上传同名的对象会覆盖之前的对象，因此，OSS 不支持修改文件的部分内容等操作。

OSS 提供了 追加上传 功能，用户可以使用该功能不断地在Object尾部追加写入数据。

对象的命名规范如下：

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

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

Region（地域）

Region 表示 OSS 的数据中心所在的地域，物理位置。用户可以根据费用、请求来源等综合选择数据存储的 Region。一般来说，距离用户更近的 Region 访问速度更快。详细请查看[ OSS 已经开通的 Region](https://help.aliyun.com/document_detail/31837.html?spm=5176.doc31827.2.4.LSbk6U)。 Region是在创建 Bucket 的时候指定的，一旦指定之后就不允许更改，该 Bucket 下所有的 Object 都存储在对应的数据中心，目前不支持 Object 级别的 Region 设置。

Endpoint（访问域名）

Endpoint 表示 OSS 对外服务的访问域名。OSS 以 HTTP RESTful API 的形式对外提供服务，当访问不同的 Region 的时候，需要不同的域名。通过内网和外网访问同一个 Region 所需要的 Endpoint 也是不同的。例如杭州 Region 的外网 Endpoint 是 oss-cn-hangzhou.aliyuncs.com，内网 Endpoint 是 oss-cn-hangzhou-internal.aliyuncs.com。具体的内容请参见[ 各个 Region 对应的 Endpoint](https://help.aliyun.com/document_detail/31834.html?spm=5176.doc31827.2.5.UtF5cG)。

AccessKey（访问密钥）

AccessKey，简称 AK，指的是访问身份验证中用到的 AccessKeyId 和AccessKeySecret。OSS 通过使用 AccessKeyId 和 AccessKeySecret 对称加密的方法来验证某个请求的发送者身份。AccessKeyId 用于标识用户，AccessKeySecret 是用户用于加密签名字符串和 OSS 用来验证签名字符串的密钥，其中 AccessKeySecret 必须保密。对于 OSS 来说，AccessKey 的来源有：

• Bucket 的拥有者申请的 AccessKey。
• 被 Bucket 的拥有者通过 RAM 授权给第三方请求者的 AccessKey。
• 被 Bucket 的拥有者通过 STS 授权给第三方请求者的 AccessKey。

开通阿里云 OSS

开通 OSS 服务后才能使用 OSS 提供的各种功能。具体请参考阿里云OSS在线文档的以下部分：
1. 开通OSS服务
3. 创建存储空间
3. 上传文件
4. 分享文件
5. 删除文件