12 KiB
image
Image v1, v2
image add project
Only supported for Image v2
Associate project with image
image add project
openstack 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 to share (name or ID).
Project to associate with image (name or ID)
image create
Image v1, v2
Create/upload an image
image create
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 | --community | --shared]
[--property <key=value> [...] ]
[--tag <tag> [...] ]
[--project <project>]
[--project-domain <project-domain>]
<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. 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, and ploop. The default format is: raw
--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 <ram-mb>
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)
--community
Image is accessible to the community
--shared
Image can be shared
--property <key=value>
Set a property on this image (repeat option to set multiple properties)
--tag <tag>
Set a tag on this image (repeat option to set multiple tags)
2
--project <project>
Set an alternate project on this image (name or ID). Previously known as --owner.
--project-domain <project-domain>
Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.
2
New image name
image delete
Delete image(s)
image delete
openstack image delete
<image>
Image(s) to delete (name or ID)image list
List available images
image list
openstack image list
[--public | --private | --shared]
[--property <key=value>]
[--name <name>]
[--status <status>]
[--long]
[--sort <key>[:<direction>]]
[--limit <num-images>]
[--marker <image>]--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
--name <name>
Filter images based on name
Image version 2 only.
--status <status>
Filter images based on status
Image version 2 only
--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
--limit <num-images>
Maximum number of images to display.
Image version 2 only
--marker <image>
The last image of the previous page. Display list of images after marker. Display all images if not specified. (name or ID)
Image version 2 only
image remove project
Only supported for Image v2
Disassociate project with image
image remove project
openstack image remove 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 to unshare (name or ID).
<project>
Project to disassociate with image (name or ID)
image save
Save an image locally
image save
openstack image save
--file <filename>
<image>--file <filename>
Downloaded image save filename (default: stdout)
Image to save (name or ID)
image set
Image v1, v2
Set image properties
image set
openstack image set
[--name <name>]
[--min-disk <disk-gb>]
[--min-ram <ram-mb>]
[--container-format <container-format>]
[--disk-format <disk-format>]
[--size <size>]
[--protected | --unprotected]
[--public | --private | --community | --shared]
[--store <store>]
[--location <image-url>]
[--copy-from <image-url>]
[--file <file>]
[--volume <volume>]
[--force]
[--checksum <checksum>]
[--stdin]
[--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]
<image>--name <name>
New image name
--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
--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, and ploop.
--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)
--community
Image is accessible to the community
--shared
Image can be shared
--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 option to set multiple properties)
2
--tag <tag>
Set a tag on this image (repeat option to set multiple tags)
2
--architecture <architecture>
Operating system architecture
2
--instance-id <instance-id>
ID of server instance used to create this image
2
--kernel-id <kernel-id>
ID of kernel image used to boot this disk image
2
--os-distro <os-distro>
Operating system distribution name
2
--os-version <os-version>
Operating system distribution version
2
--ramdisk-id <ramdisk-id>
ID of ramdisk image used to boot this disk image
2
--deactivate
Deactivate the image.
2
--activate
Activate the image.
2
--project <project>
Set an alternate project on this image (name or ID). Previously known as --owner.
--project-domain <project-domain>
Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.
2
--accept
Accept the image membership.
If --project is passed, this will update the membership status for the given project, otherwise --project will default to the project the user is authenticated to.
2
--reject
Reject the image membership.
If --project is passed, this will update the membership status for the given project, otherwise --project will default to the project the user is authenticated to.
2
--pending
Reset the image membership to 'pending'.
If --project is passed, this will update the membership status for the given project, otherwise --project will default to the project the user is authenticated to.
2
Image to modify (name or ID)
image show
Display image details
image show
openstack image show
[--human-readable]
<image>--human-readable
Print image size in a human-friendly format.
Image to display (name or ID)
image unset
Only supported for Image v2
Unset image tags or properties
image unset
openstack image unset
[--tag <tag>]
[--property <property-key>]
<image>--tag <tag>
Unset a tag on this image (repeat option to unset multiple tags)
--property <property-key>
Unset a property on this image (repeat option to unset multiple properties)
Image to modify (name or ID)