GB/T 31916.2-2015 信息技术 云数据存储和管理 第2部分：基于对象的云存储应用接口

　　ICS 35. 100. 05 L 79

　　中 华 人 民 共 和 国 国 家 标 准

　　GB/T 31916.2—2015

　　信息技术 云数据存储和管理

　　第 2 部分 :基于对象的云存储应用接口

　　Information technology—Clouddatastorageand management—

　　Part2 : Object-based cloud storageapplication interface

　　2015-09-11发布 2016-05-01实施

　　中华人民共和国国家质量监督检验检疫总局中 国 国 家 标 准 化 管 理 委 员 会

　　发

　　布

　　GB/T 31916.2—2015

　　GB/T 31916.2—2015

　　前 言

　　GB/T 31916《信息技术 云数据存储和管理》分为六个部分 :

　　— 第 1部分 :总则 ;

　　— 第 2部分 :基于对象的云存储应用接 口 ;

　　— 第 3部分 :分布式文件存储应用接 口 ;

　　— 第 4部分 :基于块的云存储应用接 口 ;

　　— 第 5部分 :基于键值(Key-Value)的云数据管理应用接 口 ;

　　— 第 6部分 : 分布式关系数据库应用接 口 。

　　本部分为 GB/T 31916的第 2部分 。

　　本部分按照 GB/T 1. 1—2009给出的规则起草 。

　　请注意本文件的某些内容可能涉及专利 。本文件的发布机构不承担识别这些专利的责任 。

　　本部分由全国信息技术标准化技术委员会(SAC/TC28)提出并归 口 。

　　本部分起草单位 : 中国移动通信有限公司研究院 、东北大学软件学院 、华为技术有限公司 、上海计算机软件技术开发中心 、中国电子技术标准化研究院 、浪潮(北京)电子信息产业有限公司 、阿里云计算有限公司 、中兴通讯股份有限公司 、华中科技大学 。

　　本部分主要起草 人 : 孙 少 陵 、李 海 波 、杜 宇 健 、宋 杰 、王 洁 萍 、余 祥 、王 姝 、蔡 立 志 、陈 岭 、颜 秉 珩 、李战园 、刘晓辉 、周可 、胡捷 、吴涛 、张东 、田忠 、秦习庆 、王娟 、陈志峰 、王卫国 、丛培勇 、杨丽蕴 。

　　信息技术 云数据存储和管理

　　第 2 部分 :基于对象的云存储应用接口

　　1 范围

　　GB/T 31916的本部分给出了基于对象的云数据存储(以下简称云存储) 体系结构 , 规定了基于对象的云存储的应用接口通用要求和应用接口定义 。

　　本部分适用于基于对象的云存储的设计 、开发和使用 。

　　2 规范性引用文件

　　下列文件对于本文件的应用是必不可少的 。凡是注 日期的引用文件 ,仅注 日期的版本适用于本文件 。凡是不注日期的引用文件 ,其最新版本(包括所有的修改单)适用于本文件 。

　　GB/T 7408—2005 数据元和交换格式 信息交换 日期和时间表示法

　　GB/T 26231—2010 信息技术 开放系统互连 OID 的国家编号体系和注册规程

　　GB/T 31916. 1—2015 信息技术 云数据存储和管理应用接 口 第 1部分 :总则

　　RFC 822ARPA 互 联 网 文 本 消 息 格 式 标 准(Standard for the Format of ARPA Internet Text Messages)

　　RFC2616 超文本传输协议(HTTP)1.1(HypertextTransferProtocolHTTP/1.1)

　　3 术语、定义和缩略语

　　3. 1 术语和定义

　　GB/T 31916. 1—2015界定的以及下列术语和定义适用于本文件 。

　　3. 1. 1

　　容器 container

　　基于对象的云存储中存储对象的逻辑空间 。

