Chapter 42. image

42.1. image add project

Associate project with image

Usage:

openstack image add project [-h] [-f {json,shell,table,value,yaml}]
                                   [-c COLUMN] [--noindent] [--prefix PREFIX]
                                   [--max-width <integer>] [--fit-width]
                                   [--print-empty]
                                   [--project-domain <project-domain>]
                                   <image> <project>

Table 42.1. Positional arguments
Value	Summary
<image>	Image to share (name or id)
<project>	Project to associate with image (id)

Table 42.2. Command arguments
Value	Summary
-h, --help	Show this help message and exit
--project-domain <project-domain>	Domain the project belongs to (name or id). this can be used in case collisions between project names exist.

Table 42.3. Output formatter options
Value	Summary
-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}	The output format, defaults to table
-c COLUMN, --column COLUMN	Specify the column(s) to include, can be repeated to show multiple columns

Table 42.4. JSON formatter options
Value	Summary
--noindent	Whether to disable indenting the json

Table 42.5. Shell formatter options
Value	Summary
--prefix PREFIX	Add a prefix to all variable names

Table 42.6. Table formatter options
Value	Summary
--max-width <integer>	Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
--fit-width	Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
--print-empty	Print empty table if there is no data to show.

42.2. image create

Create/upload an image

Usage:

openstack image create [-h] [-f {json,shell,table,value,yaml}]
                              [-c COLUMN] [--noindent] [--prefix PREFIX]
                              [--max-width <integer>] [--fit-width]
                              [--print-empty] [--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>

Table 42.7. Positional arguments
Value	Summary
<image-name>	New image name

Table 42.8. Command arguments
Value	Summary
-h, --help	Show this help message and exit
--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)
--progress	Show upload progress bar.
--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
--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)
--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.

Table 42.9. Output formatter options
Value	Summary
-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}	The output format, defaults to table
-c COLUMN, --column COLUMN	Specify the column(s) to include, can be repeated to show multiple columns

Table 42.10. JSON formatter options
Value	Summary
--noindent	Whether to disable indenting the json

Table 42.11. Shell formatter options
Value	Summary
--prefix PREFIX	Add a prefix to all variable names

Table 42.12. Table formatter options
Value	Summary
--max-width <integer>	Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
--fit-width	Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
--print-empty	Print empty table if there is no data to show.

42.3. image delete

Delete image(s)

Usage:

openstack image delete [-h] <image> [<image> ...]

Table 42.13. Positional arguments
Value	Summary
<image>	Image(s) to delete (name or id)

Table 42.14. Command arguments
Value	Summary
-h, --help	Show this help message and exit

42.4. image list

List available images

Usage:

openstack image list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
                            [--quote {all,minimal,none,nonnumeric}]
                            [--noindent] [--max-width <integer>] [--fit-width]
                            [--print-empty] [--sort-column SORT_COLUMN]
                            [--sort-ascending | --sort-descending]
                            [--public | --private | --community | --shared]
                            [--property <key=value>] [--name <name>]
                            [--status <status>]
                            [--member-status <member-status>]
                            [--project <project>]
                            [--project-domain <project-domain>] [--tag <tag>]
                            [--long] [--sort <key>[:<direction>]]
                            [--limit <num-images>] [--marker <image>]

Table 42.15. Command arguments
Value	Summary
-h, --help	Show this help message and exit
--public	List only public images
--private	List only private images
--community	List only community images
--shared	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.
--project <project>	Search by project (admin only) (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.
--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)

Table 42.16. Output formatter options
Value	Summary
-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}	The output format, defaults to table
-c COLUMN, --column COLUMN	Specify the column(s) to include, can be repeated to show multiple columns
--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

Table 42.17. CSV formatter options
Value	Summary
--quote {all,minimal,none,nonnumeric}	When to include quotes, defaults to nonnumeric

Table 42.18. JSON formatter options
Value	Summary
--noindent	Whether to disable indenting the json

Table 42.19. Table formatter options
Value	Summary
--max-width <integer>	Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
--fit-width	Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
--print-empty	Print empty table if there is no data to show.

42.5. image member list

List projects associated with image

Usage:

