当前位置：文档之家 › OSS_API_20121115

OSS_API_20121115

  • 格式：pdf
  • 大小：1.68 MB
  • 文档页数：85

目录前言 (3)1.阿里云存储服务简介 (4)2.基本概念 (5)2.1Object (5)2.2Bucket (5)2.3Access Key ID、Access Key Secret (5)2.4Service (6)3.OSS功能简介 (7)3.1OSS基本功能 (7)3.2Object外链地址的构成规则 (7)3.3OSS防盗链 (8)3.4访问日志记录(Server Access Logging) (8)3.5服务器端加密编码 (11)4.访问控制 (13)4.1用户签名验证（Authentication） (13)4.2在Head中包含签名 (13)4.3在URL中包含签名 (18)4.4Bucket权限控制 (19)5.开放接口规范 (21)5.1公共HTTP头定义 (22)5.1.1公共请求头（Common Request Headers） (22)5.1.2公共响应头（Common Response Headers） (22)5.2关于Service的操作 (23)5.2.1GetService (ListBucket) (23)5.3关于Bucket的操作 (26)5.3.1Delete Bucket (26)5.3.2Get Bucket (List Object) (28)5.3.3Get Bucket Acl (36)5.3.4Put Bucket (38)5.3.5Put Bucket Acl (40)5.4关于Object操作 (42)5.4.1Copy Object (42)5.4.2Delete Object (46)5.4.3Delete Multiple Objects (47)5.4.4Get Object (51)5.4.5Head Object (55)5.4.6Put Object (57)5.5关于Multipart Upload的操作 (60)5.5.1Initiate Multipart Upload (60)5.5.2Upload Part (63)5.5.3Complete Multipart Upload (65)5.5.4Abort Multipart Upload (69)5.5.5List Multipart Uploads (70)5.5.6List Parts (74)6.OSS的错误响应 (78)6.1OSS的错误响应格式 (78)6.2OSS的错误码 (79)6.3OSS不支持分块传输编码 (81)6.4OSS不支持的操作 (82)6.5OSS操作支持但参数不支持的操作 (84)前言本文档是阿里云存储服务（OSS）的开发帮助指南，描述了OSS中的基本概念、提供的服务以及可用的API。

1.阿里云存储服务简介阿里云存储服务（OpenStorageService，简称OSS），是阿里云对外提供的海量，安全，低成本，高可靠的云存储服务。

用户可以通过简单的REST接口，在任何时间、任何地点、任何互联网设备上进行上传和下载数据，也可以使用WEB 页面对数据进行管理。

同时，OSS提供Java、Python、PHP、C#语言的SDK，简化用户的编程。

基于OSS，用户可以搭建出各种多媒体分享网站、网盘、个人和企业数据备份等基于大规模数据的服务。

公网的OSS访问地址：阿里云主机的内网OSS访问地址1：OSS的web控制台地址：/1阿里云主机通过内网域名访问OSS，会拥有比访问公网域名更快的响应时间、更高的传输速度；同时，上传、下载流量都是免费的。

2.基本概念2.1Object在OSS中，用户操作的基本数据单元是Object。

单个Object最大允许存储5TB的数据。

Object包含key、meta和data。

其中，key是Object的名字；meta 是用户对该object的描述，由一系列name-value对组成；data是Object的数据。

⏹Object命名规范使用UTF-8编码长度必须在1-1023字节之间不能以“/”或者“\”字符开头2.2BucketBucket是OSS上的命名空间，也是计费、权限控制、日志记录等高级功能的管理实体；Bucket名称在整个OSS服务中具有全局唯一性，且不能修改；存储在OSS上的每个Object必须都包含在某个Bucket中。

一个应用，例如图片分享网站，可以对应一个或多个Bucket。

一个用户最多可创建10个Bucket，但每个Bucket中存放的Object的数量和大小总和没有限制，用户不需要考虑数据的可扩展性。

⏹Bucket命名规范只能包括小写字母，数字，短横线（-）必须以小写字母或者数字开头长度必须在3-63字节之间2.3Access Key ID、Access Key Secret用户注册OSS时，系统会给用户分配一对Access Key ID和Access Key Secret，称为ID对，用于标识用户，为访问OSS做签名验证。