　　注 : 容器由容器名 、容器标识和元数据组成 。每个容 器 拥 有 一 个 全 球 唯 一 的 容 器 标 识 。通 过 容 器 标 识 可 唯 一 定 位到该容器 。容器是对容器内对象总体进行统计和访问控制的入口点 。

　　3. 1.2

　　配额 quota

　　为用户分配的系统资源最大使用量 。

　　3.2 缩略语

　　下列缩略语适用于本文件 。

　　ACL 访问控制列表(Access Control List)

　　HTTP 超文本传输协议(HypertextTransferProtocol)

　　MIME 多功能因特网邮件扩充服务(Multipurpose InternetMailExtensions)

　　OBS 对象存储(Object-based Storage)

　　URI 统一资源标识符(Uniform Resource Identifier)

　　GB/T 31916.2—2015

　　XML 可扩展置标语言(Extensible Markup Language)

　　4 基于对象的云存储体系结构

　　基于对象的云存储体系结构如图 1所示 。

　　图 1 基于对象的云存储体系结构

　　基于对象的云存储由接口层 、服务层和存储层构成 。接口层通过 WEB服务为应用系统提供基于HTTP协议的对象存储服务。服务层实现对象、容器及用户的相关功能。用户的实际数据保存在对象中 ,容器为对象的逻辑存储空间 。每个对象应属于一个容器 。对象和容器之间的关系如图 2所示 。

　　图 2 对象和容器之间的关系

　　用户相关功能包括用户身份认证管理和访问控制 。通过用户身份认证管理保证只有合法用户才能访问基于对象的云存储 。完成用户身份安全管理后 ,通过访问控制进行用户状态、配额和操作权限的管理 。

　　存储层为服务层提供基础的存储空间 。存储层应采用可扩展的存储架构 ,具体存储技术应对外部应用透明 。

　　5 基于对象的云存储应用接口通用要求

　　5. 1 概述

　　基于对象的云存储应用接口通用要求包括接口协议 、身份认证管理 、访问控制 、状态码信息描述 、补充出错信息 、公共请求头 、公共响应头和出错信息描述要求 8 项内容 。其中 ,接口协议 、身份认证管理 、

　　状态码信息描述和出错信息描述要求 4项内容应符合 GB/T 31916. 1—2015 中第 5 章规定 。

　　5.2 访问控制

　　基于对象的云存储应提供访问控制机制 ,可通过 ACL等方式进行访问控制管理 。

　　基于 ACL 的访问控制见附录 A。

　　5.3 补充出错信息

　　基于对象的云存储发生的出错响应较为复杂,需要对 HTTP状态码补充出错信息描述。补充出错信息格式符合 GB/T 31916. 1—2015 中 5. 4 的要求 。

　　补充出错信息描述见附录 B。

　　5.4 公共请求头

　　基于对象的云存储应用接口的时间格式按 GB/T 7408—2005规定的格式 。

　　HTTP请求头格式描述见表 1(见 RFC2616)。

　　表 1 公共请求头

　　5.5 公共响应头

　　基于对象的云存储应用接口的 HTTP公共响应头格式描述见表 2。

　　表 2 公共响应头

　　6 基于对象的云存储应用接口定义

　　6. 1 概述

　　基于对象的云存储应用接口包括容器相关功能和对象相关功能 。

　　容器相关功能应包括 :

　　a) 创建容器 ;

　　b) 删除容器 ;

　　c) 获取用户所有容器 ;

　　d) 获取容器中对象列表 。

　　当采用 ACL方式进行用户访问控制时 ,容器相关功能还应包括 :

　　e) 获取容器权限 ;

　　f) 设置容器权限 。

　　对象相关功能应包括 :

　　a) 创建对象 ;

　　b) 删除对象 ;

　　c) 获取对象 ;

　　d) 获取对象属性 ;

　　e) 设置对象属性 。

　　当采用 ACL方式进行用户访问控制时 ,对象相关功能还应包括 :

