ironic.objects.portgroup module

ironic.objects.portgroup module

service None

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

Portgroup.create(context=None)

Create a Portgroup 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.: Portgroup(context)
Raises:DuplicateName, MACAlreadyExists, PortgroupAlreadyExists
Portgroup.destroy(context=None)

Delete the Portgroup 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.: Portgroup(context)
Raises:PortgroupNotEmpty, PortgroupNotFound
classmethod Portgroup.get(context, portgroup_ident)

Find a portgroup based on its id, uuid, name or address.

Parameters:
  • portgroup_ident – The id, uuid, name or address of a portgroup.
  • context – Security context
Returns:

A Portgroup object.

Raises:

InvalidIdentity

classmethod Portgroup.get_by_address(context, address)

Find portgroup by address and return a Portgroup object.

Parameters:
  • cls – the Portgroup
  • context – Security context
  • address – The MAC address of a portgroup.
Returns:

A Portgroup object.

Raises:

PortgroupNotFound

classmethod Portgroup.get_by_id(context, portgroup_id)

Find a portgroup by its integer ID and return a Portgroup object.

Parameters:
  • cls – the Portgroup
  • context – Security context
  • portgroup_id – The ID of a portgroup.
Returns:

A Portgroup object.

Raises:

PortgroupNotFound

classmethod Portgroup.get_by_name(context, name)

Find portgroup based on name and return a Portgroup object.

Parameters:
  • cls – the Portgroup
  • context – Security context
  • name – The name of a portgroup.
Returns:

A Portgroup object.

Raises:

PortgroupNotFound

classmethod Portgroup.get_by_uuid(context, uuid)

Find a portgroup by UUID and return a Portgroup object.

Parameters:
  • cls – the Portgroup
  • context – Security context
  • uuid – The UUID of a portgroup.
Returns:

A Portgroup object.

Raises:

PortgroupNotFound

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

Return a list of Portgroup objects.

Parameters:
  • cls – the Portgroup
  • 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 Portgroup object.

Raises:

InvalidParameterValue

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

Return a list of Portgroup objects associated with a given node ID.

Parameters:
  • cls – the Portgroup
  • context – Security context.
  • node_id – The 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 Portgroup object.

Raises:

InvalidParameterValue

Portgroup.refresh(context=None)

Loads updates for this Portgroup.

Loads a portgroup with the same uuid from the database and checks for updated attributes. Updates are applied from the loaded portgroup column by column, if there are any updates.

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.: Portgroup(context)
Raises:PortgroupNotFound
Portgroup.save(context=None)

Save updates to this Portgroup.

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

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.: Portgroup(context)
Raises:PortgroupNotFound, DuplicateName, MACAlreadyExists
service None

Bases: ironic.objects.notification.NotificationBase

Notification when ironic creates, updates or deletes a portgroup.

service None

Bases: ironic.objects.notification.NotificationPayloadBase

Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.