CLI reference

norcube backup jobs download

Download a backup artifact to a local file

Not verified yet

Download the artifact of a succeeded backup job.

The backend issues a short-lived presigned URL for the backup object and the CLI streams it to disk. The bytes come straight from storage, not through the Norcube API. The default filename is taken from the object name; override it with --file, or pass --file - to stream to stdout (for piping into pg_restore/mongorestore).

Backups stored in customer-managed buckets can't be downloaded this way: Norcube deliberately holds no read credentials for your bucket, so fetch the object directly from your own storage instead.

Usage

norcube backup jobs download <job-id> [flags]

Examples

# Download next to you, keeping the object name
norcube backup jobs download 6a1b2c3d-… --datasource 9f8e7d6c-…

# Pipe straight into a restore (pg_dump custom format; decompression must
# match the policy's compression setting, gzip here)
norcube backup jobs download 6a1b2c3d-… -d 9f8e7d6c-… --file - | gunzip | pg_restore -d "$DSN"

Flags

FlagDefaultDescription
-d, --datasourceDatasource the backup belongs to (id)
--fileWrite to this path instead of the object name; use - for stdout

Every command also takes the global flags: --profile, --org, -o, --query, --debug and more.

See also

On this page