1
目 录
前 言 ....................................................... 3
1. 阿里云存储服务简介 ..................................... 4
2. 基本概念 .............................................. 5
2.1 Object ............................................................................................. 5
2.2 Object Group .................................................................................. 5
2.3 Bucket ............................................................................................ 5
2.4 Access ID、Access key .................................................................. 6
2.5 Service ........................................................................................... 6
3. 基本功能 .............................................. 7
4. 访问控制 .............................................. 8
4.1 用户签名验证(Authentication) ................................................. 8
4.2 在 Head 中包含签名 ...................................................................... 8
4.3 在 URL 中包含签名 .....................................................................12
4.4 Bucket 权限控制 ...........................................................................14
4.5 Object 外链地址的构成规则 ........................................................14
4.6 防盗链 ..........................................................................................15
5. 开放接口规范 ......................................... 17
5.1 关于 Service 的操作 .....................................................................17
5.1.1 GetService (ListBucket) ..........................................................17
5.2 关于 Bucket 的操作 ......................................................................18
5.2.1 Put Bucket ..............................................................................18
5.2.2 Put Bucket ACL ......................................................................20
5.2.3 Get Bucket (List Object) .........................................................21
5.2.4 Get Bucket ACL .....................................................................27
5.2.5 Delete Bucket .........................................................................28
5.3 关于 Object 操作 ..........................................................................29
5.3.1 Put Object ...............................................................................29
5.3.2 Get Object ..............................................................................31
2
5.3.3 Copy Object............................................................................35
5.3.4 Head Object ............................................................................37
5.3.5 DeleteObject ...........................................................................38
5.3.6 Delete Multiple Object ............................................................39
5.4 关于 Multipart Upload 的操作 ......................................................43
5.4.1 Initiate Multipart Upload ........................................................43
5.4.2 Upload Part .............................................................................44
5.4.3 Complete Multipart Upload ....................................................46
5.4.4 Abort Multipart Upload ..........................................................48
5.4.5 List Multipart Uploads ............................................................48
5.4.6 List Parts ................................................................................51
5.5 关于 Object Group 的操作 ............................................................54
5.5.1 Post Object Group ..................................................................54
5.5.2 Get Object Group....................................................................56
5.5.3 Get Object Group Index ..........................................................57
5.5.4 Head Object Group .................................................................59
5.5.5 Delete Object Group ...............................................................59
6. OSS 的错误响应 ........................................ 60
6.1. OSS 的错误响应格式 ...................................................................60
6.2. OSS 的错误码 ..............................................................................61
6.3. 不支持的操作 ...............................................................................62
6.4. 操作支持但参数不支持的操作 ....................................................63
3
前 言
本文档是阿里云存储服务(OSS)的开发帮助指南,描述了 OSS 中的基本概
念、提供的服务以及可用的 API。
4
1. 阿里云存储服务简介
阿里云存储服务(OpenStorageService,简称 OSS),是阿里云对外提供的
海量,安全,低成本,高可靠的云存储服务。用户可以通过简单的 REST 接口,
在任何时间、任何地点、任何互联网设备上进行上传和下载数据,也可以使用
WEB 页面对数据进行管理。同时,OSS 提供 Java、Python、PHP SDK,简化用户
的编程。基于 OSS,用户可以搭建出各种多媒体分享网站、网盘、个人企业数据
备份等基于大规模数据的服务。
OSS 访问地址: http://storage.aliyun.com
OSS 内网访问地址:http://storage-vm.aliyun-inc.com
OSS 的 web 体验地址:http://oss.aliyun.com/
(注:内网访问地址仅适用于阿里云服务器(VM)与 OSS 之间的访问通信)