1、ICS 35.100.05 L79中 华 人 民 共 和 国 国 家 标 准 GB/T 31916.3XXXX信息技术 云 数 据 存 储 和 管 理第 3 部 分 ： 分 布 式 文 件 存 储 系 统 应 用 接 口Information technologyCloud data storage and management Part 3: distribution file system application interface 点 击 此 处 添 加 与 国 际 标 准 一 致 性 程 度 的 标 识 （征求意见稿） 在 提 交 反 馈 意 见 时 ， 请 将 您 知 道 的 相 关
2、 专 利 连 同 支 持 性 文 件 一 并 附 上 - XX - XX 发布 XXXX - XX - XX 实施GB/T 31916.3XXXX目 次前 言 . III1 范 围 12 规 范 性 引 用 文 件 13 术 语 、 定 义 和 缩 略 语 13.1 术 语 和 定 义 13.2 缩 略 语 14 标 准 符 合 性 要 求 25 分 布 式 文 件 存 储 系 统 体 系 结 构 25.1 体 系 结 构 概 述 25.2 容 错 要 求 36 分 布 式 文 件 存 储 系 统 应 用 接 口 通 用 要 求 36.1 概 述 36.2 命 名 规 则 36.3 补 充 出
3、 错 信 息 46.4 公 共 请 求 头 46.5 公 共 响 应 头 47 文 件 接 口 要 求 47.1 概 述 47.2 创 建 文 件 47.3 删 除 文 件 77.4 上 传 文 件 87.5 下 载 文 件 . 117.6 追 加 写 文 件 . 137.7 复 制 文 件 . 157.8 重 命 名 文 件 . 177.9 查 看 文 件 状 态 . 197.10 修 改 文 件 属 性 217.11 文 件 搜 索 247.12 读 文 件 267.13 写 文 件 288 文 件 夹 接 口 要 求 . 308.1 概 述 . 308.2 创 建 文 件 夹 . 308
4、.3 删 除 文 件 夹 . 32I GB/T 31916.3XXXXII 8.4 上 传 文 件 夹 . 338.5 下 载 文 件 夹 . 368.6 复 制 文 件 夹 . 388.7 重 命 名 文 件 夹 . 408.8 查 看 文 件 夹 状 态 . 428.9 修 改 文 件 夹 属 性 . 448.10 文 件 夹 搜 索 468.11 列 出 文 件 夹 内 容 489 回 收 站 接 口 要 求 . 509.1 概 述 . 509.2 还 原 回 收 站 文 件 . 509.3 查 询 回 收 站 文 件 . 529.4 彻 底 删 除 回 收 站 文 件 . 549.5
5、清 空 回 收 站 . 569.6 全 部 还 原 . 5710 扩 展 属 性 接 口 要 求 5910.1 概 述 5910.2 设 置 扩 展 属 性 5910.3 删 除 扩 展 属 性 6110.4 读 取 扩 展 属 性 6210.5 列 出 扩 展 属 性 6511 快 照 接 口 要 求 6711.1 概 述 6711.2 创 建 快 照 6711.3 删 除 快 照 6911.4 列 出 快 照 7111.5 重 命 名 快 照 7312 访 问 控 制 列 表 接 口 要 求 7512.1 概 述 7512.2 添 加 ACL 规 则 7512.3 读 取 ACL . 77
6、12.4 修 改 ACL 规 则 8012.5 删 除 ACL . 8212.6 删 除 ACL 规 则 8312.7 删 除 默 认 ACL 规 则 85附录 A（ 资 料 性 附 录 ） 分 布 式 文 件 存 储 系 统 管 理 接 口 . 87附录 B（ 规 范 性 附 录 ） 补 充 出 错 信 息 102GB/T 31916.3XXXXIII 前 言GB/T 31916 信 息 技 术 云 数 据 存 储 和 管 理 分 为 六 部 分 ： 第 1部 分 ： 总 则 ； 第 2部 分 ： 基 于 对 象 的 云 存 储 应 用 接 口 ； 第 3部 分 ： 分 布 式 文 件 存
7、储 应 用 接 口 ； 第 4部 分 ： 基 于 块 的 云 存 储 应 用 接 口 ； 第 5部 分 ： 基 于 键 值 (Key-Value)的 云 数 据 管 理 应 用 接 口 ； 第 6部 分 ： 分 布 式 关 系 数 据 库 应 用 接 口 。 本 部 分 为 GB/T 31916的 第 3部 分 。 本 部 分 按 照 GB/T1.12009给 出 的 规 则 起 草 。 本 部 分 由 全 国 信 息 技 术 标 准 化 技 术 委 员 会 （ SAC/TC28） 提 出 并 归 口 。 本部分 起草 单位 : 上 海计 算机软 件技 术开 发中 心、 中国电 子技 术标 准
8、化 研究 院、 浪 潮 （ 北京 ） 电 子 信息产 业 有 限公 司、 万国 数据服 务有 限公 司、 华为 技术有 限公 司、 青云 聚通 （ 北京） 科技 发展 有限 公司 、 中 金 数 据 系 统 有 限 公 司 、 中 兴 通 讯 股 份 有 限 公 司 、 阿 里 云 计 算 有 限 公 司 、 天 地 伟 业 数 码 科 技 有 限 公 司 、 腾 讯 计 算 机 系 统 有 限 公 司 。 本 部 分 主 要 起 草 人 : GB/T 31916.3XXXX1 信息技术 云数据存储和管理第 3 部分：分布式文件存储系统应用接口1 范围GB/T 31916的本 部分 给出 了分
9、布 式文 件存 储系 统 的 体系结 构 ， 规 定了 分布 式 文件存 储系 统的 应用 接 口 通 用 要 求 和 应 用 接 口 定 义 。 GB/T 31916的 本 部 分 适 用 于 分 布 式 文 件 存 储 系 统 的 设 计 、 开 发 和 使 用 。 2 规 范 性 引 用 文 件下 列 文 件 对 于 本 文 件 的 应 用 是 必 不 可 少 的 。 凡 是 注 日 期 的 引 用 文 件 ， 仅 注 日 期 的 版 本 适 用 于 本 文 件 。 凡 是 不 注 日 期 的 引 用 文 件 ， 其 最 新 版 本 （ 包 括 所 有 的 修 改 单 ） 适 用 于 本
10、 文 件 。 GB/T 74082005 数 据 元 和 交 换 格 式 信 息 交 换 日 期 和 时 间 表 示 法 GB/T 31916.12015 信 息 技 术 云 数 据 存 储 和 管 理 第 1部 分 总 则 RFC 822 ARPA 互 联 网 文 本 消 息 格 式 标 准 （ Standard for the Format of ARPA Internet Text Messages） RFC 2616 超 文 本 传 输 协 议 （ HTTP） 1.1（ Hypertext Transfer Protocol HTTP/1.1） RFC 7159 The JavaScr
11、ipt Object Notation (JSON) Data Interchange Format 3 术 语 、 定 义 和 缩 略 语3.1 术 语 和 定 义GB/T 31916.12015界 定 的 以 及 下 列 术 语 和 定 义 适 用 于 本 文 件 。 3.1.1 基 于 应 用 层 的 分 布 式 文 件 存 储 系 统 Distributed File System Based on Application Layer一种作 为应 用安 装在 操作 系统之 上的 文件 系统 ， 其 存储资 源 分 布在 不同 的计 算机节 点上 ， 并 通过 计 算 机 网 络 相 连
12、 。 3.2 缩略语下 列 缩 略 语 适 用 于 本 文 件 。 ACL 访 问 控 制 列 表 (Access Control List) API 应 用 程 序 编 程 接 口 (Application Programming Interface) HTTP 超 文 本 传 输 协 议 (Hypertext Transfer Protocol) JSON JavaScript对 象 标 记 法 (JavaScript Object Notation) REST 表 述 性 状 态 转 移 (Representational State Transfer) URI 统 一 资 源 标 识
13、符 (Uniform Resource Identifier) XML 可 扩 展 置 标 语 言 (Extensible Markup Language) GB/T 31916.3XXXX2 4 标 准 符 合 性 要 求本 部 分 所 定 义 的 接 口 分 为 必 选 和 可 选 ， 其 中 文 件 接 口 、 文 件 夹 接 口 和 回 收 站 接 口 为 必 选 接 口 ， 其 他 接 口 为 可 选 接 口 ， 每 一 个 接 口 命 令 的 参 数 可 能 包 含 必 选 参 数 和 可 选 参 数 。 符 合 性 包 含 以 下 几 种 情 况 ： a) 一 个 系 统 实 现
14、 了 所 有 的 接 口 （ 包 含 必 选 接 口 和 可 选 接 口 ） ， 可 声 称 为 完 全 符 合 本 部 分 。 b) 一 个 系 统 实 现 了 所 有 的 必 选 接 口 ， 可 声 称 为 符 合 本 部 分 。 c) 一 个 系 统 没 有 完 全 实 现 所 有 的 必 选 接 口 ， 则 不 符 合 本 部 分 。 5 分 布 式 文 件 存 储 系 统 体 系 结 构5.1 体 系 结 构 概 述应 用 层 的 分 布 式 文 件 存 储 系 统 的 定 位 ， 如 图 1所 示 。 从 操 作 系 统 的 视 角 看 ， 应 用 层 分 布 式 文 件 存 储
15、系统作 为 一 个传 统操 作系 统的应 用 ， 不涉 及操 作系 统内核 相关 的操 作 ， 避免 了分布 式文 件存 储系 统 对 于 操作系 统 的 依赖 和约 束 。 同时 ， 应 用级 分布 式文 件 存储系 统提 供了 各类 接口 ， 为 上层 的各 类应 用系 统 提 供 必 要 的 功 能 支 撑 ， 同 时 还 提 供 管 理 接 口 供 系 统 管 理 员 内 部 使 用 。 应 用 系 统 1 应 用 系 统 2 应 用 系 统 N 系 统 管 理 员HTTP接 口文件接口 文 件 夹 接 口 回收站接口 扩 展 属 性 接 口 快 照 接 口 ACL接 口 管理接 口分
16、布式文件 存 储 系 统 分 布 式 文 件 存 储 系 统元数据 服务器数据存储 服务器数据存储 服务器数据存储 服 务 器数 据 存 储 服 务 器物理层文 件 系 统OS文件系统OS文件系统OS文件系统OS文 件 系 统OS图1 分 布 式 文 件 存 储 系 统 的 定 位分 布 式 文 件 存 储 系 统 的 体 系 结 构 包 括 ： 元 数 据 服 务 器 、 数 据 存 储 服 务 器 、 监 控 服 务 器 和 客 户 端 。 图 2展 示 了 这 种 分 布 式 文 件 存 储 系 统 的 一 般 体 系 结 构 。 GB/T 31916.3XXXX3 元 数 据 访 问客
17、 户 端 元 数 据 服 务 器数据映射数据访问 数据存储 服 务 器 数 据 存 储 服务器 数据存储 服务器监 控 服 务 器图2 分 布 式 文 件 存 储 系 统 的 一 般 体 系 结 构元 数 据 服 务 器 ： 称 为 名 字 服 务 器 。 提 供 整 个 文 件 系 统 的 目 录 信 息 ， 并 且 管 理 各 个 存 储 服 务 器 ， 是 整 个文件 系 统 的核 心 。 元数 据服务 器维 护着 一张 表 ， 其中记 录 了 文件 系统 中所 有的文 件名 与该 文件 存 储 地 址 的 对 应 关 系 。 元 数 据 服 务 器 还 有 管 理 各 个 存 储 服
18、务 器 的 功 能 ， 例 如 控 制 负 载 均 衡 。 元 数 据 服 务 器 可 以 有 一 个 或 多 个 。 数据 存 储服 务器 ： 用 于存 放实际 的文 件数 据 。 所有 的分布 式文 件存 储系 统 都 需要有 至少 一个 存储 服 务 器 。 客 户 端 查 询 到 某 个 文 件 的 实 际 存 放 地 址 后 就 直 接 和 存 储 服 务 器 通 信 以 获 取 文 件 。 监 控 服 务 器 ： 提 供 整 个 分 布 式 文 件 存 储 系 统 的 服 务 监 控 、 日 志 记 录 等 管 理 功 能 ， 可 为 整 个 服 务 运 行 提 供 管 理 支 持
19、 。 在 某 些 分 布 式 文 件 存 储 系 统 中 监 控 服 务 器 的 功 能 整 合 到 了 元 数 据 服 务 器 中 。 客户端 ： 使 用 分 布式 文件 存储系 统来 存储 和访 问的 主机称 为分 布式 文件 存储 系统的 客户 端 ， 成功 连 接 文 件 系 统 以 后 ， 就 可 以 对 文 件 系 统 进 行 操 作 。 除了文 件和 文件 夹的 基本 操作外 ， 分 布式 文件 存储 系 统也提 供一 些管 理功 能的 接口 ， 可参 见 附 录A 。 5.2 容 错 要 求为了使 系统 有较 好的 容错 性 ， 元 数据 服务 器和 存储 服务器 均宜 支持
20、数据 副本 。 所有 数据 的副 本按 一 定 的 策 略 分 散 存 放 在 存 储 服 务 器 上 ， 并 且 副 本 数 量 达 到 预 先 设 置 的 数 值 。 当 某 些 数 据 的 副 本 数 量 降 低 时 ， 系 统 宜 自 动 进 行 副 本 的 重 新 复 制 ， 使 副 本 数 量 达 到 预 设 值 。 元数据 服务 器上 保存 了整 个文件 系统 的名 字空 间 。 为使系 统有 较好 的健 壮性 ， 元数 据服 务器 宜对 元数 据 进 行 定 期 备 份 ， 即 将 整 个 元 数 据 信 息 存 储 在 本 地 磁 盘 上 ， 作 为 一 个 还 原 点 ，
21、一 旦 发 生 错 误 重 启 后 选 取 最 近 的 还 原 点 作 为 元 数 据 。 6 分 布 式 文 件 存 储 系 统 应 用 接 口 通 用 要 求6.1 概述分布式 文件 存储 系统 应用 接口通 用要 求包 括接 口协 议 、 身 份安 全管 理 、 命名 规 则 、 状 态码 信息 描述 、 补 充 出 错 信 息 、 公 共 请 求 头 、 公 共 响 应 头 和 出 错 信 息 描 述 要 求 8项 内 容 。 其 中 ， 接 口 协 议 、 身 份 安 全 管 理 、 状 态 码 信 息 描 述 和 出 错 信 息 描 述 要 求 4项 内 容 见 GB/T 3191
22、6.1中 相 应 部 分 。 6.2 命 名 规 则GB/T 31916.3XXXX4 所 有 文 件 、 文 件 夹 、 路 径 的 命 名 规 则 如 下 ： 名 称 可 用 字 母 、 数 字 、 下 划 线 （ _） 、 短 横 线 （ -） 和 中 文 字 符 。 名 称 应 以 字 母 、 数 字 或 者 中 文 字 符 开 头 。 名 称 最 长 可 允 许 256 个 字 符 。 所 有 响 应 中 需 要 命 名 的 部 分 参 照 RFC 7159。 6.3 补 充 出 错 信 息分布式 文件 存储 系统 发生 的出错 响应 较为 复杂 ， 需 要对HT TP状 态码 补充
23、 出错 信息描 述 。 出错 信息 格 式 符 合 GB/T 31916.12015中 5.4的 要 求 。 补 充 出 错 信 息 描 述 见 附 录 B。 6.4 公 共 请 求 头公 共 请 求 头 应 包 括 信 息 见 表 1。 表1 公 共 请 求 头 信 息名 称 描述 选择状态 Host 主 机 信 息 ， 如 ： 必选 Accept application/json 可选 Content-Type application/json 或 */* 可选 Authorization 用户授权信息 必选 6.5 公 共 响 应 头公 共 响 应 头 应 包 括 信 息 见 表 2。
24、 表2 公 共 响 应 头 信 息名称 描述 选择状态 Content-Length 响应消息内容长度（不含消息头） 取 决 响 应 消 息 内 容 ， 对 于 有 内 容 的 响 应 ， 本参数必选；无内容的响应，可选 Content-Type 表示响应文档属于什么 MIME 类 型 可选 Date 消息响应的时间，时间的描述格式由 rfc822 定 义 ， 如：Sun, 18 Nov 2006 06:12:00 GMT 必选 Server 处理请求的原始服务器的信息 可选 7 文 件 接 口 要 求7.1 概述分布式 文件 存储 系统 的文 件接口 是对 系统 中的 文件 进行操 作的 接
25、口 ， 包括 创 建文件 、 删除 文件 、 上 传 文 件 、 下 载 文 件 、 追 加 写 文 件 、 复 制 文 件 、 重 命 名 文 件 、 查 看 文 件 状 态 、 修 改 文 件 属 性 、 文 件 搜 索 、 读 文 件 和 写 文 件 。 文 件 接 口 是 必 选 接 口 。 7.2 创 建 文 件7.2.1 功 能 描 述GB/T 31916.3XXXX5 创建文 件的 操作 参数 为 ： CreateFile， 用于 在 分 布式 文件存 储系 统中 创建 文件 。 创 建的 文件 名应 在 文 件 夹 中 唯 一 。 7.2.2 请 求 定 义PUT /?op=c
26、reatefile&name=xxx&overwrite=true/false&permission=xxx &replication= &trashtime= HTTP/1.1 Host: HostName Accept: application/json Content-type: application/json Authorization:SignatureValue 7.2.3 请求 URLhttp:/ 其 中 ： 表 示 账 户 ID， 表 示 创 建 文 件 的 位 置 。 7.2.4 请 求 消 息 头按 公 共 请 求 头 定 义 。 7.2.5 请 求 消 息 参 数请 求
27、 消 息 参 数 见 表 3。 表3 请 求 消 息 参 数名 称 类型 描述 选择状态 name string 文件名称（F ileName） ：文件名称应符合 6.2 中所述的文件命 名规则。 必选 overwrite boolean 文 件 重 名 覆 盖 标 记 ： true 表 示 可 覆 盖 ， false 表 示 不 允 许 覆 盖 ， 默 认 值 为 false。 可选 permission string 文件权限： r 表示可读， w 表示 可写， x 表示可执行， 缺省时默认值为 rwx。 可选 replication short 0-512 之 间 的 正 整 数 ， 应
28、 大 于 等 于 系 统 最 低 文 件 副 本 数 ， 默 认 值 为 系 统 最 低文件副本数。 可选 trashtime string 正整数+ 单位， 格式如 12m。 单 位包括秒 （s ） 、 分 （ m） 、 小时 （ h） 、 天 （ D） 、月（M ） 。最大值为 24 个月。默 认值为 1 天。 可选 7.2.6 请 求 消 息 体无 。 7.2.7 响 应 状 态 码响 应 状 态 码 及 其 描 述 见 表 4。 表4 响 应 状 态 码状态码 描述 200 OK， 创 建 成 功 GB/T 31916.3XXXX6 表 4（ 续 ）状态码 描述 400 Invalid
29、FileName， 文 件 名 不 符 合 命 名 规 则 400 InvalidFilePermission， 文 件 权 限 参 数 不 正 确 400 InvalidFileSize， 用 户 请 求 创 建 文 件 大 小 大 于 系 统 设 定 的 最 大 文 件 大 小 值 400 InvalidReplicationNumber， 用 户 请 求 修 改 的 文 件 副 本 数 目 不 是 0-512 之 间 的 正 整 数 或 小 于 系 统 最 低 文 件 副 本数 400 InvalidTrashTime， 文 件 保 存 时 间 不 符 合 格 式 或 超 过 24 个
30、月 401 Unauthorized， 用 户 没 有 传 入 验 证 信 息 或 验 证 信 息 不 正 确 403 Forbidden， 用 户 没 有 创 建 文 件 的 权 限 404 NoSuchFolder， 用 户 请 求 的 文 件 路 径 不 存 在 409 FileAlreadyExists， 用 户 创 建 的 文 件 名 与 已 有 文 件 重 名 ， 并 且 重 名 覆 盖 标 记 为 false 501 Not Implemented， 服 务 器 不 支 持 此 功 能 接 口 7.2.8 响 应 定 义HTTP/1.1 200 OK Date:date Cont
31、ent-type: application/json Content-Length: length Server: server “ctime“:“xxxxxxxx“ 7.2.9 响 应 消 息 头按 公 共 响 应 头 定 义 。7.2.10 响 应 消 息 体响 应 消 息 体 中 各 参 数 描 述 见 表 5。 表5 响 应 消 息 体名称 类型 描述 ctime string 文件的创建时间戳，时间的格式由 GB/T 74082005 定 义 ， 如 ： 2006-11-18T06:12:00 7.2.11 请 求 和 响 应 示 例请 求 消 息 见 示 例 1。 示例1： PUT
32、 /MyAccount/temp?op= createfile &name=temp.txt &overwrite=true&permission=rwx&replication=5&trashtime=12M HTTP/1.1 Host: Accept: application/json Content-GB/T 31916.3XXXX7 type: application/json GB/T 31916.3XXXX8 Authorization:15IUYRRTY876OIU4D 响 应 消 息 见 示 例 2。 示例2： HTTP/1.1 200 OK Date: Sun, 6 Feb
33、 2011 18:10:00 GMT Content-type: application/json Content-Length: length Server: “ctime“:“2006-11-18T06:12:00“ 7.3 删 除 文 件7.3.1 功 能 描 述删 除 文 件 的 操 作 参 数 为 ： DeleteFile， 用 于 删 除 文 件 。 删 除 文 件 时 系 统 应 将 之 放 入 回 收 站 。 7.3.2 请 求 定 义DELETE /?op=deletefile&name=xxx&trashtime= HTTP/1.1 Host: HostName Acce
34、pt: application/json Content-type: application/json Authorization:SignatureValue 7.3.3 请求 URLhttp:/ 其 中 ： 表 示 账 户 ID， 表 示 文 件 的 位 置 。 7.3.4 请 求 消 息 头按 公 共 请 求 头 定 义 。 7.3.5 请 求 消 息 参 数请 求 消 息 参 数 见 表 6。 表6 请 求 消 息 参 数名 称 类型 描述 选择状态 name string 文件名称：文件名称应符合 6.2 中 所 述 的 文 件 命 名 规 则 。 必选 trashtime stri
35、ng 正整数+ 单位，格式如 12m。单 位包括秒（s ） 、分（m ） 、小时（h ） 、天（D ） 、月（M ） 。最大值为 24 个月。默认 值为文件原来的 trashtime。 可选 7.3.6 请 求 消 息 体无 。 GB/T 31916.3XXXX9 7.3.7 响 应 状 态 码响 应 状 态 码 及 其 描 述 见 表 7。 表7 响 应 状 态 码状态码 描述 200 OK， 删 除 成 功 400 InvalidFileName， 用 户 请 求 的 文 件 名 称 或 位 置 不 符 合 命 名 规 则 400 InvalidTrashTime， 文 件 保 存 时 间
36、 不 符 合 格 式 或 超 过 24 个 月 401 Unauthorized， 用 户 没 有 传 入 验 证 信 息 或 验 证 信 息 不 正 确 403 Forbidden， 用 户 没 有 删 除 文 件 的 权 限 404 NoSuchFile， 用 户 请 求 的 文 件 不 存 在 501 Not Implemented， 服 务 器 不 支 持 此 功 能 接 口 7.3.8 响 应 定 义HTTP/1.1 200 OK Date:date Content-type: application/json Server: server 7.3.9 响 应 消 息 头按 公 共
37、响 应 头 定 义 。 7.3.10 响 应 消 息 体无 。 7.3.11 请 求 和 响 应 示 例请 求 消 息 见 示 例 1。 示例1： DELETE /MyAccount/temp?op=deletefile&name=tmp HTTP/1.1 Host: Accept: application/json Content-type: application/json Authorization:15IUYRRTY876OIU4D 响 应 消 息 见 示 例 2。 示例2： HTTP/1.1 200 OK Date: Sun, 6 Feb 2011 18:10:00 GMT Con
38、tent-type: application/json Server: 7.4 上 传 文 件10 GB/T 31916.3XXXX7.4.1 功 能 描 述上 传 文 件 的 操 作 参 数 为 ： UploadFile， 用 于 上 传 本 地 的 文 件 到 分 布 式 文 件 存 储 系 统 。 7.4.2 请 求 定 义PUT /?op=uploadfile&overwrite=0|1|2&permission=xxx &replication= &trashtime= HTTP/1.1 Host: HostName Accept: application/json Content
39、-type: application/json Authorization:SignatureValue “localfilepath“:“xxxxxx“ 7.4.3 请求 URLhttp:/ 其 中 ： 表 示 账 户 ID， 表 示 上 传 到 的 文 件 夹 的 位 置 。 7.4.4 请 求 消 息 头按 公 共 请 求 头 定 义 。7.4.5 请 求 消 息 参 数请 求 消 息 参 数 见 表 8。 表8 请 求 消 息 参 数名 称 类型 描述 选择状态 overwrite int 文件重名覆盖标记，0 表示可覆盖，1 表示不允许覆盖，2 表示自动重命名 为 FileName-
40、1、 FileName-2.以 此 类 推 。 缺 省 时 默 认 值 为 1。 可选 permission string 文件夹权限： r 表示可读， w 表 示可写， x 表示可执行， 缺省时默认值为 rwx。 可选 replication short 0-512 之 间 的 正 整 数 ， 应 大 于 等 于 系 统 最 低 文 件 副 本 数 ， 默 认 值 为 系 统 最 低 文件副本数。 可选 trashtime string 正整数+ 单位， 格式如 12m。 单 位包括秒 （s ） 、 分 （ m） 、 小时（h ） 、 天 （D ） 、月（M ） 。最大值为 6 个月。默 认
41、值为 1 天。 可选 7.4.6 请 求 消 息 体请 求 消 息 体 中 各 参 数 描 述 见 表 9。 表9 请 求 消 息 体名 称 类型 描述 选择状态 localfilepath string 本地文件位置。文件名称应符合 6.2 中 所 述 的 文 件 命 名 规 则 。 必选 7.4.7 响 应 状 态 码11 GB/T 31916.3XXXX响 应 状 态 码 及 其 描 述 见 表 10。 表10 响 应 状 态 码状态码 描述 200 OK， 上 传 成 功 400 InvalidFileName， 文 件 名 称 不 符 合 命 名 规 则 400 InvalidPer
42、mission， 文 件 权 限 参 数 不 正 确 400 InvalidFileSize， 用 户 请 求 上 传 的 文 件 大 于 系 统 设 定 的 最 大 文 件 大 小 值 400 InvalidReplicationNumber， 用 户 请 求 的 文 件 副 本 数 目 不 是 0-512 之 间 的 正 整 数 或 小 于 系 统 最 低 文 件 副 本 数 400 InvalidTrashTime， 文 件 保 存 时 间 不 符 合 格 式 或 超 过 6 个 月 401 Unauthorized， 用 户 没 有 传 入 验 证 信 息 或 验 证 信 息 不 正
43、确 403 Forbidden， 用 户 没 有 在 文 件 夹 中 创 建 文 件 的 权 限 404 NoSuchFolder， 用 户 请 求 的 文 件 路 径 不 存 在 409 FileAlreadyExists， 用 户 请 求 上 传 文 件 名 与 已 有 文 件 夹 重 名 ， 并 且 重 名 覆 盖 标 记 为 1 501 Not Implemented， 服 务 器 不 支 持 此 功 能 接 口 7.4.8 响 应 定 义HTTP/1.1 200 OK Date:date Content-type: application/json Content-Length: l
44、ength Server: server “filepath“:“xxxxxx“, “ctime“:“xxxxxxxxxx“ 7.4.9 响 应 消 息 头按 公 共 响 应 头 定 义 。 7.4.10 响 应 消 息 体响 应 消 息 体 中 各 参 数 描 述 见 表 11。 表11 响 应 消 息 体名 称 类型 描述 选择状态 filepath string 文件上传的位置 必选 ctime string 文 件 的 创 建 时 间 戳 ， 时 间 的 格 式 由 GB/T 7408 2005 定 义 ， 如 ： 2006-11-18T06:12:00。 必选 7.4.11 请 求
45、和 响 应 示 例请 求 消 息 见 示 例 1。 示例1： 12 GB/T 31916.3XXXXPUT /MyAccount/temp?op=uploadfile&overwrite=2&permission=rwx&replication=5&trashtime=12M HTTP/1.1 Host: Accept: application/json Content-type: application/json Authorization:15IUYRRTY876OIU4D “localfile“:“C:myfoldermyfile.txt“ 响 应 消 息 见 示 例 2。 示例2：
46、HTTP/1.1 200 OK Date: Sun, 6 Feb 2011 18:10:00 GMT Content-type: application/json Content-Length: 58 Server: “folderpath“,“/MyAccount/temp/myfolder“, “ctime“:“2006-11-18T06:12:00“ 7.5 下 载 文 件7.5.1 功 能 描 述下 载 文 件 的 操 作 参 数 为 ： DownloadFile， 用 于 将 文 件 从 分 布 式 文 件 存 储 系 统 下 载 到 本 地 。 7.5.2 请 求 定 义GET
47、/?op=downloadfile HTTP/1.1 Host: HostName Accept: application/json Content-type: application/json Authorization:SignatureValue “localpath“:“xxxxxx“, “aliasname“:“xxxxxx“, “start“:0, “end“:128 7.5.3 请求 URLhttp:/ 其 中 ： 表 示 账 户 ID， 表 示 欲 下 载 的 文 件 的 位 置 。 7.5.4 请 求 消 息 头13 GB/T 31916.3XXXX按 公 共 请 求 头 定
48、 义 。7.5.5 请 求 消 息 参 数无 。7.5.6 请 求 消 息 体请 求 消 息 体 中 各 参 数 描 述 见 表 12。 表12 请 求 消 息 体名 称 类型 描述 选择状态 localpath string 文件下载到本地后的位置。其名称应符合 6.2 中 所 述 的 文 件 命 名 规 则 。 必选 aliasname string 下载后文件的另存名，文件名称应符合 6.2 中 所 述 的 文 件 命 名 规 则 。 可选 start int 以正整数表示的传输文件的起始字节，如 start=100 则 从 文 件 的 第 100 个字 节开始传输。默认值：0。 可选 end int 以正整数表示的传输文件的结束字节，如 end=100 则 传 输 到 文 件 的 第 100 个 字节为止。默认值：文件大小。 可选 7.5.7 响 应 状 态 码响 应 状 态 码 及 其 描 述 见 表 13。 表13 响 应 状 态 码状 态 码 描述 200 OK， 下 载 成 功 400 InvalidFileName， 文 件 名 称 不 符 合 命 名 规 则 400 Invali
