CLI Options¶
These are the command line options reference all the options are present here and have a description.
Global Options¶
These options are common to all commands and affects behavior of the cli.
| --verbose | This options requires an option which tells python logging what messages to print. |
| --config | This specifies the system metadata configuration for use when uploading data. |
Download Sub-Command Options¶
The download sub-command requires interfacing with the cartd service. The cart requires file metadata about what to download and there is several methods for getting that file metadata.
| --destination | Download the files to this folder (default to cwd). |
| --cloudevent | Use the cloudevents file from the notifications service to download. |
| --transaction-id | |
| Setup a cart from this transaction ID. | |
Upload Sub-Command Options¶
There are two sets of options to the upload sub-command. The first comes from the missing values in the metadata configuration json file. The second are common for all uploads and will be documented further.
| --follow-links | This will follow symlinked directories as you walk a directory tree building the list of files to upload. |
| --nowait | The uploader will not wait for the successful or failed ingest of the upload. Instead you will have to query for this information later. |
| --local-retry | Upload an already generated bundle by the –local-save option. This option will honor the –local-save and –tar-in-tar options as well. |
| --local-save | The uploader will save off a copy of the uploaded bundle of data. The path is defined as the argument to the option. |
| --local-compress | |
| Use a compression algorithm (gzip, bzip2) when creating the local save. | |
| --tar-in-tar | A second bundler will be running generating a TAR in a TAR for upload. |
| --dry-run | Do just the query portion of the upload and print off what the metadata will be set to. This will not upload or generate a local save or retry. |
| --interactive | Interact with the results of the query engine to manually select the values for each metadata entry requested. |
| --do-not-upload | |
| This forces the upload process to stop before uploading. This works well with the –local-save option. | |