python-openstackclient/doc/source/command-objects/image.rst

image

Image v1, v2

image create

Only supported for Image v1

Create/upload an image

image create

os image create
    [--id <id>]
    [--store <store>]
    [--container-format <container-format>]
    [--disk-format <disk-format>]
    [--owner <project>]
    [--size <size>]
    [--min-disk <disk-gb>]
    [--min-ram <ram-mb>]
    [--location <image-url>]
    [--copy-from <image-url>]
    [--file <file>]
    [--volume <volume>]
    [--force]
    [--checksum <checksum>]
    [--protected | --unprotected]
    [--public | --private]
    [--property <key=value> [...] ]
    <image-name>

--id <id>

Image ID to reserve

--store <store>

Upload image to this store

--container-format <container-format>

Image container format (default: bare)

--disk-format <disk-format>

Image disk format (default: raw)

--owner <project>

Image owner project name or ID

--size <size>

Image size, in bytes (only used with --location and --copy-from)

--min-disk <disk-gb>

Minimum disk size needed to boot image, in gigabytes

--min-ram <disk-ram>

Minimum RAM size needed to boot image, in megabytes

--location <image-url>

Download image from an existing URL

--copy-from <image-url>

Copy image from the data store (similar to --location)

--file <file>

Upload image from local file

--volume <volume>

Create image from a volume

--force

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

--checksum <checksum>

Image hash used for verification

--protected

Prevent image from being deleted

--unprotected

Allow image to be deleted (default)

--public

Image is accessible to the public

--private

Image is inaccessible to the public (default)

--property <key=value>

Set a property on this image (repeat for multiple values)

<image-name>

New image name

image delete

Delete image(s)

image delete

os image delete
    <image>

<image>

Image(s) to delete (name or ID)

image list

List available images

image list

os image list
    [--public | --private | --shared]
    [--property <key=value>]
    [--long]
    [--sort <key>[:<direction>]]

--public

List only public images

--private

List only private images

--shared

List only shared images

Image version 2 only.

--property <key=value>

Filter output based on property

--long

List additional fields in output

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

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

image save

Save an image locally

image save

os image save
    --file <filename>
    <image>

--file <filename>

Downloaded image save filename (default: stdout)

<image>

Image to save (name or ID)

image set

Only supported for Image v1

Set image properties

image set

os image set
    [--name <name>]
    [--owner <project>]
    [--min-disk <disk-gb>]
    [--min-ram <disk-ram>]
    [--container-format <container-format>]
    [--disk-format <disk-format>]
    [--size <size>]
    [--protected | --unprotected]
    [--public | --private]
    [--store <store>]
    [--location <image-url>]
    [--copy-from <image-url>]
    [--file <file>]
    [--volume <volume>]
    [--force]
    [--checksum <checksum>]
    [--stdin]
    [--property <key=value> [...] ]
    <image>

--name <name>

New image name

--owner <project>

New image owner project (name or ID)

--min-disk <disk-gb>

Minimum disk size needed to boot image, in gigabytes

--min-ram <disk-ram>

Minimum RAM size needed to boot image, in megabytes

--container-format <container-format>

Container format of image. Acceptable formats: ['ami', 'ari', 'aki', 'bare', 'ovf']

--disk-format <disk-format>

Disk format of image. Acceptable formats: ['ami', 'ari', 'aki', 'vhd', 'vmdk', 'raw', 'qcow2', 'vdi', 'iso']

--size <size>

Size of image data (in bytes)

--protected

Prevent image from being deleted

--unprotected

Allow image to be deleted (default)

--public

Image is accessible to the public

--private

Image is inaccessible to the public (default)

--store <store>

Upload image to this store

--location <image-url>

Download image from an existing URL

--copy-from <image-url>

Copy image from the data store (similar to --location)

--file <file>

Upload image from local file

--volume <volume>

Update image with a volume

--force

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

--checksum <checksum>

Image hash used for verification

--stdin

Allow to read image data from standard input

--property <key=value>

Set a property on this image (repeat for multiple values)

<image>

Image to modify (name or ID)

image show

Display image details

image show

os image show
    <image>

<image>

Image to display (name or ID)

image add project

Only supported for Image v2

Associate project with image

image add project

os image add project
    [--project-domain <project-domain>]
    <image> <project>

--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 share (name or ID).

<project>

Project to associate with image (name or ID)

image remove project

Only supported for Image v2

Disassociate project with image

image remove project

os image remove remove
    [--project-domain <project-domain>]
    <image> <project>

--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 unshare (name or ID).

<project>

Project to disassociate with image (name or ID)