image¶
Image v1, v2
image create¶
Image v1, v2
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> [...] ]
[--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)
New in version 2.
-
<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¶
Image v1, v2
Set image properties
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)
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 for multiple values)
Image version 1 only.
-
--architecture
<architecture>
¶ Operating system Architecture
New in version 2.
-
--ramdisk-id
<ramdisk-id>
¶ ID of image stored in Glance that should be used as the ramdisk when booting an AMI-style image
New in version 2.
-
--os-distro
<os-distro>
¶ Common name of operating system distribution
New in version 2.
-
--os-version
<os-version>
¶ Operating system version as specified by the distributor
New in version 2.
-
--kernel-id
<kernel-id>
¶ ID of image in Glance that should be used as the kernel when booting an AMI-style image
New in version 2.
-
--instance-uuid
<instance_uuid>
¶ ID of instance used to create this image
New in version 2.
-
<image>
Image to modify (name or ID)
image add project¶
Only supported for Image v2
Associate project with image
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
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)