f5b50df8ea
We have it for v1, but v2 is the future. There are two differences, things in v2 do not go into a properties dict, and the actual image data needs to get uploaded as a second step. Closes-Bug: 1405562 Co-Authored-By: Niall Bunting <niall.bunting@hp.com> Co-Authored-By: Sean Perry <sean.perry@hp.com> Change-Id: If7b81c4a6746c8a1eb0302c96e045fb0f457d67b
7.2 KiB
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)
2
<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)