书 书 书犐犆犛 ３５ ． １００ ． ０５ 犔 ７９ 中华人民共和国国家标准 犌犅 ／ 犜 ３６６２３ — ２０１８ 信息技术 　 云计算 　 文件服务应用接口 犐狀犳狅狉犿犪狋犻狅狀狋犲犮犺狀狅犾狅犵狔 — 犆犾狅狌犱犮狅犿狆狌狋犻狀犵 — 犉犻犾犲狊犲狉狏犻犮犲犪狆狆犾犻犮犪狋犻狅狀犻狀狋犲狉犳犪犮犲 ２０１８  ０９  １７ 发布 ２０１９  ０４  ０１ 实施 国家市场监督管理总局 中国国家标准化管理委员会 发布书 书 书目 　　 次 前言 Ⅲ ………………………………………………………………………………………………………… １ 　 范围 １ ……………………………………………………………………………………………………… ２ 　 规范性引用文件 １ ………………………………………………………………………………………… ３ 　 术语和定义 １ ……………………………………………………………………………………………… ４ 　 概述 １ ……………………………………………………………………………………………………… ５ 　 基本要求 ２ ………………………………………………………………………………………………… 　 ５．１ 　 创建文件夹 ２ ………………………………………………………………………………………… 　 ５．２ 　 获取文件列表 ２ ……………………………………………………………………………………… 　 ５．３ 　 上传文件 ２ …………………………………………………………………………………………… 　 ５．４ 　 下载文件 （ 夹 ） ２ ……………………………………………………………………………………… 　 ５．５ 　 复制文件 （ 夹 ） ２ ……………………………………………………………………………………… 　 ５．６ 　 移动文件 （ 夹 ） ２ ……………………………………………………………………………………… 　 ５．７ 　 删除文件 （ 夹 ） ２ ……………………………………………………………………………………… ６ 　 扩展要求 ３ ………………………………………………………………………………………………… 　 ６．１ 　 获取回收站列表 ３ …………………………………………………………………………………… 　 ６．２ 　 还原文件 （ 夹 ） ３ ……………………………………………………………………………………… 　 ６．３ 　 彻底删除文件 （ 夹 ） ３ ………………………………………………………………………………… 　 ６．４ 　 批量复制文件 （ 夹 ） ３ ………………………………………………………………………………… 　 ６．５ 　 批量移动文件 （ 夹 ） ３ ………………………………………………………………………………… 　 ６．６ 　 批量删除文件 （ 夹 ） ３ ………………………………………………………………………………… 　 ６．７ 　 批量下载文件 （ 夹 ） ３ ………………………………………………………………………………… 　 ６．８ 　 搜索 ４ ………………………………………………………………………………………………… 　 ６．９ 　 创建分享 ４ …………………………………………………………………………………………… 　 ６．１０ 　 获取分享列表 ４ ……………………………………………………………………………………… 　 ６．１１ 　 获取分享文件 ４ ……………………………………………………………………………………… 　 ６．１２ 　 取消分享 ４ …………………………………………………………………………………………… 　 ６．１３ 　 获取图片文件缩略图 ４ ……………………………………………………………………………… 　 ６．１４ 　 查看历史版本 ４ ……………………………………………………………………………………… 　 ６．１５ 　 恢复文件 ５ …………………………………………………………………………………………… 附录 Ａ （ 规范性附录 ） 　 文件服务应用接口定义 ６ ………………………………………………………… 附录 Ｂ （ 资料性附录 ） 　 文件服务应用接口示例 ３５ ………………………………………………………… Ⅰ 犌犅 ／ 犜 ３６６２３ — ２０１８ 前 　　 言 　　 本标准按照 ＧＢ ／ Ｔ１．１ — ２００９ 给出的规则起草 。 本标准由全国信息技术标准化技术委员会 （ ＳＡＣ ／ ＴＣ２８ ） 归口 。 请注意本文件的某些内容可能涉及专利 。 本文件的发布机构不承担识别这些专利的责任 。 本标准起草单位 ： 华中科技大学 、 中国电子技术标准化研究院 、 深圳市迅雷网络技术有限公司 、 深圳市腾讯计算机系统有限公司 、 浪潮 （ 北京 ） 电子信息产业有限公司 、 中国电子科技集团公司第二十八研究所 ， 华为技术有限公司 、 中兴通讯股份有限公司 、 上海计算机软件技术开发中心 、 深圳市金蝶天燕中间件股份有限公司 、 中国科学院深圳先进技术研究院 、 深圳赛西信息技术有限公司 、 东莞市中电云华信息技术有限公司 、 阿里云计算有限公司 。 本标准主要起草人 ： 周可 、 陈志峰 、 王桦 、 刘汉洲 、 肖志立 、 赵江 、 严红 、 周景才 、 胡捷 、 蔡立志 、 林琳 、 吴涛 、 王志鹏 、 杨丽蕴 、 王典威 、 李振岭 、 刘海军 、 王兆春 、 孙思 、 陈伟 、 冯超 、 黄永峰 、 喻之斌 、 刘琪骁 、 易晶晶 、 王学英 、 谢天杰 、 苏志远 。 Ⅲ 犌犅 ／ 犜 ３６６２３ — ２０１８ 信息技术 　 云计算 　 文件服务应用接口 １ 　 范围 本标准规定了文件服务应用接口的基本要求和扩展要求 。 本标准适用于基于文件的云服务应用的开发 、 测试和使用 。 ２ 　 规范性引用文件 下列文件对于本文件的应用是必不可少的 。 凡是注日期的引用文件 ， 仅注日期的版本适用于本文 件 。 凡是不注日期的引用文件 ， 其最新版本 （ 包括所有的修改单 ） 适用于本文件 。 ＧＢ ／ Ｔ３２４００ — ２０１５ 　 信息技术 　 云计算 　 概述和词汇 ＲＦＣ８２２ 　 电子邮件的标准格式 （ ＳｔａｎｄａｒｄＦｏｒＴｈｅＦｏｒｍａｔＯｆＡＲＰＡＩＮＴＥＲＮＥＴＴｅｘｔＭｅｓｓａ ｇｅｓ ） ＲＦＣ２６１６ 　 超文本传输协议 １．１ （ ＨｙｐｅｒｔｅｘｔＴｒａｎｓｆｅｒＰｒｏｔｏｃｏ１１．１ ） ＲＦＣ４６７２ 　 远程用户拨号认证动态认证客户端管理信息基础 （ ＲｅｍｏｔｅＡｕｔｈｅｎｔｉｃａｔｉｏｎＤｉａｌＩｎＵｓｅｒＳｅｒｖｉｃｅＤｙｎａｍｉｃＡｕｔｈｏｒｉｚａｔｉｏｎＣｌｉｅｎｔＭａｎａｇｅｍｅｎｔＩｎｆｏｒｍａｔｉｏｎＢａｓｅ ） ３ 　 术语和定义 ＧＢ ／ Ｔ３２４００ — ２０１５ 界定的以及下列术语和定义适用于本文件 。 ３ ． １ 　 文件 　 犳犻犾犲 存放在计算机存储介质中 ， 具有符号名 ， 且在逻辑上具有完整意义的数据集合 。 ３ ． ２ 　 文件夹 　 犳狅犾犱犲狉 存储系统中存储文件的逻辑空间 。 ３ ． ３ 　 文件服务 　 犳犻犾犲狊犲狉狏犻犮犲 一种以文件为单位的数据服务形式 。 ３ ． ４ 　 文件服务应用接口 　 犳犻犾犲狊犲狉狏犻犮犲犪狆狆犾犻犮犪狋犻狅狀犻狀狋犲狉犳犪犮犲 文件服务为应用提供的接口 。 ４ 　 概述 文件服务应用接口由基本接口和扩展接口组成 ， 其中基本接口是每个文件服务都应该具备的接口 ， 扩展接口是文件服务宜具备的接口 。 文件服务应用接口定义见附录 Ａ ， 文件服务应用接口示例参见附录 Ｂ 。 １ 犌犅 ／ 犜 ３６６２３ — ２０１８ ５ 　 基本要求 ５ ． １ 　 创建文件夹 创建文件夹时提供以下功能 ： ａ ） 　 应能够选择文件夹地址 ； ｂ ） 　 应能够设置文件夹名字 ； ｃ ） 　 创建文件夹后应能够查看创建时间和最后修改时间 ； ｄ ） 　 宜支持同时创建多个文件夹功能 。 ５ ． ２ 　 获取文件列表 获取文件列表时提供以下功能 ： ａ ） 　 应能够选择获取文件夹的地址 ； ｂ ） 　 应能够选择每页显示文件 （ 夹 ） 数量 ； ｃ ） 　 应能够选择显示的页数 ； ｄ ） 　 应能够查看文件 （ 夹 ） 大小 ， 创建时间和最后修改时间 ； ｅ ） 　 宜支持分页时根据修改时间 、 文件大小和文件名字进行排序功能 ； ｆ ） 　 宜支持按文件 （ 夹 ） 类型查询 。 ５ ． ３ 　 上传文件 上传文件时提供以下功能 ： ａ ） 　 应能够选择上传文件地址 ； ｂ ） 　 应能够支持覆盖 、 不准许覆盖和自动覆盖等模式 ； ｃ ） 　 宜支持文件校验功能 。 ５ ． ４ 　 下载文件 （ 夹 ） 下载文件 （ 夹 ） 时提供以下功能 ： ａ ） 　 应能够选择下载文件 （ 夹 ） 的地址 ； ｂ ） 　 宜支持选择下载文件的版本 ； ｃ ） 　 宜支持文件校验功能 。 ５ ． ５ 　 复制文件 （ 夹 ） 复制文件 （ 夹 ） 时提供以下功能 ： ａ ） 　 应能够选择源文件 （ 夹 ） 和目标文件 （ 夹 ） 地址 ； ｂ ） 　 应能够支持覆盖 、 不准许覆盖和自动覆盖等模式 。 ５ ． ６ 　 移动文件 （ 夹 ） 移动文件 （ 夹 ） 时提供以下功能 ： ａ ） 　 应能够选择文件 （ 夹 ） 源地址和目标