　　f) 获取对象权限 ;

　　g) 设置对象权限 。

　　6.2 容器相关功能

　　6.2. 1 创建容器

　　6.2. 1. 1 功能描述

　　用户创 建 一 个 容 器 标 识 符 全 局 唯 一 的 空 容 器 。 容 器 标 识 符 宜 采 用 URI 方 式 , 也 可 采 用GB/T 26231—2010规定的 OID方式 。

　　6.2. 1.2 请求消息头

　　PUT/ContainerName HTTP/1.1

　　6.2. 1.3 请求参数

　　无 。

　　6.2. 1.4 消息头附加域

　　消息头附加域应包含信息见表 3。

　　表 3 消息头附加域信息

　　6.2. 1.5 请求体参数

　　请求体参数应包含信息见表 4。

　　表 4 请求体参数信息

　　6.2. 1.6 响应消息代码

　　如果创建容器成功 ,返回状态码 201;如果失败 ,根据原因设置状态码和附加出错信息 。

　　6.2. 1.7 响应参数

　　无 。

　　6.2. 1. 8 响应消息体参数

　　无 。

　　6.2. 1.9 消息示例

　　请求消息见示例 1。

　　示例 1:

　　PUT/MyPictureContainer HTTP/1.1

　　Host: obs. china. com

　　Content-Length: 0

　　Date: Sun, 6 Feb 2011 18:10:00 GMT

　　Authorization: OBSJKLkD346SDFGH958606C:cKJGHbghad5869HDFJ+ xQE0diMbL

　　Region03

　　响应消息见示例 2。

　　示例 2:

　　HTTP/1.1201Created

　　Date: Sun, 6 Feb 2011 18:10:00 GMT

　　Content-Length: 0

　　Server: ObsServer

　　6.2.2 删除容器

　　6.2.2. 1 功能描述

　　用户删除一个空的容器 。如果容器中存在对象 ,则删除失败 。

　　6.2.2.2 请求消息头

　　DELETE/ContainerName HTTP/1.1

　　6.2.2.3 请求参数

　　无 。

　　6.2.2.4 消息头附加域

　　无 。

　　6.2.2.5 请求体参数

　　无 。

　　6.2.2.6 响应消息代码

　　状态码根据定义返回 ,成功为 204;如果失败 ,根据原因设置状态码和附加出错信息 。

　　6.2.2.7 响应参数

　　无 。

　　6.2.2. 8 响应消息体参数

　　无 。

　　6.2.2.9 消息示例

　　请求消息见示例 1。

　　示例 1:

　　DELETE/MyPictureContainer HTTP/1.1

　　Host: obs. china. com

　　Date: Sun, 6 Feb 2011 18:10:00 GMT

　　Authorization: OBS1F177624EXAMP420D5D3:bLRepdf3YB+FIERepdf3YB+IERep

　　响应消息见示例 2。

　　示例 2:

　　HTTP/1.1204No Content

　　Date: Wed, 01 Mar2009 12:00:00 GMT

　　Server: ObsServer

　　6.2.3 获取用户所有容器

　　6.2.3. 1 功能描述

　　用户获取自己账户下的容器列表 ,包括每个容器的相关信息 。

　　6.2.3.2 请求消息头

　　GET/HTTP/1.1

　　6.2.3.3 请求参数

　　无 。

　　6.2.3.4 消息头附加域

　　无 。

　　6.2.3.5 请求体参数

　　无 。

　　6.2.3.6 响应消息代码

　　状态码根据定义返回 ,成功为 200;如果失败 ,根据原因设置状态码和补充出错信息 。

　　6.2.3.7 响应参数

　　无 。

　　6.2.3. 8 响应消息体参数

　　响应消息体参数应包含信息见表 5。

　　表 5 响应消息体参数信息

　　6.2.3.9 消息示例

　　请求消息见示例 1。

　　示例 1:

