`orca image` — image¶

Manage images.

cache-clear¶

Clear the entire image cache (admin).

orca image cache-clear [OPTIONS]

Option	Description
`-y, --yes`	Skip confirmation.
`--help`	Show this message and exit.

cache-delete¶

Remove a specific image from the cache (admin).

orca image cache-delete [OPTIONS]

Option	Description
`-y, --yes`	Skip confirmation.
`--help`	Show this message and exit.

cache-list¶

List cached and queued images (admin).

orca image cache-list [OPTIONS]

Option	Description
`--noindent`	Disable JSON indentation.
`--max-width INTEGER`	Maximum table width (0 = unlimited).
`--fit-width`	Fit table to terminal width.
`-c, --column TEXT`	Column to include (repeatable). Shows all if
`-f, --format [table\|json\|value]`
`--help`	Show this message and exit.

cache-queue¶

Queue an image for pre-caching (admin).

orca image cache-queue [OPTIONS]

Option	Description

create¶

Create a new image (and optionally upload data).

orca image create [OPTIONS]

Option	Description
`--disk-format [raw\|qcow2\|vmdk\|vdi\|vhd\|vhdx\|iso\|aki\|ari\|ami]`
`--container-format [bare\|ovf\|ova\|aki\|ari\|ami\|docker]`
`--min-disk INTEGER`	Min disk (GB). [default: 0]
`--min-ram INTEGER`	Min RAM (MB). [default: 0]
`--visibility [private\|shared\|community\|public]`
`--file PATH`	Upload image data from file immediately.
`--help`	Show this message and exit.

deactivate¶

Deactivate an image (make data unavailable).

orca image deactivate [OPTIONS]

Option	Description

delete¶

Delete an image.

orca image delete [OPTIONS]

Option	Description
`-y, --yes`	Skip confirmation.
`--help`	Show this message and exit.

download¶

Download image data to a local file.

orca image download [OPTIONS]

Option	Description
`-o, --output PATH`	Output file path. [required]
`--help`	Show this message and exit.

import¶

Import image data using the Glance v2 import API.

orca image import [OPTIONS]

Option	Description
`--method [web-download\|glance-direct\|copy-image]`
`--uri TEXT`	Source URI (required for web-download).
`--store TEXT`	Target store(s) for copy-image (repeatable).
`--help`	Show this message and exit.

list¶

List available images.

orca image list [OPTIONS]

Option	Description
`--noindent`	Disable JSON indentation.
`--max-width INTEGER`	Maximum table width (0 = unlimited).
`--fit-width`	Fit table to terminal width.
`-c, --column TEXT`	Column to include (repeatable). Shows all if
`-f, --format [table\|json\|value]`
`--help`	Show this message and exit.

member-create¶

PROJECT_ID

orca image member-create [OPTIONS]

Option	Description

member-delete¶

PROJECT_ID

orca image member-delete [OPTIONS]

Option	Description
`-y, --yes`	Skip confirmation.
`--help`	Show this message and exit.

member-list¶

List all projects that have access to a shared image.

orca image member-list [OPTIONS]

Option	Description
`--noindent`	Disable JSON indentation.
`--max-width INTEGER`	Maximum table width (0 = unlimited).
`--fit-width`	Fit table to terminal width.
`-c, --column TEXT`	Column to include (repeatable). Shows all if
`-f, --format [table\|json\|value]`
`--help`	Show this message and exit.

member-set¶

Accept, reject, or reset a shared image invitation.

orca image member-set [OPTIONS]

Option	Description
`--status [accepted\|rejected\|pending]`
`--help`	Show this message and exit.

member-show¶

Show a specific project's membership status for a shared image.

orca image member-show [OPTIONS]

Option	Description
`--noindent`	Disable JSON indentation.
`--max-width INTEGER`	Maximum table width (0 = unlimited).
`--fit-width`	Fit table to terminal width.
`-c, --column TEXT`	Column to include (repeatable). Shows all if
`-f, --format [table\|json\|value]`
`--help`	Show this message and exit.

