Search for files

get

https://apis.druva.com/insync/search/mds/v1/user/files

Search for backed-up files using the SHA1 checksum value and view their details. While using this API, ensure the following:

Make repeated API calls until the next page token is empty
For each response, append the previous search results into the list until the next page token yields empty results
This list is the final search result across the entire dataset

Note : SaaS Apps such as SharePoint Online and Shared Drive are not supported

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

sha1Checksum

string

required

Specify the SHA1 value of the file that you want to search. To know how to get SHA1 value of a file, see <a href=https://docs.druva.com/Data_Governance/Federated_Search_for_backed_up_data/010_How_to_search_backed_up_files#Search_files_using_checksums>Search files using checksums.

minCreationTime

string

Filter to list the files which are created after a particular date and time. Format - YYYY-MM-DDTHH:MM:SSZ

maxCreationTime

string

Filter to list the files which are created before a particular date and time. Format - YYYY-MM-DDTHH:MM:SSZ

minModificationTime

string

Specify the minimum cut-off value of modification time to filter the list of files after a specific date and time. Format - YYYY-MM-DDTHH:MM:SSZ

maxModificationTime

string

Specify the maximum cut-off value of modification time to filter the list of files before a specific date and time. Format - YYYY-MM-DDTHH:MM:SSZ

fileType

array of strings

Specify the file extensions by which you intend to filter the file search list. For e.g .txt

fileType

minFileSize

integer

Filter to list the files based on their minimum file size (in bytes). All files with a size greater than mentioned value will be listed.

maxFileSize

integer

Filter to list the files based on their maximum file size (in bytes). All files with a size less than mentioned value will be listed.

dataSource

array of strings

Select a data source from which you want to list the files.

dataSource

userID

array of integers

Specify the User ID of the user for whom you want to filter and list the file results. Get the ID of a user using the ‘List all users’ API.

userID

pageToken

string

The token to access the next page of results. Use the token value received in the previous response's parameter nextPageToken.

Responses

200OK

400Bad Request

401The request did not include an authentication token or an expired authentication token was supplied.

403Forbidden

404The requested resource was not found.

500Internal Server Error