2.4ServiceOSS提供给用户的虚拟存储空间，在这个虚拟空间中，每个用户可拥有一个到多个Bucket。

3. OSS 功能简介3.1 OSS 基本功能OSS 为用户提供数据存储服务，用户可以通过以下操作来处理OSS 上的数据： ⏹ 创建、查看、罗列、删除 Bucket ⏹ 修改、获取Bucket 的访问权限⏹ 上传、查看、罗列、删除、批量删除Object ⏹ 对于大文件支持分片上传（Multi-Part Upload ） ⏹ 访问时支持If-Modified-Since 和If-Match 等HTTP 参数3.2 Object 外链地址的构成规则如果一个bucket 设置成公开读权限（详见下一章：访问控制），意味着你允许其他用户来访问属于你的object 。

你的object 的外链地址构成规则如下：例如，在一个名为oss-example 的bucket 中，有一个名为"aliyun-log.png"的object （content-type 为image/png）。

那么这个object 的外链URL 为：构成规则的示意图如下：用户可以直接该URL 链接放入HTML 中使用：http://oss-example.oss.a om/aliyun-logo.png hostbu3.3OSS防盗链OSS是按使用收费的服务，为了防止用户在OSS上的数据被其他人盗链，OSS支持基于HTTP header中表头字段referer的防盗链方法。

目前，只有通过OSS的控制台（）可以对一个bucket设置referer字段的白名单和是否允许referer字段为空的请求访问。

例如，对于一个名为oss-example的bucket，设置其referer白名单为。

则所有referer为的请求才能访问oss-example这个bucket中的Object。

细节分析：1)用户只有通过URL签名或者匿名访问Object时，才会做防盗链验证。

请求的Header中有“Authorization”字段的，不会做防盗链验证。

2)一个bucket可以支持多个referer参数，这些参数之间由“，”号分隔。

3)Referer参数支持通配符“*”和“？”。

4)用户可以设置是否允许referer字段为空的请求访问。

5)白名单为空时，不会检查referer字段是否为空（不然所有的请求都会被拒绝）。

6)白名单不为空，且设置了不允许referer字段为空的规则；则只有referer属于白名单的请求被允许，其他请求（包括referer为空的请求）会被拒绝。

7)如果白名单不为空，但设置了允许referer字段为空的规则；则referer为空的请求和符合白名单的请求会被允许；其他请求都会被拒绝。

8)Bucket的三种权限（private，public-read，public-read-write）都会检查referer字段。

注意：OSS更多的防盗链的规则正在开发中。

3.4访问日志记录2(Server Access Logging)OSS为用户提供自动保存访问日志记录功能。

Bucket的拥有者可以通过OSS2OSS提供Bucket访问日志的目的是方便bucket的拥有者理解和分析bucket的访问行为。

OSS提供的Bucket访问日志不保证记录下每一条访问记录。

控制台（），为其所拥有的bucket开启访问日志记录功能。

当一个bucket（源Bucket，Source Bucket）开启访问日志记录功能后，OSS自动将访问这个bucket的请求日志，以小时为单位，按照固定的命名规则，生成一个Object写入用户指定的bucket（目标Bucket，Target Bucket）。

存储访问日志记录的object命名规则：命名规则中，TargetPrefix由用户指定；YYYY, mm, DD, HH, MM和SS分别是该Object被创建时的阿拉伯数字的年，月，日，小时，分钟和秒（注意位数）；UniqueString为OSS系统生成的字符串。

一个实际的用于存储OSS访问日志的Object名称例子如下：上例中，“MyLog-”是用户指定的Object前缀；“oss-example”是源bucket 的名称；“2012-09-10-04-00-00”是该Object被创建时的北京时间；“0000”是OSS系统生成的字符串。

LOG文件格式（从左至右，以空格分隔）：细节分析：1)源Bucket和目标Bucket必须属于同一个用户。

2)“TargetPrefix”表示存储访问日志记录的object名字前缀，可以为空。

3)源bucket和目标bucket可以是同一个Bucket，也可以是不同的Bucket；用户也可以将多个的源bucket的LOG都保存在同一个目标bucket内（建议指定不同的TargetPrefix）。