　　GET/HTTP/1.1

　　Host: obs. china. com

　　Date: Sun, 6 Feb 2011 18:10:00 GMT

　　Authorization: OBS15IUYRRTY876OIU4D346:gETYUIajlgrf387= ku0diMbLRepd

　　消息响应见示例 2。

　　示例 2:

　　HTTP/1.1200OK

　　Date: Sun, 6 Feb 2011 18:10:00 GMT

　　Content-Length: 322

　　Server: ObsServer

　　Frank

　　MyPictureFolder

　　Sun, 6 Feb 201101:30:00 GMT

　　< ContainerName > MyDocumentFolder

　　Sun, 6 Feb 201102:30:00 GMT

　　6.2.4 获取容器中对象列表

　　6.2.4. 1 功能描述

　　用户获取容器中所有对象的列表 ,并可通过输入参数对结果集合进行筛选 。此操作每次返回以字典序排序的指定数量的对象结果集 ,指定数量的上限由服务提供商确定 。用户应对容器有读访问权限 ,否则无法获取结果 。

　　6.2.4.2 请求消息头

　　GET/ContainerName? prefix=prefix&maxResults=maxResults&marker=marker HTTP/1.1 6.2.4.3 请求参数

　　请求参数应包含信息见表 6。

　　表 6 请求参数信息

　　6.2.4.4 消息头附加域无 。

　　6.2.4.5 请求体参数

　　无 。

　　6.2.4.6 响应消息代码

　　状态码根据定义返回 ,成功为 200;如果失败 ,根据原因设置状态码和补充出错信息 。

　　6.2.4.7 响应参数

　　无 。

　　6.2.4. 8 响应消息体参数

　　响应消息体参数应包含信息见表 7。

　　表 7 响应消息体参数信息

　　6.2.4.9 消息示例

　　请求消息见示例 1。

　　示例 1:

　　GET/MyPicture? prefix=cloud&maxResults=50HTTP/1.1

　　Host: obs. china. com

　　Date: Wed, 25 Nov2009 12:00:00 GMT

　　Authorization: OBSKHGF568HJG254LUTRE65:kljgogbas+ = ao9872bgvsfoijGHT消息响应见示例 2。

　　示例 2:

　　HTTP/1.1200OK

　　Date: Wed, 01 Mar2009 12:00:00 GMT

　　Content-Length: 236

　　Server: ObsServer

　　MyPicture

　　cloud

　　< MaxResults>50

　　< IsTruncated > false

　　/MyPicture/cloudObj1

　　< SystemMetadata >

　　Sun,18Nov200606:12:00 GMT

　　1024

　　6.2.5 获取容器权限

　　6.2.5. 1 功能描述

　　当采用 ACL方式(见附录 A)进行访问控制时 ,用户利用本接口获取容器的 ACL。 用户应对容器有 READ_ACP访问权限 ,否则不能获取结果 。操作 目标由 “/ContainerName? acl”组成的 URI表示 ,其中 ,“ContainerName”为容器名称 ,“acl”指明本操作目标为访问控制列表 。

　　6.2.5.2 请求消息头

　　GET/ContainerName? aclHTTP/1.1

　　6.2.5.3 请求参数

　　无 。

　　6.2.5.4 消息头附加域

　　无 。

　　6.2.5.5 请求体参数

　　无 。

　　6.2.5.6 响应消息代码

　　状态码根据定义返回 ,成功为 200;如果失败 ,根据原因设置状态码和补充出错信息 。

　　6.2.5.7 响应参数

　　无 。

　　6.2.5. 8 响应消息体参数

　　响应消息体参数应包含信息见表 8。

　　表 8 响应消息体参数信息

　　6.2.5.9 消息示例

　　请求消息见示例 1。

　　示例 1:

　　GET/MyPictureContainer? aclHTTP/1.1

　　Host: obs. china. com

　　Date: Sun, 6 Feb 2011 18:10:00 GMT

