The :mod:`novaclient` Python API ================================== .. module:: novaclient :synopsis: A client for the OpenStack Nova API. .. currentmodule:: novaclient Usage ----- First create a client instance with your credentials:: >>> from novaclient.client import Client >>> nova = Client(VERSION, USERNAME, PASSWORD, PROJECT_ID, AUTH_URL) Here ``VERSION`` can be: ``1.1``, ``2`` and ``3``. Alternatively, you can create a client instance using the keystoneclient session API:: >>> from keystoneclient.auth.identity import v2 >>> from keystoneclient import session >>> from novaclient.client import Client >>> auth = v2.Password(auth_url=AUTH_URL, username=USERNAME, password=PASSWORD, tenant_name=PROJECT_ID) >>> sess = session.Session(auth=auth) >>> nova = client.Client(VERSION, session=sess) For more information on this keystoneclient API, see `Using Sessions`_. .. _Using Sessions: http://docs.openstack.org/developer/python-keystoneclient/using-sessions.html Then call methods on its managers:: >>> nova.servers.list() [] >>> nova.flavors.list() [, , , , , , ] >>> fl = nova.flavors.find(ram=512) >>> nova.servers.create("my-server", flavor=fl) Reference --------- For more information, see the reference: .. toctree:: :maxdepth: 2 ref/index ref/v1_1/index ref/v3/index