4)OSS以小时为单位生成bucket访问的Log文件，但并不表示这个小时的所有请求都记录在这个小时的LOG文件内，也有可能出现在上一个或者下一个LOG 文件中。

5)OSS生成的Log文件命名规则中的“UniqueString”仅仅是OSS为其生成的UUID，用于唯一标识该文件。

6)OSS生成一个bucket访问的Log文件，算作一次PUT操作，并记录其占用的空间，但不会记录产生的流量。

LOG生成后，用户可以按照普通的Object来操作这些LOG文件。

7)OSS会忽略掉所有以“x-”开头的query-string参数，但这个query-string会被记录在访问LOG中。

如果你想从海量的访问日志中，标示一个特殊的请求，可以在URL中添加一个“x-”开头的query-string参数。

合集下载

阿里云内容安全API参考（检测服务）说明书

阿里云内容安全API参考（检测服务）说明书

内容安全API参考（检测服务）··法律声明法律声明阿里云提醒您在阅读或使用本文档之前仔细阅读、充分理解本法律声明各条款的内容。

如果您阅读或使用本文档，您的阅读或使用行为将被视为对本声明全部内容的认可。

1. 您应当通过阿里云网站或阿里云提供的其他授权通道下载、获取本文档，且仅能用于自身的合法合规的业务活动。

本文档的内容视为阿里云的保密信息，您应当严格遵守保密义务；未经阿里云事先书面同意，您不得向任何第三方披露本手册内容或提供给任何第三方使用。

2. 未经阿里云事先书面许可，任何单位、公司或个人不得擅自摘抄、翻译、复制本文档内容的部分或全部，不得以任何方式或途径进行传播和宣传。

3. 由于产品版本升级、调整或其他原因，本文档内容有可能变更。

阿里云保留在没有任何通知或者提示下对本文档的内容进行修改的权利，并在阿里云授权通道中不时发布更新后的用户文档。

您应当实时关注用户文档的版本变更并通过阿里云授权渠道下载、获取最新版的用户文档。

4. 本文档仅作为用户使用阿里云产品及服务的参考性指引，阿里云以产品及服务的“现状”、“有缺陷”和“当前功能”的状态提供本文档。

阿里云在现有技术的基础上尽最大努力提供相应的介绍及操作指引，但阿里云在此明确声明对本文档内容的准确性、完整性、适用性、可靠性等不作任何明示或暗示的保证。

任何单位、公司或个人因为下载、使用或信赖本文档而发生任何差错或经济损失的，阿里云不承担任何法律责任。

在任何情况下，阿里云均不对任何间接性、后果性、惩戒性、偶然性、特殊性或刑罚性的损害，包括用户使用或信赖本文档而遭受的利润损失，承担责任（即使阿里云已被告知该等损失的可能性）。

5. 阿里云网站上所有内容，包括但不限于著作、产品、图片、档案、资讯、资料、网站架构、网站画面的安排、网页设计，均由阿里云和/或其关联公司依法拥有其知识产权，包括但不限于商标权、专利权、著作权、商业秘密等。

非经阿里云和/或其关联公司书面同意，任何人不得擅自使用、修改、复制、公开传播、改变、散布、发行或公开发表阿里云网站、产品程序或内容。

oss渗透参数

oss渗透参数

oss渗透参数1) 目标URL：指定要进行渗透测试的网站或应用程序的URL。

2) 端口号：要进行测试的端口号，通常使用常见的HTTP端口号如80或443。

3) 请求方法：指定要使用的HTTP请求方法，如GET、POST、PUT、DELETE等。

4) Cookie：如果目标网站需要登录才能访问特定页面，则需要提供有效的Cookie信息。

5) 用户名和密码：如果网站有登录功能，则需要提供有效的用户名和密码进行测试。

6) 文件上传：测试文件上传功能时，可以指定要上传的恶意文件。

7) HTTP头：可以通过修改HTTP头来测试网站的反向代理或防火墙配置。

8) SQL注入：指定要进行的SQL注入测试的参数和有效载荷。

9) XSS注入：指定要进行的XSS注入测试的参数和有效载荷。

