The cinderclient Python API

Usage

First create an instance of OpenStack with your credentials:

>>> from cinderclient import OpenStack
>>> cinder = OpenStack(USERNAME, PASSWORD, AUTH_URL)

Then call methods on the OpenStack object:

class cinderclient.OpenStack

backup_schedules

A BackupScheduleManager – manage automatic backup images.

flavors

A FlavorManager – query available “flavors” (hardware configurations).

images

An ImageManager – query and create server disk images.

ipgroups

A IPGroupManager – manage shared public IP addresses.

servers

A ServerManager – start, stop, and manage virtual machines.

For example:

>>> cinder.servers.list()
[<Server: buildslave-ubuntu-9.10>]

>>> cinder.flavors.list()
[<Flavor: 256 server>,
 <Flavor: 512 server>,
 <Flavor: 1GB server>,
 <Flavor: 2GB server>,
 <Flavor: 4GB server>,
 <Flavor: 8GB server>,
 <Flavor: 15.5GB server>]

>>> fl = cinder.flavors.find(ram=512)
>>> cinder.servers.create("my-server", flavor=fl)
<Server: my-server>

For more information, see the reference:

• API Reference
  • Backup schedules
  • Exceptions
  • Flavors
  • Images
  • Shared IP addresses
  • Servers