Search File¶
搜索文件所在目录。
请求格式¶
GET http://{apigw-address}/dfs-api/v1.0/search/searchFileByPage
请求参数(URI)¶
名称 |
位置 (Path/Query) |
是否必须 |
数据类型 |
描述 |
---|---|---|---|---|
tenant |
Query |
True |
String |
租户名称 |
loginTenant |
Query |
True |
String |
当前登录租户 |
fileName |
Query |
True |
String |
文件名 |
pages |
Query |
False |
Int |
页号,默认值1表示第1页;如不在Query中声明该参数,则使用其默认值 |
pageSize |
Query |
False |
Int |
每页大小,默认值10表示每页包含10条记录;如不在Query中声明该参数,则使用其默认值 |
备注
使用 pages
和 pageSize
来约束返回结果的显示。例如,要显示第201-第300条记录,则应设置 pageSize=100
pages=3
。 pageSize=100
会将记录按照每100条记录为一页划分好, pageToken=3
表示想要查询第3页,即第201至第300条记录。
响应参数¶
名称 |
数据类型 |
描述 |
---|---|---|
status |
Int |
响应状态码 |
msg |
String |
返回消息,用于描述响应结果 |
submsg |
String |
返回子消息,用于描述响应结果 |
data |
Object |
响应数据结构体,结构见下表 |
名称 |
数据类型 |
描述 |
---|---|---|
pages |
Int |
页号 |
pageSize |
Int |
每页大小 |
totalSize |
Int |
实际查询到的记录总条数 |
data |
Object |
文件详情结构体构成的列表。其结构见下表 |
名称 |
数据类型 |
描述 |
---|---|---|
fileName |
String |
文件名 |
filePath |
String |
文件所在路径 |
fileSize |
String |
文件大小 |
示例¶
请求示例¶
GET http://{apigw-address}/dfs-api/v1.0/download?tenant=EDGE&fileName=sample.txt&pages=3&pageSize=3&loginTenant=EDGE
返回示例¶
{
"status":0,
"msg":"success",
"submsg":"",
"data":{
"pages":1,
"pageSize":3,
"totalSize":3,
"data":[
{
"fileName":"test.txt",
"filePath":"/2019092011/",
"fileSize":"1.2 KB"
},
{
"fileName":"test.txt",
"filePath":"/2019092012/",
"fileSize":"23 B"
},
{
"fileName":"test.txt",
"filePath":"/2019092013/",
"fileSize":"2 B"
}
]
}
}