Database API

For details on how to use database, see Using OpenStack Database

The Database Class

The database high-level interface is available through the database member of a Connection object. The database member will only be added if the service is detected.

class openstack.database.v1._proxy.Proxy(session)
create_database(**attrs)

Create a new database from attributes

Parameters:attrs (dict) – Keyword arguments which will be used to create a Database, comprised of the properties on the Database class.
Returns:The results of server creation
Return type:Database
delete_database(database, ignore_missing=True)

Delete a database

Parameters:
  • database – The value can be either the ID of a database or a Database instance.
  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the database does not exist. When set to True, no exception will be set when attempting to delete a nonexistent database.
Returns:

None

find_database(name_or_id, ignore_missing=True)

Find a single database

Parameters:
  • name_or_id – The name or ID of a database.
  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the resource does not exist. When set to True, None will be returned when attempting to find a nonexistent resource.
Returns:

One Database or None

databases(**query)

Return a generator of databases

Parameters:**query (kwargs) – Optional query parameters to be sent to limit the resources being returned.
Returns:A generator of database objects
Return type:Database
get_database(database)

Get a single database

Parameters:database – The value can be the ID of a database or a Database instance.
Returns:One Database
Raises:ResourceNotFound when no resource can be found.
find_flavor(name_or_id, ignore_missing=True)

Find a single flavor

Parameters:
  • name_or_id – The name or ID of a flavor.
  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the resource does not exist. When set to True, None will be returned when attempting to find a nonexistent resource.
Returns:

One Flavor or None

get_flavor(flavor)

Get a single flavor

Parameters:flavor – The value can be the ID of a flavor or a Flavor instance.
Returns:One Flavor
Raises:ResourceNotFound when no resource can be found.
flavors(**query)

Return a generator of flavors

Parameters:**query (kwargs) – Optional query parameters to be sent to limit the resources being returned.
Returns:A generator of flavor objects
Return type:Flavor
create_instance(**attrs)

Create a new instance from attributes

Parameters:attrs (dict) – Keyword arguments which will be used to create a Instance, comprised of the properties on the Instance class.
Returns:The results of server creation
Return type:Instance
delete_instance(instance, ignore_missing=True)

Delete an instance

Parameters:
  • instance – The value can be either the ID of an instance or a Instance instance.
  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the instance does not exist. When set to True, no exception will be set when attempting to delete a nonexistent instance.
Returns:

None

find_instance(name_or_id, ignore_missing=True)

Find a single instance

Parameters:
  • name_or_id – The name or ID of a instance.
  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the resource does not exist. When set to True, None will be returned when attempting to find a nonexistent resource.
Returns:

One Instance or None

get_instance(instance)

Get a single instance

Parameters:instance – The value can be the ID of an instance or a Instance instance.
Returns:One Instance
Raises:ResourceNotFound when no resource can be found.
instances(**query)

Return a generator of instances

Parameters:**query (kwargs) – Optional query parameters to be sent to limit the resources being returned.
Returns:A generator of instance objects
Return type:Instance
update_instance(instance, **attrs)

Update a instance

Parameters:instance – Either the id of a instance or a Instance instance.
Attrs kwargs:The attributes to update on the instance represented by value.
Returns:The updated instance
Return type:Instance
create_user(**attrs)

Create a new user from attributes

Parameters:attrs (dict) – Keyword arguments which will be used to create a User, comprised of the properties on the User class.
Returns:The results of server creation
Return type:User
delete_user(user, ignore_missing=True)

Delete a user

Parameters:
  • user – The value can be either the ID of a user or a User instance.
  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the user does not exist. When set to True, no exception will be set when attempting to delete a nonexistent user.
Returns:

None

find_user(name_or_id, ignore_missing=True)

Find a single user

Parameters:
  • name_or_id – The name or ID of a user.
  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the resource does not exist. When set to True, None will be returned when attempting to find a nonexistent resource.
Returns:

One User or None

users(**query)

Return a generator of users

Parameters:**query (kwargs) – Optional query parameters to be sent to limit the resources being returned.
Returns:A generator of user objects
Return type:User
get_user(user)

Get a single user

Parameters:user – The value can be the ID of a user or a User instance.
Returns:One User
Raises:ResourceNotFound when no resource can be found.