10) 文件包含：指定要进行文件包含测试的参数和有效载荷。

11) 目录遍历：指定要进行目录遍历测试的目录和文件。

12) 文件删除：指定要进行文件删除测试的目录和文件。

13) 远程代码执行：指定要进行远程代码执行测试的命令。

14) 文件下载：指定要进行文件下载测试的URL和文件名。

15) XML实体注入：指定要进行XML实体注入测试的参数和有效载荷。

16) SSRF攻击：指定要进行SSRF攻击测试的URL和目标。

17) XXE攻击：指定要进行XXE攻击测试的参数和有效载荷。

18) CSRF攻击：指定要进行CSRF攻击测试的参数和有效载荷。

19) 邮件注入：指定要进行邮件注入测试的参数和有效载荷。

20) 逻辑漏洞：指定要进行逻辑漏洞测试的攻击序列。

阿里云oss操作方法

阿里云oss操作方法

阿里云oss操作方法
阿里云OSS（对象存储服务）是一种安全、可靠、高扩展性的云端存储服务。

下面是一些常用的阿里云OSS操作方法：
1. 创建存储空间：使用OSS控制台或API创建存储空间，存储空间是存储对象的基本单位。

2. 上传文件：通过OSS控制台、API或SDK等方式将文件上传到存储空间中。

3. 下载文件：从存储空间中下载文件到本地。

4. 删除文件：删除存储空间中的文件。

5. 列举文件：列出存储空间中的文件列表，可以根据条件筛选文件。

6. 设置访问权限：通过OSS控制台或API设置存储空间或文件的访问权限，包括公共读写权限、私有权限等。

7. 使用生命周期规则：通过OSS控制台或API设置生命周期规则，自动对存储空间中的文件进行过期删除、转储等操作。

8. 使用数据迁移工具：阿里云提供了数据传输服务（DTS）等工具，可以方便
地将数据传输到OSS中或从OSS中导出数据。

以上是一些常用的阿里云OSS操作方法，用户可以根据实际需求选择合适的方法进行操作。

阿里云-对象存储服务OSS API手册

阿里云-对象存储服务OSS API手册

API手册OSS API 文档简介阿里云对象存储服务（Object Storage Service，简称OSS），是阿里云对外提供的海量，安全，低成本，高可靠的云存储服务。

用户可以通过本文档提供的简单的REST接口，在任何时间、任何地点、任何互联网设备上进行上传和下载数据。

基于OSS，用户可以搭建出各种多媒体分享网站、网盘、个人和企业数据备份等基于大规模数据的服务。

请确保在使用这些接口前，已充分了解了OSS产品说明、使用协议和收费方式。

API概览基本概念本文中出现的一些术语请参考OSS 基本概念关于Service操作关于Bucket的操作关于Object的操作关于Multipart Upload的操作---跨域资源共享(CORS)访问控制用户签名验证（Authentication）OSS通过使用AccessKeyId/ AccessKeySecret对称加密的方法来验证某个请求的发送者身份。

AccessKeyId用于标示用户，AccessKeySecret是用户用于加密签名字符串和OSS用来验证签名字符串的密钥，其中AccessKeySecret必须保密，只有用户和OSS知道。

AccessKey 根据所属账号的类型有所区分阿里云账户AccessKey：每个阿里云账号提供的AccessKey拥有对拥有的资源有完全的权限RAM账户AccessKey：RAM账户由阿里云账号授权生成，所拥的AccessKey拥有对特定资源限定的操作权限STS临时访问凭证：由阿里云账号或RAM账号生成，所拥的AccessKey在限定时间内拥有对特定资源限定的操作权限。

过期权限收回。

详情请参考OSS产品文档中访问身份验证当用户想以个人身份向OSS发送请求时，需要首先将发送的请求按照OSS指定的格式生成签名字符串；然后使用AccessKeySecret对签名字符串进行加密产生验证码。

OSS收到请求以后，会通过AccessKeyId找到对应的AccessKeySecret，以同样的方法提取签名字符串和验证码，如果计算出来的验证码和提供的一样即认为该请求是有效的；否则，OSS将拒绝处理这次请求，并返回HTTP 403错误。