reactivate¶

Reactivate a deactivated image.

orca image reactivate [OPTIONS]

Option	Description

PROJECT_ID

orca image share-and-accept [OPTIONS]

Option	Description
`-y, --yes`	Skip confirmation.
`--help`	Show this message and exit.

show¶

Show image details.

orca image show [OPTIONS]

Option	Description
`--noindent`	Disable JSON indentation.
`--max-width INTEGER`	Maximum table width (0 = unlimited).
`--fit-width`	Fit table to terminal width.
`-c, --column TEXT`	Column to include (repeatable). Shows all if
`-f, --format [table\|json\|value]`
`--help`	Show this message and exit.

shrink¶

Convert a raw image to qcow2 with compression to save space.

orca image shrink [OPTIONS]

Option	Description
`-y, --yes`	Skip confirmation.
`--help`	Show this message and exit.

stage¶

Upload image data to the staging area (interruptible import).

orca image stage [OPTIONS]

Option	Description

stores-info¶

List available Glance storage backends (multi-store only).

orca image stores-info [OPTIONS]

Option	Description
`--detail`	Show store properties (admin only, requires
`--noindent`	Disable JSON indentation.
`--max-width INTEGER`	Maximum table width (0 = unlimited).
`--fit-width`	Fit table to terminal width.
`-c, --column TEXT`	Column to include (repeatable). Shows all if
`-f, --format [table\|json\|value]`
`--help`	Show this message and exit.

tag-add¶

Add a tag to an image.

orca image tag-add [OPTIONS]

Option	Description

tag-delete¶

Remove a tag from an image.

orca image tag-delete [OPTIONS]

Option	Description

task-list¶

List Glance async tasks.

orca image task-list [OPTIONS]

Option	Description
`--type [import\|export\|clone]`	Filter by task type.
`--status [pending\|processing\|success\|failure]`
`--noindent`	Disable JSON indentation.
`--max-width INTEGER`	Maximum table width (0 = unlimited).
`--fit-width`	Fit table to terminal width.
`-c, --column TEXT`	Column to include (repeatable). Shows all if
`-f, --format [table\|json\|value]`
`--help`	Show this message and exit.

task-show¶

Show details of a Glance async task.

orca image task-show [OPTIONS]

Option	Description
`--noindent`	Disable JSON indentation.
`--max-width INTEGER`	Maximum table width (0 = unlimited).
`--fit-width`	Fit table to terminal width.
`-c, --column TEXT`	Column to include (repeatable). Shows all if
`-f, --format [table\|json\|value]`
`--help`	Show this message and exit.

unused¶

Find images not used by any server instance.

orca image unused [OPTIONS]

Option	Description
`-d, --delete`	Actually delete unused images.
`-y, --yes`	Skip confirmation (with --delete).
`--include-snapshots`	Include snapshot images in the scan.
`--help`	Show this message and exit.

update¶

Update image properties (JSON-Patch).

orca image update [OPTIONS]

Option	Description
`--name TEXT`	New name.
`--min-disk INTEGER`	New min disk (GB).
`--min-ram INTEGER`	New min RAM (MB).
`--visibility [private\|shared\|community\|public]`
`--help`	Show this message and exit.

upload¶

Upload image data from a local file.

orca image upload [OPTIONS]

Option	Description

orca image — image¶

cache-clear¶

cache-delete¶

cache-list¶

cache-queue¶

create¶

deactivate¶

delete¶

download¶

import¶

list¶

member-create¶

member-delete¶

member-list¶

member-set¶

member-show¶

reactivate¶

share-and-accept¶

show¶

shrink¶

stage¶

stores-info¶

tag-add¶

tag-delete¶

task-list¶

task-show¶

unused¶

update¶

upload¶

`orca image` — image¶