Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Glance Client Package and CLI Tool
Python Shell
branch: master

Merge pull request #1 from emonty/master

Updated support files to latest
latest commit b5847df3e2
@jaypipes authored
Failed to load latest commit information.
glanceclient All the latest OpenStack hotness.
tools All the latest OpenStack hotness.
.gitignore All the latest OpenStack hotness.
AUTHORS All the latest OpenStack hotness.
HACKING.rst Initial checkin for new CLI and client package
LICENSE Initial checkin for new CLI and client package Initial checkin for new CLI and client package
README.rst Initial checkin for new CLI and client package
openstack-common.conf All the latest OpenStack hotness. All the latest OpenStack hotness.
setup.cfg All the latest OpenStack hotness.
tox.ini All the latest OpenStack hotness.


Python bindings to the OpenStack Glance API

This is a client for the OpenStack Glance API. There's a Python API (the glanceclient module), and a command-line script (glance). The Glance 2.0 API is still a moving target, so this module will remain in "Beta" status until the API is finalized and fully implemented.

Development takes place via the usual OpenStack processes as outlined in the `OpenStack wiki`_. The master repository is on GitHub__.

This code a fork of `Rackspace's python-novaclient`__ which is in turn a fork of `Jacobian's python-cloudservers`__. The python-glanceclient is licensed under the Apache License like the rest of OpenStack.

Python API

By way of a quick-start:

# use v2.0 auth with")
>>> from glanceclient.v2_0 import client
>>> glance = client.Client(username=USERNAME, password=PASSWORD, tenant_name=TENANT, auth_url=KEYSTONE_URL)
>>> glance.images.list()
>>> image = glance.images.create(name="My Test Image")
>>> print image.status
>>> image.upload(open('/tmp/myimage.iso', 'rb'))
>>> print image.status
>>> image_file = image.image_file
>>> with open('/tmp/copyimage.iso', 'wb') as f:
        for chunk in image_file:
>>> image.delete()

Command-line API

Installing this package gets you a command-line tool, glance, that you can use to interact with Glance's Identity API.

You'll need to provide your OpenStack tenant, username and password. You can do this with the tenant_name, --username and --password params, but it's easier to just set them as environment variables:

export OS_TENANT_NAME=project
export OS_USERNAME=user
export OS_PASSWORD=pass

You will also need to define the authentication url with --auth_url and the version of the API with --identity_api_version. Or set them as an environment variables as well:

export OS_AUTH_URL=

Since the Identity service that Glance uses can return multiple regional image endpoints in the Service Catalog, you can specify the one you want with --region_name (or export OS_REGION_NAME). It defaults to the first in the list returned.

You'll find complete documentation on the shell by running glance help:

usage: glance [--username USERNAME] [--password PASSWORD]
              [--tenant_name TENANT_NAME | --tenant_id TENANT_ID]
              [--auth_url AUTH_URL] [--region_name REGION_NAME]
              [--identity_api_version IDENTITY_API_VERSION]
              <subcommand> ...

Command-line interface to the OpenStack Identity API.

Positional arguments:
    catalog             List all image services in service catalog
    image-create        Create new image
    image-delete        Delete image
    image-list          List images
    image-update        Update image's name and other properties
    image-upload        Upload an image file
    image-download      Download an image file
    help                Display help about this program or one of its

Optional arguments:
  --username USERNAME   Defaults to env[OS_USERNAME]
  --password PASSWORD   Defaults to env[OS_PASSWORD]
  --tenant_name TENANT_NAME
                        Defaults to env[OS_TENANT_NAME]
  --tenant_id TENANT_ID
                        Defaults to env[OS_TENANT_ID]
  --auth_url AUTH_URL   Defaults to env[OS_AUTH_URL]
  --region_name REGION_NAME
                        Defaults to env[OS_REGION_NAME]
  --identity_api_version IDENTITY_API_VERSION
                        Defaults to env[OS_IDENTITY_API_VERSION] or 2.0

See "glance help COMMAND" for help on a specific command.

Something went wrong with that request. Please try again.