Dean Troyer 1ecf1bee2d Begin low-level API for Image v1 and v2
image list for v1 and v2:
* Add --public|--private to command parsers
* Implement local public/private filtering for v1 image_list()
* Pass public/private filter to server for v2 image_list()

Change-Id: Ie7c24ea2d1bf2b3b1b7fa342eb45fee45894634d
2015-01-20 17:01:23 -06:00

4.3 KiB

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
    [--page-size <size>]
    [--public|--private]
    [--long]

--page-size <size>

Number of images to request in each paginated request

--public

List only public images

--private

List only private images

--long

List additional fields in output

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>]
    [--protected | --unprotected]
    [--public | --private]
    [--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

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

Image to modify (name or ID)

image show

Display image details

image show

os image show
    <image>

<image>

Image to display (name or ID)