/show/files

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

Shows information about files in KiFS. Can be used for individual files, or to show all files in a given directory.

Input Parameter Description

Name	Type	Description
paths	array of strings	File paths to show. Each path can be a KiFS directory name, or a full path to a KiFS file. 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.
options	map of string to strings	Optional parameters. The default value is an empty map ( {} ).

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:

Name

Type

Description

status

String

'OK' or 'ERROR'

message

String

Empty if success or an error message

data_type

String

'show_files_response' or 'none' in case of an error

data

String

Empty string

data_str

JSON or String

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

Name

Type

Description

file_names

array of strings

A listing of files in the paths specified

sizes

array of longs

Size of each file, in bytes

users

array of strings

User that created the file

creation_times

array of longs

Creation time for each file, in milliseconds since epoch

info

map of string to strings

Additional information.

Possible Parameters (keys)	Parameter Description
multipart_uploads	JSON-encoded information about multipart uploads in progress

Empty string in case of an error.