Chapter 35. image

--print-empty

Print empty table if there is no data to show.

--max-width <integer>

Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

<image>

Image to share (name or id)

<project>

Project to associate with image (name or id)

output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

The output format, defaults to table

-c COLUMN, --column COLUMN

Specify the column(s) to include, can be repeated

--noindent

Whether to disable indenting the json

-h, --help

Show this help message and exit

--project-domain <project-domain>

Domain the project belongs to (name or id). this can be used in case collisions between project names exist.

a format a UNIX shell can parse (variable="value")--prefix PREFIX

Add a prefix to all variable names

--print-empty

Print empty table if there is no data to show.

--max-width <integer>

Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

<image-name>

New image name

output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

The output format, defaults to table

-c COLUMN, --column COLUMN

Specify the column(s) to include, can be repeated

--noindent

Whether to disable indenting the json

--volume <volume>

Create image from a volume

--force

Force image creation if volume is in use (only meaningful with --volume)

--community

Image is accessible to the community

--id <id>

Image id to reserve

--private

Image is inaccessible to the public (default)

--disk-format <disk-format>

Image disk format. the supported options are: ami, ari, aki, vhd, vmdk, raw, qcow2, vhdx, vdi, iso, ploop. The default format is: raw

--unprotected

Allow image to be deleted (default)

--project-domain <project-domain>

Domain the project belongs to (name or id). this can be used in case collisions between project names exist.

--property <key=value>

Set a property on this image (repeat option to set multiple properties)

--min-disk <disk-gb>

Minimum disk size needed to boot image, in gigabytes

--min-ram <ram-mb>

Minimum ram size needed to boot image, in megabytes

--shared

Image can be shared

--file <file>

Upload image from local file

--container-format <container-format>

Image container format. the supported options are: ami, ari, aki, bare, docker, ova, ovf. The default format is: bare

-h, --help

Show this help message and exit

--tag <tag>

Set a tag on this image (repeat option to set multiple tags)

--public

Image is accessible to the public

--project <project>

Set an alternate project on this image (name or id)

--protected

Prevent image from being deleted

a format a UNIX shell can parse (variable="value")--prefix PREFIX

Add a prefix to all variable names

<image>

Image(s) to delete (name or id)

-h, --help

Show this help message and exit

--print-empty

Print empty table if there is no data to show.

--max-width <integer>

Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--quote {all,minimal,none,nonnumeric}

When to include quotes, defaults to nonnumeric

output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

The output format, defaults to table

-c COLUMN, --column COLUMN

Specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--noindent

Whether to disable indenting the json

--public

List only public images

--private

List only private images

--name <name>

Filter images based on name.

--property <key=value>

Filter output based on property

--status <status>

Filter images based on status.

--limit <num-images>

Maximum number of images to display.

--marker <image>

The last image of the previous page. display list of images after marker. Display all images if not specified. (name or ID)

--long

List additional fields in output

--sort <key>[:<direction>]

Sort output by selected keys and directions(asc or desc) (default: name:asc), multiple keys and directions can be specified separated by comma

--shared

List only shared images

-h, --help

Show this help message and exit

<image>

Image to unshare (name or id)

<project>

Project to disassociate with image (name or id)

-h, --help

Show this help message and exit

--project-domain <project-domain>

Domain the project belongs to (name or id). this can be used in case collisions between project names exist.

<image>

Image to save (name or id)

-h, --help

Show this help message and exit

--file <filename>

Downloaded image save filename (default: stdout)

<image>

Image to modify (name or id)

--instance-id <instance-id>

Id of server instance used to create this image

--unprotected

Allow image to be deleted (default)

--activate

Activate the image

--accept

Accept the image membership

--community

Image is accessible to the community

--os-version <os-version>

Operating system distribution version

--private

Image is inaccessible to the public (default)

--name <name>

New image name

--project <project>

Set an alternate project on this image (name or id)

--min-ram <ram-mb>

Minimum ram size needed to boot image, in megabytes

--deactivate

Deactivate the image

-h, --help

Show this help message and exit

--project-domain <project-domain>

Domain the project belongs to (name or id). this can be used in case collisions between project names exist.

--protected

Prevent image from being deleted

--pending

Reset the image membership to pending

--os-distro <os-distro>

Operating system distribution name

--architecture <architecture>

Operating system architecture

--property <key=value>

Set a property on this image (repeat option to set multiple properties)

--reject

Reject the image membership

--shared

Image can be shared

--min-disk <disk-gb>

Minimum disk size needed to boot image, in gigabytes

--ramdisk-id <ramdisk-id>

Id of ramdisk image used to boot this disk image

--tag <tag>

Set a tag on this image (repeat option to set multiple tags)

--public

Image is accessible to the public

--kernel-id <kernel-id>

Id of kernel image used to boot this disk image

--disk-format <disk-format>

Image disk format. the supported options are: ami, ari, aki, vhd, vmdk, raw, qcow2, vhdx, vdi, iso, ploop

--container-format <container-format>

Image container format. the supported options are: ami, ari, aki, bare, docker, ova, ovf

--print-empty

Print empty table if there is no data to show.

--max-width <integer>

Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

<image>

Image to display (name or id)

output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

The output format, defaults to table

-c COLUMN, --column COLUMN

Specify the column(s) to include, can be repeated

--noindent

Whether to disable indenting the json

-h, --help

Show this help message and exit

--human-readable

Print image size in a human-friendly format.

a format a UNIX shell can parse (variable="value")--prefix PREFIX

Add a prefix to all variable names

<image>

Image to modify (name or id)

-h, --help

Show this help message and exit

--property <property-key>

Unset a property on this image (repeat option to unset multiple properties)

--tag <tag>

Unset a tag on this image (repeat option to unset multiple tags)