image v1¶
image create¶
Create/upload an image
openstack image create
[--id <id>]
[--store <store>]
[--container-format <container-format>]
[--disk-format <disk-format>]
[--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>]
[--project <project>]
<image-name>
- --id <id>¶
Image ID to reserve
- --store <store>¶
Upload image to this store
- --container-format <container-format>¶
Image container format. The supported options are: ami, ari, aki, bare, docker, ova, ovf. The default format is: bare
- --disk-format <disk-format>¶
Image disk format. The supported options are: ami, ari, aki, vhd, vmdk, raw, qcow2, vhdx, vdi, iso, ploop. The default format is: raw
- --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 <ram-mb>¶
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 option to set multiple properties)
- --project <project>¶
Set an alternate project on this image (name or ID)
- image-name¶
New image name
image delete¶
Delete image(s)
openstack image delete <image> [<image> ...]
- image¶
Image(s) to delete (name or ID)
image list¶
List available images
openstack image list
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--public | --private]
[--property <key=value>]
[--long]
[--sort <key>[:<direction>]]
- --sort-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- --public¶
List only public images
- --private¶
List only private images
- --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: name:asc), multiple keys and directions can be specified separated by comma
image save¶
Save an image locally
openstack image save [--file <filename>] <image>
- --file <filename>¶
Downloaded image save filename (default: stdout)
- image¶
Image to save (name or ID)
image set¶
Set image properties
openstack image set
[--name <name>]
[--min-disk <disk-gb>]
[--min-ram <disk-ram>]
[--container-format <container-format>]
[--disk-format <disk-format>]
[--size <size>]
[--protected | --unprotected]
[--public | --private]
[--property <key=value>]
[--store <store>]
[--location <image-url>]
[--copy-from <image-url>]
[--file <file>]
[--volume <volume>]
[--force]
[--stdin]
[--checksum <checksum>]
[--project <project>]
<image>
- --name <name>¶
New image name
- --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. The supported options are: ami, ari, aki, bare, docker, ova, ovf
- --disk-format <disk-format>¶
Image disk format. The supported options are: ami, ari, aki, vhd, vmdk, raw, qcow2, vhdx, vdi, iso, ploop.
- --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)
- --property <key=value>¶
Set a property on this image (repeat option to set multiple properties)
- --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>¶
Create image from a volume
- --force¶
Force image change if volume is in use (only meaningful with –volume)
- --stdin¶
Read image data from standard input
- --checksum <checksum>¶
Image hash used for verification
- --project <project>¶
Set an alternate project on this image (name or ID)
- image¶
Image to modify (name or ID)
image show¶
Display image details
openstack image show [--human-readable] <image>
- --human-readable¶
Print image size in a human-friendly format.
- image¶
Image to display (name or ID)