请求 POST /v2/file/search
请求参数字段说明: 名称 位置 类型 必选 说明 Authorization header string 是 access_token drive_id body string 是 待搜索的drive ID query body string 是 查询语法字符串,详细说明见下文。最大长度4096 order_by body string 是 搜索结果排序的语法,详细说明见下文。最大长度128 limit body string 否 返回数据最大条数,范围:[0-100],默认:50 marker body string 否 查询起始标识,下发了marker参数则忽略query query规则说明:
支持的数据类型:
a. 基本类型:long、string、bool、double
b. 复合类型:array,date(时间类型,ISO时间: “2019-08-13T06:19:22.870Z”)
基本类型支持的搜索:
a. long: =, <, >, <=, >=
b. string: = (精确搜索), prefix(前缀搜索), match(模糊搜索,只有name字段支持)
c. bool: =
d. double: =, <, >, <=, >=
复合类型支持的搜索:
a. array: in (多条件的=)
b. date: =, <, >, <=, >=
逻辑操作支持:not、and、or
支持括号,优先级为: “括号 > not > and > or”
query举例:
精确查询。
// 查询文件名为 “汇报材料.ppt” 的文件 name = "汇报材料.ppt" 范围查询
查询2019年1月14日前创建的文件 created_at < "2019-01-14T00:00:00" 模糊匹配
// 查询文件名包含 “汇报” 的文件 name match "汇报" 逻辑组合查询
// 查询2019年1月14号创建的文件 created_at > "2019-01-14T00:00:00" and created_at < "2019-01-15T00:00:00" 复杂逻辑查询
// 查询文件size大于1024并且hidden为false并且file_extension不等于“mp4”的文件 size > 1024 and hidden = false and not file_extension = 'mp4' 数组查询
// 查询后缀名为jpg、png或者gif的文件 file_extension in ["jpg", "png", "gif"] 前缀查询
// 查询文件名为“项目1”开头的文件 name prefix "项目1" order_by规则:
ASC代表正序,DESC代表逆序 语法为 字段名 + 空格 + ASC/DESC 如果多个字段排序则需要用逗号隔开 前面的规则优先级高 order_by举例:
单个规则正序
// 按名称正序 name ASC 单个规则逆序
// 按创建时间逆序 created_at DESC 多个排序规则
// 先按创建时间逆序,如果创建时间相同,则按名称正序 created_at DESC, name ASC 支持搜索和排序的字段
字段名 类型 可搜索 可排序 描述 parent_file_id STRING ✔️ — 固定目录搜索,只搜索一级 name STRING ✔️ ✔️ 文件名(模糊分词),可模糊搜索 type STRING ✔️ ✔️ 文件类型file、folder file_extension STRING ✔️ — 文件后缀名 description STRING ✔️ — 描述(single_word分词),可短语匹配 mime_type STRING ✔️ — 文件mimeType搜索 starred BOOL ✔️ — 是否收藏 created_at DATE ✔️ ✔️ 创建时间 updated_at DATE ✔️ ✔️ 修改时间 status STRING ✔️ — 文件状态 trashed BOOL ✔️ — 是否移入回收站 explicitly_trashed BOOL ✔️ — 是否显式移入回收站 hidden BOOL ✔️ — 是否隐藏文件 size LONG ✔️ ✔️ 文件大小 image_time DATE ✔️ ✔️ 照片拍摄时间 label STRING ✔️ — 系统标签名称 category STRING ✔️ — 文件类型,image、video、doc、audio、app、others LONG: 长整型(int64) BOOL: 布尔类型 DATE: 时间类型,用双引号或单引号括起来,与字符串类型一致。格式”2006-01-02T00:00:00”,默认零时区。 STRING: 字符串类型 返回 同 list files 接口返回一样。
https://help.aliyun.com/document_detail/138820.html?spm=a2c4g.11186623.6.591.2d226fbcIIpdDL 文件搜索可以参考这个文档哈
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。