openstack image member list [-h] [-f {csv,json,table,value,yaml}]
                                   [-c COLUMN]
                                   [--quote {all,minimal,none,nonnumeric}]
                                   [--noindent] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--sort-column SORT_COLUMN]
                                   [--sort-ascending | --sort-descending]
                                   [--project-domain <project-domain>]
                                   <image>

Table 42.20. Positional arguments
Value	Summary
<image>	Image (name or id)

Table 42.21. Command arguments
Value	Summary
-h, --help	Show this help message and exit
--project-domain <project-domain>	Domain the project belongs to (name or id). this can be used in case collisions between project names exist.

Table 42.22. Output formatter options
Value	Summary
-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}	The output format, defaults to table
-c COLUMN, --column COLUMN	Specify the column(s) to include, can be repeated to show multiple columns
--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

Table 42.23. CSV formatter options
Value	Summary
--quote {all,minimal,none,nonnumeric}	When to include quotes, defaults to nonnumeric

Table 42.24. JSON formatter options
Value	Summary
--noindent	Whether to disable indenting the json

Table 42.25. Table formatter options
Value	Summary
--max-width <integer>	Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
--fit-width	Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
--print-empty	Print empty table if there is no data to show.

42.6. image remove project

Disassociate project with image

Usage:

openstack image remove project [-h] [--project-domain <project-domain>]
                                      <image> <project>

Table 42.26. Positional arguments
Value	Summary
<image>	Image to unshare (name or id)
<project>	Project to disassociate with image (name or id)

Table 42.27. Command arguments
Value	Summary
-h, --help	Show this help message and exit
--project-domain <project-domain>	Domain the project belongs to (name or id). this can be used in case collisions between project names exist.

42.7. image save

Save an image locally

Usage:

openstack image save [-h] [--file <filename>] <image>

Table 42.28. Positional arguments
Value	Summary
<image>	Image to save (name or id)

Table 42.29. Command arguments
Value	Summary
-h, --help	Show this help message and exit
--file <filename>	Downloaded image save filename (default: stdout)

42.8. image set

Set image properties

Usage:

openstack image set [-h] [--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>

Table 42.30. Positional arguments
Value	Summary
<image>	Image to modify (name or id)

Table 42.31. Command arguments
Value	Summary
-h, --help	Show this help message and exit
--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
--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)
--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

42.9. image show

Display image details

Usage:

openstack image show [-h] [-f {json,shell,table,value,yaml}]
                            [-c COLUMN] [--noindent] [--prefix PREFIX]
                            [--max-width <integer>] [--fit-width]
                            [--print-empty] [--human-readable]
                            <image>

Table 42.32. Positional arguments
Value	Summary
<image>	Image to display (name or id)

Table 42.33. Command arguments
Value	Summary
-h, --help	Show this help message and exit
--human-readable	Print image size in a human-friendly format.

Table 42.34. Output formatter options
Value	Summary
-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}	The output format, defaults to table
-c COLUMN, --column COLUMN	Specify the column(s) to include, can be repeated to show multiple columns

Table 42.35. JSON formatter options
Value	Summary
--noindent	Whether to disable indenting the json

Table 42.36. Shell formatter options
Value	Summary
--prefix PREFIX	Add a prefix to all variable names

Table 42.37. Table formatter options
Value	Summary
--max-width <integer>	Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
--fit-width	Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
--print-empty	Print empty table if there is no data to show.

42.10. image unset

Unset image tags and properties

Usage:

openstack image unset [-h] [--tag <tag>] [--property <property-key>]
                             <image>

Table 42.38. Positional arguments
Value	Summary
<image>	Image to modify (name or id)

Table 42.39. Command arguments
Value	Summary
-h, --help	Show this help message and exit
--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)

Ce contenu n'est pas disponible dans la langue sélectionnée.

42.1. image add project

42.2. image create

42.3. image delete

42.4. image list

42.5. image member list

42.6. image remove project

42.7. image save

42.8. image set

42.9. image show

42.10. image unset

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Rendre l’open source plus inclusif

À propos de Red Hat

Red Hat legal and privacy links

Red Hat legal and privacy links