Chapter 42. image This chapter describes the commands under the image command. 42.1. image add project Associate project with image Usage: Table 42.1. Positional Arguments Value Summary <image> Image to share (name or id) <project> Project to associate with image (id) Table 42.2. Optional 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 Formatters 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 Table 42.4. JSON Formatter Value Summary --noindent Whether to disable indenting the json Table 42.5. Shell Formatter Value Summary --prefix PREFIX Add a prefix to all variable names Table 42.6. Table Formatter 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: Table 42.7. Positional Arguments Value Summary <image-name> New image name Table 42.8. Optional 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) --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) --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 Formatters 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 Table 42.10. JSON Formatter Value Summary --noindent Whether to disable indenting the json Table 42.11. Shell Formatter Value Summary --prefix PREFIX Add a prefix to all variable names Table 42.12. Table Formatter 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: Table 42.13. Positional Arguments Value Summary <image> Image(s) to delete (name or id) Table 42.14. Optional Arguments Value Summary -h, --help Show this help message and exit 42.4. image list List available images Usage: Table 42.15. Optional 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. --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 page. display list of images after marker. Display all images if not specified. (name or ID) Table 42.16. Output Formatters 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 --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 Table 42.17. CSV Formatter Value Summary --quote {all,minimal,none,nonnumeric} When to include quotes, defaults to nonnumeric Table 42.18. JSON Formatter Value Summary --noindent Whether to disable indenting the json Table 42.19. Table Formatter 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: Table 42.20. Positional Arguments Value Summary <image> Image (name or id) Table 42.21. Optional 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 Formatters 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 --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 Table 42.23. CSV Formatter Value Summary --quote {all,minimal,none,nonnumeric} When to include quotes, defaults to nonnumeric Table 42.24. JSON Formatter Value Summary --noindent Whether to disable indenting the json Table 42.25. Table Formatter 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: 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. Optional 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: Table 42.28. Positional Arguments Value Summary <image> Image to save (name or id) Table 42.29. Optional 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: Table 42.30. Positional Arguments Value Summary <image> Image to modify (name or id) Table 42.31. Optional 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: Table 42.32. Positional Arguments Value Summary <image> Image to display (name or id) Table 42.33. Optional 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 Formatters 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 Table 42.35. JSON Formatter Value Summary --noindent Whether to disable indenting the json Table 42.36. Shell Formatter Value Summary --prefix PREFIX Add a prefix to all variable names Table 42.37. Table Formatter 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: Table 42.38. Positional Arguments Value Summary <image> Image to modify (name or id) Table 42.39. Optional 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)

Commands:
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>
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] [--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>] [--project-domain <project-domain>] <image-name>
openstack image delete [-h] <image> [<image> ...]
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] [--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>]
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] [--project-domain <project-domain>] <image>
openstack image remove project [-h] [--project-domain <project-domain>] <image> <project>
openstack image save [-h] [--file <filename>] <image>
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>
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>
openstack image unset [-h] [--tag <tag>] [--property <property-key>] <image>