image¶
Image v1, v2
image create¶
Only supported for Image v1
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> [...] ]
<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 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
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¶
Only supported for Image v1
Set image properties
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)