URL: https://<aws.fqdn>/<aws.cluster.name>/gpudb-0/upload/files/fromurl
Uploads one or more files to KiFS.
Each file path must reside in a top-level KiFS directory, i.e. one of the directories listed in /show/directories. The user must have write permission on the directory. Nested directories are permitted in file name paths. Directories are deliniated with the directory separator of '/'. For example, given the file path '/a/b/c/d.txt', 'a' must be a KiFS directory.
These characters are allowed in file name paths: letters, numbers, spaces, the path delimiter of '/', and the characters: '.' '-' ':' '[' ']' '(' ')' '#' '='.
Input Parameter Description
| Name | Type | Description |
|---|---|---|
| file_names | array of strings | An array of full file name paths to be used for the files uploaded to KiFS. File names may have any number of nested directories in their paths, but the top-level directory must be an existing KiFS directory. Each file must reside in or under a top-level directory. A full file name path cannot be larger than 1024 characters. |
| urls | array of strings | List of URLs to upload, for each respective file in input parameter file_names. |
| 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 | 'upload_files_fromurl_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 /upload/files/fromurl endpoint:
Empty string in case of an error. |
