GLANCE(1)

📦
version 4.13.0 · 12 versions
, in ubuntu stonking

💖 glance(1) — the manual, but make it a group chat 💖

okay bestie, welcome to the glance era 💅 this is the manual page for python-glanceclient, and I'm gonna walk you through it like we're texting at 2am. no gatekeeping, no cap. 🫶

✨ NAME ✨

glance — it's the client for the OpenStack Images API. that's the whole vibe. 🦋

🌸 SYNOPSIS 🌸

glance [options] <command> [command-options]
glance help
glance help <command>

like… that's it. that's the shape of it. <command> is the main character, [options] is the supporting cast, and [command-options] shows up when it feels like it. 👑

🎀 DESCRIPTION 🎀

so the glance command line utility talks to the OpenStack Images Service (aka Glance). that's the job. that's the assignment, and it ate. 💜

but listen — to even use the CLI you have to give it your OpenStack username, password, project (which, yes, historically was called "tenant" — vintage behavior, we respect it 🙈), and your auth endpoint. no credentials, no vibes. 😭

you can do that with the config options --os-username, --os-password, --os-project-id, and --os-auth-url — OR you set the matching environment variables, which is lowkey the cuter option:

export OS_USERNAME=user
export OS_PASSWORD=pass
export OS_PROJECT_ID=b363706f891f48019483f8bd6503c54b
export OS_AUTH_URL=http://auth.example.com:5000/v2.0
ngl, hardcoding pass as your password is not it. do not do this in prod. 🙈

the command line tool will try to reauthenticate using the credentials you gave it for every single request. every one. it's committed. it's loyal. 🫶

you can override that behavior by manually supplying an auth token with --os-image-url and --os-auth-token, or by setting the corresponding environment variables instead:

export OS_IMAGE_URL=http://glance.example.org:9292/
export OS_AUTH_TOKEN=3bcc3d3a03f44e3d8377f9247b0ad155

and to pick which API version you're using, it's the --os-image-api-version option, or the matching environment variable:

export OS_IMAGE_API_VERSION=1

the default Images API is v2. say it with me. v2. periodt. ✨

✨ OPTIONS ✨

to see a list of all the available commands and options, run:

glance help

and to get the usage and options for one specific command:

glance help <command>

like, that's your map, bestie. use it. 🗺️💖

🔥 EXAMPLES 🔥

get the tea on the image-create command:

glance help image-create

see all the available images (vibe check, but for images):

glance image-list

want a verbose output with more fields in the image list response? say less:

glance --verbose image-list

create a new image, main character behavior:

glance image-create --name foo --disk-format=qcow2 \
                    --container-format=bare --visibility=public \
                    --file /tmp/foo.img

and to describe one specific image:

glance image-show <Image-ID>

Look at those backslashes. Continuation lines. She's organized. She's got a plan. 💅

💀 BUGS 💀

found a bug? it's not me, it's definitely not you, it's a bug 🐛 the Glance client is hosted on Launchpad, so you can view the current bugs at:

https://bugs.launchpad.net/python-glanceclient/

go forth, report, slay. 🔥

🫶 Author 🫶

OpenStack Foundation

OpenStack Foundation

okay that's the whole page bestie, you're officially certified 📜✨ this was python-glanceclient version 4.13.0, dated Sep 10, 2026, and it's been real. now go glance help something and make me proud. 💖🦋🌸 mwah. 🎀

📦 where this page comes from