Block Store API

For details on how to use block_store, see Using OpenStack Block Store

The BlockStore Class

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

class openstack.block_store.v2._proxy.Proxy(session)
get_snapshot(snapshot)

Get a single snapshot

Parameters:snapshot – The value can be the ID of a snapshot or a Snapshot instance.
Returns:One Snapshot
Raises:ResourceNotFound when no resource can be found.
create_snapshot(**attrs)

Create a new snapshot from attributes

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

Delete a snapshot

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

None

get_type(type)

Get a single type

Parameters:type – The value can be the ID of a type or a Type instance.
Returns:One Type
Raises:ResourceNotFound when no resource can be found.
create_type(**attrs)

Create a new type from attributes

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

Delete a type

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

None

get_volume(volume)

Get a single volume

Parameters:volume – The value can be the ID of a volume or a Volume instance.
Returns:One Volume
Raises:ResourceNotFound when no resource can be found.
create_volume(**attrs)

Create a new volume from attributes

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

Delete a volume

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

None