Search File

Search the file directory.

Request Format

GET http://{apigw-address}/dfs-api/v1.0/search/searchFileByPage

Request Parameters (URI)

Request parameters (URI)
Name Location (Path/Query) Required or not Data type Description
tenant Query True String Tenant name
loginTenant Query True String Currently logged-in tenant
fileName Query True String File name
pages Query False Int Page number. The default value “1” means the first page. If this parameter is not declared in the Query, the default value will be used.
pageSize Query False Int Page size. The default value “10” means that each page contains 10 records. If this parameter is not declared in the Query, the default value will be used.

Note

pageSize and pageToken are used to specify the display of returned results. For example, if you want to display the records from No.201 to No.300, you should set pageSize=100 pageToken=3. pageSize=100 is used to paginate the records into 100 records per page, while pageToken=3 means to search the third page, i.e. the records from No. 201 to No. 300.

Response Parameters

Response parameters
Name Data type Description
status Int Status code
msg String Response message
submsg String Response sub-message
data Object Response data structure, the structure of which is in the table below
data object structure
Name Data type Description
pages Int Page number
pageSize Int Size of each page
totalSize Int Total number of returned records
data Object List consisting of the file detail structures. See the table below for its structure
Structures of member objects in the the data list
Name Data type Description
fileName String File name
filePath String File path
fileSize String File size

Sample

Request sample

GET http://{apigw-address}/dfs-api/v1.0/download?tenant=EDGE&fileName=sample.txt&pages=3&pageSize=3&loginTenant=EDGE

Return sample

{
   "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"
         }
      ]
   }
}