　　Authorization: OBSKHGF568HJG254LUTRE65:kljgogbas+ = ao9872bgvsfoijGHT消息响应见示例 2。

　　示例 2:

　　HTTP/1.1200OK

　　Date: Sun, 6 Feb 2011 18:10:00 GMT

　　Content-Length: 236

　　Server: ObsServer

　　John

　　Frank

　　FULL_CONTROL

　　Michael

　　FULL_CONTROL

　　6.2.6 设置容器权限

　　6.2.6. 1 功能描述

　　当采用 ACL方式(见附录 A)进行访问控制时 ,用户利用本接口设置容器的 ACL。 用户应对容器有 WRITE_ACP访 问 权 限 , 否 则 不 能 进 行 该 操 作 。 操 作 目 标 资 源 由 “/ContainerName? acl”组 成 的URI表示 ,其中 ,“ContainerName”为容器名称 ,“acl”指明本操作目标为访问控制列表 。

　　6.2.6.2 请求消息头

　　PUT/ContainerName? aclHTTP/1.1

　　6.2.6.3 请求参数

　　无 。

　　6.2.6.4 消息头附加域

　　无 。

　　6.2.6.5 请求体参数

　　请求体参数应包含信息见表 9。

　　表 9 请求体参数信息

　　6.2.6.6 响应消息代码

　　状态码根据定义返回 ,成功为 200;如果失败 ,根据原因设置状态码和补充出错信息 。

　　6.2.6.7 响应参数

　　无 。

　　6.2.6. 8 响应消息体参数

　　无 。

　　6.2.6.9 消息示例

　　请求消息见示例 1。

　　示例 1:

　　PUT/MyPictureContainer? aclHTTP/1.1

　　Host: obs. china. com

　　Content-Length: 124

　　Date: Wed, 25 Nov2009 12:00:00 GMT

　　Authorization: OBSUTR4D3461F17762420D5:MbLRepdf3YB+0diMbLReMPLE= B+F

　　John

　　Frank

　　FULL_CONTROL

　　Michael

　　FULL_CONTROL

　　消息响应见示例 2。

　　示例 2:

　　HTTP/1.1200OK

　　Date: Wed, 01 Mar2009 12:00:00 GMT

　　Server: ObsServer

　　6.3 对象相关功能

　　6.3. 1 创建对象

　　6.3. 1. 1 功能描述

　　用户根据指定的对 象 标 识 创 建 一 个 对 象 。 对 象 标 识 宜 采 用 URI方 式 , 也 可 采 用 GB/T 26231— 2010规定的 OID方式 。对象存储系统中的对象应属于一个特定的容器 , 用户创建对象前应注册并通过合法的身份鉴别 ,并对对象所属的容器具有写权限 。

　　对同样的对象标识再次进行创建时 ,则新创建的对象将覆盖原对象 。

　　6.3. 1.2 请求消息头

　　PUT objectURIHTTP/1.1

　　6.3. 1.3 请求参数

　　无 。

　　6.3. 1.4 消息头附加域

　　消息头附加域应包含信息见表 10。

　　表 10 消息头附加域信息

　　表 10 (续)

　　6.3. 1.5 请求体参数

　　无 。

　　6.3. 1.6 响应消息代码

　　状态码根据定义返回 ,成功为 201;如果失败 ,根据原因设置状态码和补充出错信息 。

　　6.3. 1.7 响应参数

　　无 。

　　6.3. 1. 8 响应消息体参数

　　无 。

　　6.3. 1.9 消息示例

　　请求消息见示例 1。

　　示例 1:

　　PUT/myContainer/myImage.jpg HTTP/1.1

　　Host: obs. china. com

　　Date: Wed, 12 Oct2009 17:50:00 GMT

　　Authorization: OBS15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE=

　　Content-Type: text/plain

　　Content-Length: 11434

