Note
This documentation is for a prior release of Kinetica. For the latest documentation, click here.
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:
Empty string in case of an error. |
