/delete/files

URL: http://<db.host>:<db.port>/delete/files

Deletes one or more files from KiFS.

Input Parameter Description

NameTypeDescription
file_namesarray of stringsAn array of names of files to be deleted. File paths may contain wildcard characters after the KiFS directory delimeter. Accepted wildcard characters are asterisk (*) to represent any string of zero or more characters, and question mark (?) to indicate a single character.
optionsmap of string to strings

Optional parameters. The default value is an empty map ( {} ).

Supported Parameters (keys)Parameter Description
no_error_if_not_exists

If true, no error is returned if a specified file does not exist The default value is false. The supported values are:

  • true
  • false

Output Parameter Description

The GPUdb server embeds the endpoint response inside a standard response structure which contains status information and the actual response to the query. Here is a description of the various fields of the wrapper:

NameTypeDescription
statusString'OK' or 'ERROR'
messageStringEmpty if success or an error message
data_typeString'delete_files_response' or 'none' in case of an error
dataStringEmpty string
data_strJSON or String

This embedded JSON represents the result of the /delete/files endpoint:

NameTypeDescription
file_namesarray of stringsNames of the files deleted from KiFS
infomap of string to stringsAdditional information.

Empty string in case of an error.