.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GLANCE" "1" "Apr 04, 2024" "4.5.0" "python-glanceclient"
.SH NAME
glance \- Client for OpenStack Images API
.SH SYNOPSIS
.sp
\fBglance\fP [options] <command> [command\-options]
.sp
\fBglance help\fP
.sp
\fBglance help\fP <command>
.SH DESCRIPTION
.sp
The \fBglance\fP command line utility interacts with OpenStack Images
Service (Glance).
.sp
In order to use the CLI, you must provide your OpenStack username, password,
project (historically called tenant), and auth endpoint. You can use
configuration options \fB\-\-os\-username\fP, \fB\-\-os\-password\fP, \fB\-\-os\-project\-id\fP,
and \fB\-\-os\-auth\-url\fP or set corresponding environment variables:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
export OS_USERNAME=user
export OS_PASSWORD=pass
export OS_PROJECT_ID=b363706f891f48019483f8bd6503c54b
export OS_AUTH_URL=http://auth.example.com:5000/v2.0
.EE
.UNINDENT
.UNINDENT
.sp
The command line tool will attempt to reauthenticate using provided credentials
for every request. You can override this behavior by manually supplying an auth
token using \fB\-\-os\-image\-url\fP and \fB\-\-os\-auth\-token\fP or by setting
corresponding environment variables:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
export OS_IMAGE_URL=http://glance.example.org:9292/
export OS_AUTH_TOKEN=3bcc3d3a03f44e3d8377f9247b0ad155
.EE
.UNINDENT
.UNINDENT
.sp
You can select an API version to use by \fB\-\-os\-image\-api\-version\fP option or by
setting corresponding environment variable:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
export OS_IMAGE_API_VERSION=1
.EE
.UNINDENT
.UNINDENT
.sp
Default Images API used is v2.
.SH OPTIONS
.sp
To get a list of available commands and options run:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
glance help
.EE
.UNINDENT
.UNINDENT
.sp
To get usage and options of a command:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
glance help <command>
.EE
.UNINDENT
.UNINDENT
.SH EXAMPLES
.sp
Get information about image\-create command:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
glance help image\-create
.EE
.UNINDENT
.UNINDENT
.sp
See available images:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
glance image\-list
.EE
.UNINDENT
.UNINDENT
.sp
To get a verbose output including more fields in the image list response:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
glance \-\-verbose image\-list
.EE
.UNINDENT
.UNINDENT
.sp
Create new image:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
glance image\-create \-\-name foo \-\-disk\-format=qcow2 \e
                    \-\-container\-format=bare \-\-visibility=public \e
                    \-\-file /tmp/foo.img
.EE
.UNINDENT
.UNINDENT
.sp
Describe a specific image:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
glance image\-show <Image\-ID>
.EE
.UNINDENT
.UNINDENT
.SH BUGS
.sp
Glance client is hosted in Launchpad so you can view current bugs at
\fI\%https://bugs.launchpad.net/python\-glanceclient/\fP\&.
.SH AUTHOR
OpenStack Foundation
.SH COPYRIGHT
OpenStack Foundation
.\" Generated by docutils manpage writer.
.