　　[11434bytes ofobjectdata]

　　响应消息见示例 2。

　　示例 2:

　　HTTP/1.1201Created

　　Date: Wed, 12 Oct2009 17:50:00 GMT

　　Content-Type: text/plain

　　Content-Length: 0

　　Server: ObsServer

　　6.3.2 删除对象

　　6.3.2. 1 功能描述

　　用户删除指定的 URI的对象 ,用户删除对象前应注册并通过合法的身份鉴别 ,并对该对象所在的容器具有写权限 。

　　6.3.2.2 请求消息头

　　DELETE objectURIHTTP/1.1

　　6.3.2.3 请求参数

　　无 。

　　6.3.2.4 消息头附加域

　　无 。

　　6.3.2.5 请求体参数

　　无 。

　　6.3.2.6 响应消息代码

　　状态码根据定义返回 ,成功为 204;如果失败 ,根据原因设置状态码和补充出错信息 。

　　6.3.2.7 响应参数

　　无 。

　　6.3.2. 8 响应消息体参数

　　无 。

　　6.3.2.9 消息示例

　　请求消息见示例 1。

　　示例 1:

　　DELETE/myContainer/myImage.jpg HTTP/1.1

　　Host: obs. china. com

　　Date: Wed, 12 Oct2009 17:50:00 GMT

　　Authorization: OBS15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE=

　　Content-Type: text/plain

　　Content-Length: 0

　　响应消息见示例 2。

　　示例 2:

　　HTTP/1.1204No Content

　　Date: Wed, 12 Oct2009 17:50:00 GMT

　　Content-Type: text/plain

　　Content-Length: 0

　　Server: ObsServer

　　6.3.3 获取对象

　　6.3.3. 1 功能描述

　　根据指定的 URI读取一个对象的数据 ,用户创建对象前应注册并通过合法的身份鉴别 ,并对该对象具有读权限 。

　　6.3.3.2 请求消息头

　　GET objectURIHTTP/1.1

　　6.3.3.3 请求参数

　　无 。

　　6.3.3.4 消息头附加域

　　消息头附加域应包含信息见表 11。

　　表 11 消息头附加域信息

　　6.3.3.5 请求体参数

　　无 。

　　6.3.3.6 响应消息代码

　　状态码根据定义返回 ,成功为 200;如果失败 ,根据原因设置状态码和补充出错信息 。

　　6.3.3.7 响应参数

　　无 。

　　6.3.3. 8 响应消息体参数

　　无 。

　　6.3.3.9 消息示例

　　请求消息见示例 1。

　　示例 1:

　　GET/myContainer/myImage.jpg HTTP/1.1

　　Host: obs. china. com

　　Date: Wed, 12 Oct2009 17:50:00 GMT

　　Authorization: OBS15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE=

　　Content-Type: text/plain

　　响应消息见示例 2。

　　示例 2:

　　HTTP/1.1200OK

　　Date: Wed, 12 Oct2009 17:50:00 GMT

　　Content-Type: text/plain

　　Content-Length: 1024

　　Server: ObsServer

　　[1024bytes ofobjectdata]

　　6.3.4 获取对象属性

　　6.3.4. 1 功能描述

　　根据指定的 URI读取某个对象的属性值 。用户应通过合法的身份鉴别 ,并对该对象具有读权限 。

　　6.3.4.2 请求消息头

　　方法一 :使用 GET方法 , 响应消息通过消息体返回结果 。

　　GET objectURI? meta HTTP/1.1

　　方法二 :使用 HEAD方法 , 响应消息通过消息头返回结果 。

　　HEAD objectURIHTTP/1.1

　　6.3.4.3 请求参数

　　无 。

　　6.3.4.4 消息头附加域

　　无 。

　　6.3.4.5 请求体参数

　　无 。

　　6.3.4.6 响应消息代码

　　状态码根据定义返回 ,成功为 200;如果失败 ,根据原因设置状态码和补充出错信息 。

