vip import media
Import media files to an environment from an archived file located at a publicly accessible URL.
Usage
vip import media [options] [command]
Options
| Option | Description |
|---|---|
-a, --app |
Target an application. Accepts a string value for the application name or an integer for the application ID. |
-d, --debug |
Generate verbose output during command execution to help identify or fix errors or bugs. |
-e, --env |
Target an environment. Accepts a string value for the environment type. |
-E, --exportFileErrorsToJson |
Format the error log in JSON. Default is TXT. |
-f, --force |
Skip confirmation. (disabled by default) |
-h, --help |
Retrieve a description, examples, and available options for a (sub)command. |
-i, --importIntermediateImages |
Include intermediate image files in the import. (disabled by default) |
-o, --overwriteExistingFiles |
Overwrite existing files with the imported files if they have the same path and file name. (disabled by default) |
-s, --saveErrorLog |
Skip the confirmation prompt and download an error log for the import automatically. |
-v, --version |
Retrieve the version number of VIP-CLI currently installed on the local machine. |
Examples
- Import the archived file "uploads.zip" from the user's local machine to a production environment.
$ vip @example-app.production import media /path/to/uploads.zip
- Import the archived file "uploads.tar.gz" from a publicly accessible URL to a production environment.
$ vip @example-app.production import media https://example.com/uploads.tar.gz
- Overwrite existing files with the imported files if they have the same file path and name, and format the error log for the import in JSON.
$ vip @example-app.production import media https://example.com/uploads.tgz --overwriteExistingFiles --exportFileErrorsToJson
- Check the status of the most recent media import.
$ vip @example-app.production import media status
- Abort the currently running media import.
$ vip @example-app.production import media abort
Subcommands
Last updated: January 07, 2026