ironic_python_agent.errors module

exception ironic_python_agent.errors.AgentIsBusy(command_name)[source]

Bases: ironic_python_agent.errors.CommandExecutionError

message = 'Agent is busy'
status_code = 409
exception ironic_python_agent.errors.BlockDeviceEraseError(details)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when an error occurs erasing a block device.

message = 'Error erasing block device'
exception ironic_python_agent.errors.BlockDeviceError(details)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when a block devices causes an unknown error.

message = 'Block device caused unknown error'
exception ironic_python_agent.errors.CleaningError(details=None)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when a cleaning step fails.

message = 'Clean step failed'
exception ironic_python_agent.errors.ClockSyncError(details=None, *args, **kwargs)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when attempting to sync the system clock.

message = 'Error syncing system clock'
exception ironic_python_agent.errors.CommandExecutionError(details)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when a command fails to execute.

message = 'Command execution failed'
exception ironic_python_agent.errors.DeploymentError(details=None)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when a deploy step fails.

message = 'Deploy step failed'
exception ironic_python_agent.errors.DeviceNotFound(details)[source]

Bases: ironic_python_agent.errors.NotFound

Error raised when the device to deploy the image onto is not found.

message = 'Error finding the disk or partition device to deploy the image onto'
exception ironic_python_agent.errors.ExtensionError(details=None, *args, **kwargs)[source]

Bases: ironic_python_agent.errors.RESTError

exception ironic_python_agent.errors.HardwareManagerMethodNotFound(method)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when all HardwareManagers fail to handle a method.

message = 'No HardwareManager found to handle method'
exception ironic_python_agent.errors.HardwareManagerNotFound(details=None)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when no valid HardwareManager can be found.

message = 'No valid HardwareManager found'
exception ironic_python_agent.errors.HeartbeatConflictError(details)[source]

Bases: ironic_python_agent.errors.IronicAPIError

ConflictError raised when a heartbeat to the agent API fails.

message = 'ConflictError heartbeating to agent API'
exception ironic_python_agent.errors.HeartbeatConnectionError(details)[source]

Bases: ironic_python_agent.errors.IronicAPIError

Transitory connection failure occured attempting to contact the API.

message = 'Error attempting to heartbeat - Possible transitory network failure or blocking port may be present.'
exception ironic_python_agent.errors.HeartbeatError(details)[source]

Bases: ironic_python_agent.errors.IronicAPIError

Error raised when a heartbeat to the agent API fails.

message = 'Error heartbeating to agent API'
exception ironic_python_agent.errors.ImageChecksumError(image_id, image_location, checksum, calculated_checksum)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when an image fails to verify against its checksum.

details_str = 'Image failed to verify against checksum. location: {}; image ID: {}; image checksum: {}; verification checksum: {}'
message = 'Error verifying image checksum'
exception ironic_python_agent.errors.ImageDownloadError(image_id, msg)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when an image cannot be downloaded.

message = 'Error downloading image'
exception ironic_python_agent.errors.ImageWriteError(device, exit_code, stdout, stderr)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when an image cannot be written to a device.

message = 'Error writing image to device'
exception ironic_python_agent.errors.IncompatibleHardwareMethodError(details=None)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when HardwareManager method incompatible with hardware.

message = 'HardwareManager method is not compatible with hardware'
exception ironic_python_agent.errors.IncompatibleNumaFormatError(details=None, *args, **kwargs)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when unexpected format data in NUMA node.

message = 'Error in NUMA node data format'
exception ironic_python_agent.errors.InspectionError[source]

Bases: Exception

Failure during inspection.

exception ironic_python_agent.errors.InvalidCommandError(details)[source]

Bases: ironic_python_agent.errors.InvalidContentError

Error which is raised when an unknown command is issued.

message = 'Invalid command'
exception ironic_python_agent.errors.InvalidCommandParamsError(details)[source]

Bases: ironic_python_agent.errors.InvalidContentError

Error which is raised when command parameters are invalid.

message = 'Invalid command parameters'
exception ironic_python_agent.errors.InvalidContentError(details)[source]

Bases: ironic_python_agent.errors.RESTError

Error which occurs when a user supplies invalid content.

Either because that content cannot be parsed according to the advertised Content-Type, or due to a content validation error.

message = 'Invalid request body'
status_code = 400
exception ironic_python_agent.errors.IronicAPIError(details)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when a call to the agent API fails.

message = 'Error in call to ironic-api'
exception ironic_python_agent.errors.LookupAgentIPError(details)[source]

Bases: ironic_python_agent.errors.IronicAPIError

Error raised when automatic IP lookup fails.

message = 'Error finding IP for Ironic Agent'
exception ironic_python_agent.errors.LookupNodeError(details)[source]

Bases: ironic_python_agent.errors.IronicAPIError

Error raised when the node lookup to the Ironic API fails.

message = 'Error getting configuration from Ironic'
exception ironic_python_agent.errors.NotFound(details=None, *args, **kwargs)[source]

Bases: ironic_python_agent.errors.RESTError

Error which occurs if a non-existent API endpoint is called.

details = 'The requested URL was not found.'
message = 'Not found'
status_code = 404
exception ironic_python_agent.errors.ProtectedDeviceError(device, what)[source]

Bases: ironic_python_agent.errors.CleaningError

Error raised when a cleaning is halted due to a protected device.

message = 'Protected device located, cleaning aborted.'
exception ironic_python_agent.errors.RESTError(details=None, *args, **kwargs)[source]

Bases: Exception, ironic_python_agent.encoding.Serializable

Base class for errors generated in ironic-python-client.

details = 'An unexpected error occurred. Please try back later.'
message = 'An error occurred'
serializable_fields = ('type', 'code', 'message', 'details')
status_code = 500
exception ironic_python_agent.errors.RequestedObjectNotFoundError(type_descr, obj_id)[source]

Bases: ironic_python_agent.errors.NotFound

exception ironic_python_agent.errors.SoftwareRAIDError(details)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when a Software RAID causes an error.

message = 'Software RAID caused unknown error'
exception ironic_python_agent.errors.SystemRebootError(exit_code, stdout, stderr)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when a system cannot reboot.

message = 'Error rebooting system'
exception ironic_python_agent.errors.UnknownNodeError(details=None)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when the agent is not associated with an Ironic node.

message = 'Agent is not associated with an Ironic node'
exception ironic_python_agent.errors.VersionMismatch(agent_version, node_version)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when Ironic and the Agent have different versions.

If the agent version has changed since get_clean_steps or get_deploy_steps was called by the Ironic conductor, it indicates the agent has been updated (either on purpose, or a new agent was deployed and the node was rebooted). Since we cannot know if the upgraded IPA will work with cleaning/deploy as it stands (steps could have different priorities, either in IPA or in other Ironic interfaces), we should restart the process from the start.

message = 'Hardware managers version mismatch, reload agent with correct version'
exception ironic_python_agent.errors.VirtualMediaBootError(details)[source]

Bases: ironic_python_agent.errors.RESTError

Error raised when virtual media device cannot be found for config.

message = 'Configuring agent from virtual media failed'