　　6.3.4.7 响应头参数

　　响应头参数应包含信息见表 12。

　　表 12 响应头参数信息

　　6.3.4. 8 响应消息体参数

　　无 。

　　6.3.4.9 消息示例

　　6.3.4.9. 1 方法一

　　请求消息见示例 1。

　　示例 1:

　　GET/myContainer/myObject? meta HTTP/1.1

　　Host: obs. china. com

　　Date: Wed, 12 Oct2009 17:50:00 GMT

　　Authorization: OBS15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE=响应消息见示例 2。

　　示例 2:

　　HTTP/1.1200OK

　　Date: Wed, 12 Oct2009 17:50:00 GMT

　　Content-Length: 291

　　owner: china

　　ctime: Sun,18Nov200606:12:00 GMT

　　x-obs-usermeta-metakey1: metavalue1

　　x-obs-usermeta-metakey2: metavalue2

　　Server: ObsServer

　　6.3.4.9.2 方法二

　　请求消息见示例 1。

　　示例 1:

　　HEAD/myContainer/myObjectHTTP/1.1

　　Host: obs. china. com

　　Date: Wed, 12 Oct2009 17:50:00 GMT

　　Authorization: OBS15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE=响应消息见示例 2。

　　示例 2:

　　HTTP/1.1200OK

　　Date: Wed, 12 Oct2009 17:50:00 GMT

　　Content-Length: 291

　　Server: ObsServer

　　owner: china

　　ctime: Sun,18Nov200606:12:00 GMT

　　x-obs-usermeta-metakey1: metavalue1

　　x-obs-usermeta-metakey2: metavalue2

　　6.3.5 设置对象属性

　　6.3.5. 1 功能描述

　　根据指定的 URI设置该对象的用户 自定义属性值 , 用户创建对象前应注册并 通 过 合 法 的 身 份 鉴别 ,并对该对象的容器具有写权限 。

　　6.3.5.2 请求消息头

　　PUT objectURI? meta HTTP/1.1

　　6.3.5.3 请求参数

　　无 。

　　6.3.5.4 消息头附加域

　　消息头附加域应包含信息见表 13。

　　表 13 消息头附加域信息

　　6.3.5.5 请求体参数

　　无 。

　　6.3.5.6 响应消息代码

　　状态码根据定义返回 ,成功为 200;如果失败 ,根据原因设置状态码和补充出错信息 。

　　6.3.5.7 响应参数

　　无 。

　　6.3.5. 8 响应消息体参数

　　无 。

　　6.3.5.9 消息示例

　　请求消息见示例 1。

　　示例 1:

　　PUT/myBucket/myImage.jpg? meta HTTP/1.1

　　Host: obs. china. com

　　Date: Wed, 12 Oct2009 17:50:00 GMT

　　Authorization: OBS15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE=

　　x-obs-usermeta-metakey1: metavalue1

　　x-obs-usermeta-metakey2: metavalue2

　　Content-Length: 0

　　响应消息见示例 2。

　　示例 2:

　　HTTP/1.1200OK

　　Date: Wed, 12 Oct2009 17:50:00 GMT

　　Content-Length: 0

　　Server: ObsServer

　　6.3.6 获取对象权限

　　6.3.6. 1 功能描述

　　当采用 ACL方式(见附录 A)进行访问控制时 ,用户利用本接口获取对象 ACL 的操作 ,返回信息应包含指定对象的权限控制列表信息 。用户应拥有对指定对象 READ_ACP 的权限 。

　　6.3.6.2 请求消息头

　　GET/ContainertName/ObjectName? aclHTTP/1.1

　　6.3.6.3 请求参数

　　无 。

　　6.3.6.4 消息头附加域

　　无 。

　　6.3.6.5 请求体参数

　　无 。

　　6.3.6.6 响应消息代码

