image

Image v1, v2

image create

Image v1, v2

Create/upload an image

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> [...] ]
    [--tag <tag> [...] ]
    <image-name>

--id <id>

Image ID to reserve

--store <store>

Upload image to this store

Image version 1 only.

--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

Image version 1 only.

--size <size>

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

Image version 1 only.

--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

Image version 1 only.

--copy-from <image-url>

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

Image version 1 only.

--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

Image version 1 only.

--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)

--tag <tag>

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

New in version 2.

<image-name>

New image name

image delete

Delete image(s)

os image delete
    <image>

<image>

Image(s) to delete (name or ID)

image list

List available images

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

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

--file <filename>

Downloaded image save filename (default: stdout)

<image>

Image to save (name or ID)

image set

Image v1, v2

Set image properties

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)

Image version 1 only.

--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

Image version 1 only.

--location <image-url>

Download image from an existing URL

Image version 1 only.

--copy-from <image-url>

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

Image version 1 only.

--file <file>

Upload image from local file

Image version 1 only.

--volume <volume>

Update image with a volume

Image version 1 only.

--force

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

Image version 1 only.

--checksum <checksum>

Image hash used for verification

Image version 1 only.

--stdin

Allow to read image data from standard input

Image version 1 only.

--property <key=value>

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

Image version 1 only.

--architecture <architecture>

Operating system Architecture

New in version 2.

--ramdisk-id <ramdisk-id>

ID of image stored in Glance that should be used as the ramdisk when booting an AMI-style image

New in version 2.

--os-distro <os-distro>

Common name of operating system distribution

New in version 2.

--os-version <os-version>

Operating system version as specified by the distributor

New in version 2.

--kernel-id <kernel-id>

ID of image in Glance that should be used as the kernel when booting an AMI-style image

New in version 2.

--instance-uuid <instance_uuid>

ID of instance used to create this image

New in version 2.

<image>

Image to modify (name or ID)

image show

Display image details

os image show
    <image>

<image>

Image to display (name or ID)

image add project

Only supported for Image v2

Associate project with image

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

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)