space:upload#
Upload files to a space from your local file system. By default, all files in the source directory will be uploaded.
Tip
You can copy the first part of this command from the CONVERGE Horizon web interface. In your space, navigate to the directory to which the files will be uploaded and click the Copy (
) button. Select horizon space:upload to copy the command for uploading to that directory. The copied string will be missing the --source option, which you must provide. You can also edit the string to add any options you want to apply.
Usage
horizon space:upload [options]
Examples
# Upload files from the current working directory to /my/case/dir/ in My Space
horizon space:upload --space="My Space" --destination="/my/case/dir/" --source="."
# Exclude files in outputs_* directories
horizon space:upload --space="My Space" --destination="/my/case/dir/" --source="." --exclude="*outputs_*"
# Upload only .in and .dat files
horizon space:upload --space="My Space" --destination="/my/case/dir/" --source="." --include="*.in" --include="*.dat"
# Upload files with paths containing "map", excluding .log files
horizon space:upload --space="My Space" --destination="/my/case/dir/" --source="." --include="*map*" --exclude="*.log"
Options
This command supports the general CLI options in addition to those listed below.
--space=SPACEThe name or ID of the space to which files will be uploaded. You can get the space ID by running space:list or by navigating to the space in the web interface and clicking the Copy (
) button.--destination=DESTINATIONThe path to the directory in the space to which files will be uploaded. If the directory does not exist, it will be created. If the directory already exists, you can copy the path by navigating to the directory in the web interface and clicking the Copy (
) button.--source=SOURCEThe path to the directory on your local file system from which files will be uploaded (relative to the current directory).
--exclude=PATTERN, -e PATTERNExclude files with paths that match PATTERN (use * to match any character in the file path). The PATTERN is compared to the entire file path, not just the file name. If you use this option in conjunction with
--include, the included files are processed before the excluded files.Repeatable—To specify multiple patterns, pass this option once per pattern.
--include=PATTERN, -i PATTERNUpload only the files with paths that match PATTERN (use * to match any character in the file path). The PATTERN is compared to the entire file path, not just the file name. If you use this option in conjunction with
--exclude, the included files are processed before the excluded files.Repeatable—To specify multiple patterns, pass this option once per pattern.
--resume, -RDo not upload files from the source that already exist (with the same file name and size) in the destination. This option is useful for resuming uploads that were not completed.