　　状态码根据定义返回 ,成功为 200;如果失败 ,根据原因设置状态码和补充出错信息 。

　　6.3.6.7 响应参数

　　无 。

　　6.3.6. 8 响应消息体参数

　　响应消息体参数包含信息见表 14。

　　表 14 响应消息体参数信息

　　6.3.6.9 消息示例

　　请求消息见示例 1。

　　示例 1:

　　GET/MyContainer/MyPicture? aclHTTP/1.1

　　Host: obs. china. com

　　Date: Sun, 6 Feb 2011 18:10:00 GMT

　　Authorization: OBSTIKVJ979BgZHT9826KJP:lkgsdrili87vkjn9o8dvL9SsO6Ak响应消息见示例 2。

　　示例 2:

　　HTTP/1.1200OK

　　Date: Wed, 28 Oct2009 22:32:00 GMT

　　Content-Length: 124

　　Content-Type: application/xml

　　Server: ObsServer

　　John

　　Frank

　　FULL_CONTROL

　　6.3.7 设置对象权限

　　6.3.7. 1 功能描述

　　当采用 ACL方式(见附录 A)进行访问控制时 ,用户利用本接口设置对象 ACL 的操作 。用户应拥有指定对象 WRITE_ACP 的权限 。

　　6.3.7.2 请求消息头

　　PUT/Container/ObjectName? aclHTTP/1.1

　　6.3.7.3 请求参数

　　无 。

　　6.3.7.4 消息头附加域

　　无 。

　　6.3.7.5 请求体参数

　　请求体参数应包含信息见表 15。

　　表 15 请求体参数信息

　　表 15 (续)

　　6.3.7.6 响应消息代码

　　状态码根据定义返回 ,成功为 200;如果失败 ,根据原因设置状态码和补充出错信息 。

　　6.3.7.7 响应参数

　　无 。

　　6.3.7. 8 响应消息体参数

　　无 。

　　6.3.7.9 消息示例

　　请求消息见示例 1。

　　示例 1:

　　PUT/MyContainer/MyPicture? aclHTTP/1.1

　　Host: obs. china. com

　　Date: Sun, 6 Feb 2011 18:10:00 GMT

　　Authorization: OBSTIKVJ979BgZHT9826KJP:lkgsdrili87vkjn9o8dvL9SsO6Ak

　　Content-Type: application/xml

　　John

　　Frank

　　FULL_CONTROL

　　消息响应见示例 2。

　　示例 2:

　　HTTP/1.1200OK

　　Date: Wed, 28 Oct2009 22:32:00 GMT

　　Content-Length: 0

　　Server: ObsServer

　　附 录 A

　　(规范性附录)

　　基于 ACL 的访问控制

　　基于对象的云存储可通过 ACL进行访问控制 。其中 ,ACL 的定义见表 A. 1。

　　表 A. 1 ACL定义

　　系统在执行对象或容器的 PUT操作时 ,可通过使用扩展头“x-OBS-acl”的方式 , 同步设置对象或容器的访问控制列表 。 常见 ACL宏定义见表 A. 2。

　　表 A.2 常见 ACL宏定义

　　系统包含以下两类特殊用户标识 ,普通用户不能使用 :

　　a) OBS-OBS-ALL-REGISTED-USERS:所有已注册的 OBS对象存储业务用户 。

　　b) OBS-OBS-ANONYMOUS-USERS: 匿名用户 。

　　附 录 B (规范性附录)补充出错信息

　　基于对象的 云 存 储 对 HTTP 状 态 码 的 补 充 出 错 信 息 描 述 见 表 B.1。其 中 “出 错 名 称”对 应 于GB/T 31916. 1—2015 中 5. 4 中 的 Name字 段 , “出 错 信 息 ”对 应 于 GB/T 31916. 1—2015 中 5. 4 中 的Message字段 。

　　表 B. 1 补充出错信息描述

　　表 B. 1 (续)