ironic.objects.volume_target module¶

service None

Bases: ironic.objects.base.IronicObject, oslo_versionedobjects.base.VersionedObjectDictCompat

VolumeTarget.create(context=None)¶

Create a VolumeTarget record in the DB.

Parameters:	context – security context. NOTE: This should only be used internally by the indirection_api. Unfortunately, RPC requires context as the first argument, even though we don’t use it. A context should be set when instantiating the object, e.g.: VolumeTarget(context).
Raises:	VolumeTargetBootIndexAlreadyExists if a volume target already exists with the same node ID and boot index
Raises:	VolumeTargetAlreadyExists if a volume target with the same UUID exists

VolumeTarget.destroy(context=None)¶

Delete the VolumeTarget from the DB.

Parameters:	context – security context. NOTE: This should only be used internally by the indirection_api. Unfortunately, RPC requires context as the first argument, even though we don’t use it. A context should be set when instantiating the object, e.g.: VolumeTarget(context).
Raises:	VolumeTargetNotFound if the volume target cannot be found

classmethod VolumeTarget.get(context, ident)¶

Find a volume target based on its ID or UUID.

Parameters:	context – security context ident – the database primary key ID or the UUID of a volume target
Returns:	a VolumeTarget object
Raises:	InvalidIdentity if ident is neither an integer ID nor a UUID
Raises:	VolumeTargetNotFound if no volume target with this ident exists

classmethod VolumeTarget.get_by_id(context, db_id)¶

Find a volume target based on its database ID.

Parameters:	cls – the VolumeTarget context – security context db_id – the database primary key (integer) ID of a volume target
Returns:	a VolumeTarget object
Raises:	VolumeTargetNotFound if no volume target with this ID exists

classmethod VolumeTarget.get_by_uuid(context, uuid)¶

Find a volume target based on its UUID.

Parameters:	cls – the VolumeTarget context – security context uuid – the UUID of a volume target
Returns:	a VolumeTarget object
Raises:	VolumeTargetNotFound if no volume target with this UUID exists

classmethod VolumeTarget.list(context, limit=None, marker=None, sort_key=None, sort_dir=None)¶

Return a list of VolumeTarget objects.

Parameters:	context – security context limit – maximum number of resources to return in a single result marker – pagination marker for large data sets sort_key – column to sort results by sort_dir – direction to sort. “asc” or “desc”.
Returns:	a list of VolumeTarget objects
Raises:	InvalidParameterValue if sort_key does not exist

classmethod VolumeTarget.list_by_node_id(context, node_id, limit=None, marker=None, sort_key=None, sort_dir=None)¶

Return a list of VolumeTarget objects related to a given node ID.

Parameters:	context – security context node_id – the integer ID of the node limit – maximum number of resources to return in a single result marker – pagination marker for large data sets sort_key – column to sort results by sort_dir – direction to sort. “asc” or “desc”.
Returns:	a list of VolumeTarget objects
Raises:	InvalidParameterValue if sort_key does not exist

classmethod VolumeTarget.list_by_volume_id(context, volume_id, limit=None, marker=None, sort_key=None, sort_dir=None)¶

Return a list of VolumeTarget objects related to a given volume ID.

Parameters:	context – security context volume_id – the UUID of the volume limit – maximum number of volume targets to return in a single result marker – pagination marker for large data sets sort_key – column to sort results by sort_dir – direction to sort. “asc” or “desc”.
Returns:	a list of VolumeTarget objects
Raises:	InvalidParameterValue if sort_key does not exist

VolumeTarget.refresh(context=None)¶

Loads updates for this VolumeTarget.

Load a volume target with the same UUID from the database and check for updated attributes. If there are any updates, they are applied from the loaded volume target, column by column.

Parameters:	context – security context. NOTE: This should only be used internally by the indirection_api. Unfortunately, RPC requires context as the first argument, even though we don’t use it. A context should be set when instantiating the object, e.g.: VolumeTarget(context).
Raises:	VolumeTargetNotFound if the volume target cannot be found

VolumeTarget.save(context=None)¶

Save updates to this VolumeTarget.

Updates will be made column by column based on the result of self.do_version_changes_for_db().

Parameters:	context – security context. NOTE: This should only be used internally by the indirection_api. Unfortunately, RPC requires context as the first argument, even though we don’t use it. A context should be set when instantiating the object, e.g.: VolumeTarget(context).
Raises:	InvalidParameterValue if the UUID is being changed
Raises:	VolumeTargetBootIndexAlreadyExists if a volume target already exists with the same node ID and boot index values
Raises:	VolumeTargetNotFound if the volume target cannot be found

service None

Bases: ironic.objects.notification.NotificationBase

Notification emitted at CRUD of a volume target.

service None

Bases: ironic.objects.notification.NotificationPayloadBase