image v2¶
image add project¶
Associate project with image
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
¶
Image to share (name or ID)
-
project
¶
Project to associate with image (ID)
This command is provided by the python-openstackclient plugin.
image create¶
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]
[--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>
-
--id
<id>
¶ Image ID to reserve
-
--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
-
--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
-
--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)
-
--sign-key-path
<sign-key-path>
¶ Sign the image using the specified private key. Only use in combination with –sign-cert-id
-
--sign-cert-id
<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
-
--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
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)
-
--project
<project>
¶ Set an alternate project on this image (name or ID)
-
--import
¶
Force the use of glance image import instead of direct upload
-
--project-domain
<project-domain>
¶ Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.
-
image-name
¶
New image name
This command is provided by the python-openstackclient plugin.
image delete¶
Delete image(s)
openstack image delete <image> [<image> ...]
-
image
¶
Image(s) to delete (name or ID)
This command is provided by the python-openstackclient plugin.
image list¶
List available images
openstack image list
[--sort-column SORT_COLUMN]
[--public | --private | --community | --shared]
[--property <key=value>]
[--name <name>]
[--status <status>]
[--member-status <member-status>]
[--tag <tag>]
[--long]
[--sort <key>[:<direction>]]
[--limit <num-images>]
[--marker <image>]
-
--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
-
--public
¶
List only public images
-
--private
¶
List only private images
-
--community
¶
List only community images
List only shared images
-
--property
<key=value>
¶ Filter output based on property (repeat option to filter on multiple properties)
-
--name
<name>
¶ Filter images based on name.
-
--status
<status>
¶ Filter images based on status.
-
--member-status
<member-status>
¶ Filter images based on member status. The supported options are: accepted, pending, rejected, all.
-
--tag
<tag>
¶ Filter images based on tag.
-
--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.
-
--marker
<image>
¶ The last image of the previous page. Display list of images after marker. Display all images if not specified. (name or ID)
This command is provided by the python-openstackclient plugin.
image member list¶
List projects associated with image
openstack image member list
[--sort-column SORT_COLUMN]
[--project-domain <project-domain>]
<image>
-
--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
-
--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 (name or ID)
This command is provided by the python-openstackclient plugin.
image remove project¶
Disassociate project with image
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
¶
Image to unshare (name or ID)
-
project
¶
Project to disassociate with image (name or ID)
This command is provided by the python-openstackclient plugin.
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)
This command is provided by the python-openstackclient plugin.
image set¶
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]
<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, ploop
-
--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
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)
-
--architecture
<architecture>
¶ Operating system architecture
-
--instance-id
<instance-id>
¶ ID of server instance used to create this image
-
--kernel-id
<kernel-id>
¶ ID of kernel image used to boot this disk image
-
--os-distro
<os-distro>
¶ Operating system distribution name
-
--os-version
<os-version>
¶ Operating system distribution version
-
--ramdisk-id
<ramdisk-id>
¶ ID of ramdisk image used to boot this disk image
-
--deactivate
¶
Deactivate the image
-
--activate
¶
Activate the image
-
--project
<project>
¶ Set an alternate project on this image (name or ID)
-
--project-domain
<project-domain>
¶ Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.
-
--accept
¶
Accept the image membership
-
--reject
¶
Reject the image membership
-
--pending
¶
Reset the image membership to ‘pending’
-
image
¶
Image to modify (name or ID)
This command is provided by the python-openstackclient plugin.
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)
This command is provided by the python-openstackclient plugin.
image unset¶
Unset image tags and properties
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
¶
Image to modify (name or ID)
This command is provided by the python-openstackclient plugin.