Dean Troyer 201b1cee86 Clean up Image v2 image set command

Make the Image v2 image set command meet at the intersection of the v1
image set command and the v2 image create command:

* Add visibility to the deadopts list and remove the option
* Put the options in the same order as v1 image set
* Make the help text match
* Add --properties
* Move the additional options that do not appear in either v1 image set or
  v2 image create after --property as they are really pre-defined properties
* Add tests for v2 image set to match v1 and then some
* Put the SetImage class in v2/image.py in alphabetical order

Change-Id: I102b914e8ad09a014f6fdd846c5766b6c2eaadb8

2015-10-06 11:11:59 -07:00

8.2 KiB

Raw Blame History

image

Image v1, v2

image create

Image v1, v2

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> [...] ]
    [--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)

<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

Image v1, v2

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> [...] ]
    [--architecture <architecture>]
    [--instance-id <instance-id>]
    [--kernel-id <kernel-id>]
    [--os-distro <os-distro>]
    [--os-version <os-version>]
    [--ramdisk-id <ramdisk-id>]
    <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>

Image container format (default: bare)

--disk-format <disk-format>

Image disk format (default: raw)

--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 option to set multiple properties)

--architecture <architecture>

Operating system architecture

--instance-id <instance-id>

ID of server instance used to create this image

--kernel-id <kernel-id>

ID of kernel image used to boot this disk image

--os-distro <os-distro>

Operating system distribution name

--os-version <os-version>

Operating system distribution version

--ramdisk-id <ramdisk-id>

ID of ramdisk image used to boot this disk image

<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 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 to disassociate with image (name or ID)

8.2 KiB Raw Blame History

image

image create

image delete

image list

image save

image set

image show

image add project

image remove project

8.2 KiB

Raw Blame History