Associate project with image
openstack image add project
[--project-domain <project-domain>]
<image>
<project>
Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.
Image to share (name or ID)
Project to associate with image (ID)
Create/upload an image
openstack image create
[--id <id>]
[--container-format <container-format>]
[--disk-format <disk-format>]
[--min-disk <disk-gb>]
[--min-ram <ram-mb>]
[--file <file> | --volume <volume>]
[--force]
[--progress]
[--sign-key-path <sign-key-path>]
[--sign-cert-id <sign-cert-id>]
[--protected | --unprotected]
[--public | --private | --community | --shared]
[--property <key=value>]
[--tag <tag>]
[--project <project>]
[--import]
[--project-domain <project-domain>]
<image-name>
Image ID to reserve
Image container format. The supported options are: ami, ari, aki, bare, docker, ova, ovf. The default format is: bare
Image disk format. The supported options are: ami, ari, aki, vhd, vmdk, raw, qcow2, vhdx, vdi, iso, ploop. The default format is: raw
Minimum disk size needed to boot image, in gigabytes
Minimum RAM size needed to boot image, in megabytes
Upload image from local file
Create image from a volume
Force image creation if volume is in use (only meaningful with –volume)
Show upload progress bar (ignored if passing data via stdin)
Sign the image using the specified private key. Only use in combination with –sign-cert-id
The specified certificate UUID is a reference to the certificate in the key manager that corresponds to the public key and is used for signature validation. Only use in combination with –sign-key-path
Prevent image from being deleted
Allow image to be deleted (default)
Image is accessible to the public
Image is inaccessible to the public (default)
Image is accessible to the community
Image can be shared
Set a property on this image (repeat option to set multiple properties)
Set a tag on this image (repeat option to set multiple tags)
Set an alternate project on this image (name or ID)
Force the use of glance image import instead of direct upload
Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.
New image name
Delete image(s)
openstack image delete <image> [<image> ...]
Image(s) to delete (name or ID)
List available images
openstack image list
[--format-config-file FORMAT_CONFIG]
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--public | --private | --community | --shared | --all]
[--property <key=value>]
[--name <name>]
[--status <status>]
[--member-status <member-status>]
[--project <project>]
[--project-domain <project-domain>]
[--tag <tag>]
[--hidden]
[--long]
[--sort <key>[:<direction>]]
[--limit <num-images>]
[--marker <image>]
Config file for the dict-to-csv formatter
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
sort the column(s) in ascending order
sort the column(s) in descending order
List only public images
List only private images
List only community images
List only shared images
List all images
Filter output based on property (repeat option to filter on multiple properties)
Filter images based on name.
Filter images based on status.
Filter images based on member status. The supported options are: accepted, pending, rejected, all.
Search by project (admin only) (name or ID)
Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.
Filter images based on tag. (repeat option to filter on multiple tags)
List hidden images
List additional fields in output
Sort output by selected keys and directions (asc or desc) (default: name:asc), multiple keys and directions can be specified separated by comma
Maximum number of images to display.
The last image of the previous page. Display list of images after marker. Display all images if not specified. (name or ID)
List projects associated with image
openstack image member list
[--format-config-file FORMAT_CONFIG]
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--project-domain <project-domain>]
<image>
Config file for the dict-to-csv formatter
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
sort the column(s) in ascending order
sort the column(s) in descending order
Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.
Image (name or ID)
Create a metadef namespace
openstack image metadef namespace create
[--display-name <display_name>]
[--description <description>]
[--public | --private]
[--protected | --unprotected]
<namespace>
A user-friendly name for the namespace.
A description of the namespace
Set namespace visibility ‘public’
Set namespace visibility ‘private’
Prevent metadef namespace from being deleted
Allow metadef namespace to be deleted (default)
New metadef namespace name
Delete metadef namespace
openstack image metadef namespace delete
<namespace_name>
[<namespace_name> ...]
An identifier (a name) for the namespace
List metadef namespaces
openstack image metadef namespace list
[--format-config-file FORMAT_CONFIG]
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--resource-types <resource_types>]
[--visibility <visibility>]
Config file for the dict-to-csv formatter
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
sort the column(s) in ascending order
sort the column(s) in descending order
filter resource types
filter on visibility
Set metadef namespace properties
openstack image metadef namespace set
[--display-name <display_name>]
[--description <description>]
[--public | --private]
[--protected | --unprotected]
<namespace>
Set a user-friendly name for the namespace.
Set the description of the namespace
Set namespace visibility ‘public’
Set namespace visibility ‘private’
Prevent metadef namespace from being deleted
Allow metadef namespace to be deleted (default)
Namespace (name) for the namespace
Show a metadef namespace
openstack image metadef namespace show <namespace_name>
Namespace (name) for the namespace
Disassociate project with image
openstack image remove project
[--project-domain <project-domain>]
<image>
<project>
Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.
Image to unshare (name or ID)
Project to disassociate with image (name or ID)
Save an image locally
openstack image save [--file <filename>] <image>
Downloaded image save filename (default: stdout)
Image to save (name or ID)
Set image properties
openstack image set
[--name <name>]
[--min-disk <disk-gb>]
[--min-ram <ram-mb>]
[--container-format <container-format>]
[--disk-format <disk-format>]
[--protected | --unprotected]
[--public | --private | --community | --shared]
[--property <key=value>]
[--tag <tag>]
[--architecture <architecture>]
[--instance-id <instance-id>]
[--kernel-id <kernel-id>]
[--os-distro <os-distro>]
[--os-version <os-version>]
[--ramdisk-id <ramdisk-id>]
[--deactivate | --activate]
[--project <project>]
[--project-domain <project-domain>]
[--accept | --reject | --pending]
[--hidden | --unhidden]
<image>
New image name
Minimum disk size needed to boot image, in gigabytes
Minimum RAM size needed to boot image, in megabytes
Image container format. The supported options are: ami, ari, aki, bare, docker, ova, ovf
Image disk format. The supported options are: ami, ari, aki, vhd, vmdk, raw, qcow2, vhdx, vdi, iso, ploop
Prevent image from being deleted
Allow image to be deleted (default)
Image is accessible to the public
Image is inaccessible to the public (default)
Image is accessible to the community
Image can be shared
Set a property on this image (repeat option to set multiple properties)
Set a tag on this image (repeat option to set multiple tags)
Operating system architecture
ID of server instance used to create this image
ID of kernel image used to boot this disk image
Operating system distribution name
Operating system distribution version
ID of ramdisk image used to boot this disk image
Deactivate the image
Activate the image
Set an alternate project on this image (name or ID)
Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.
Accept the image membership
Reject the image membership
Reset the image membership to ‘pending’
Hide the image
Unhide the image
Image to modify (name or ID)
Display image details
openstack image show [--human-readable] <image>
Print image size in a human-friendly format.
Image to display (name or ID)
Upload data for a specific image to staging. This requires support for the interoperable image import process, which was first introduced in Image API version 2.6 (Glance 16.0.0 (Queens))
openstack image stage [--file <file>] [--progress] <image>
Local file that contains disk image to be uploaded. Alternatively, images can be passed via stdin.
Show upload progress bar (ignored if passing data via stdin)
Image to upload data for (name or ID)
List tasks
openstack image task list
[--format-config-file FORMAT_CONFIG]
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--sort-key <key>[:<field>]]
[--sort-dir <key>[:<direction>]]
[--limit <num-tasks>]
[--marker <task>]
[--type <type>]
[--status <status>]
Config file for the dict-to-csv formatter
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
sort the column(s) in ascending order
sort the column(s) in descending order
Sorts the response by one of the following attributes: created_at, expires_at, id, status, type, updated_at. (default is created_at) (multiple keys and directions can be specified separated by comma)
Sort output by selected keys and directions (asc or desc) (default: name:desc) (multiple keys and directions can be specified separated by comma)
Maximum number of tasks to display.
The last task of the previous page. Display list of tasks after marker. Display all tasks if not specified. (name or ID)
Filters the response by a task type.
Filter tasks based on status.
Display task details
openstack image task show <Task ID>
Task to display (ID)
Unset image tags and properties
openstack image unset [--tag <tag>] [--property <property-key>] <image>
Unset a tag on this image (repeat option to unset multiple tags)
Unset a property on this image (repeat option to unset multiple properties)
Image to modify (name or ID)
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.