Exceptions¶

Common¶

exception netlab.errors.common.AccessDeniedError(message=None)¶: Caller did not have required privilege.

exception netlab.errors.common.AuthenticationError(message=None)¶: Connection to the NETLAB+ system could not be authenticated.

exception netlab.errors.common.DatesEndBeforeStartError(message=None)¶: End date is before start date.

exception netlab.errors.common.InvalidConfig¶: Config is not readable or contains errors.

exception netlab.errors.common.InvalidFilterError(message=None)¶: Filter is not a valid filter.

exception netlab.errors.common.InvalidFilterPropertyError(message=None)¶: Filter contains an invalid property or operator.

exception netlab.errors.common.InvalidParamError(message=None)¶: Parameter is in some way incorrect.

exception netlab.errors.common.InvalidParamsError(message=None)¶: Parameters are in some way incorrect.

exception netlab.errors.common.InvalidPropertiesError(message=None)¶: The properties requested could not be found.

exception netlab.errors.common.InvalidTimeError(message=None)¶: The time format provided does not match yyy-mm-dd-hh-ss.

exception netlab.errors.common.InvalidVersion¶: The remote API version is not compatible.

exception netlab.errors.common.ItemDependencyError(message=None)¶: The virtual machine is in use by a pod.

exception netlab.errors.common.LicenseNotActiveError(message=None)¶: Software license is not active.

exception netlab.errors.common.MethodNotFoundError(message=None)¶: The requested method could not be found.

exception netlab.errors.common.MissingParamError(message=None)¶: Parameter was missing.

exception netlab.errors.common.MissingParamsError(message=None)¶: Parameter was missing.

exception netlab.errors.common.NetlabError(message=None)¶: Base error from NETLAB+ api.

exception netlab.errors.common.ParamsNotSupported(message=None)¶: Some parameters were incorrect.

exception netlab.errors.common.ResponseFormatError¶: The server’s response was impossible to decode.

exception netlab.errors.common.TaskNotFoundError(message=None)¶: task_id is not found.

exception netlab.errors.common.UnmappedError(str_error, message)¶: An Error returned by the server but not handled by this library.

Classes¶

exception netlab.errors.klass.AccountNotInstructorError(message=None)¶: acc_id cannot be set to lead.

exception netlab.errors.klass.AlreadyMemberError(message=None)¶: acc_id is already a member of class.

exception netlab.errors.klass.AlreadyRegisteredError(message=None)¶: Content is already registered to class.

exception netlab.errors.klass.ClassNotFoundError(message=None)¶: Requested cls_id was not found.

exception netlab.errors.klass.NotMemberError(message=None)¶: acc_id is not on roster.

exception netlab.errors.klass.NotRegisteredError(message=None)¶: con_id not registered in class.

exception netlab.errors.klass.RemoveLastLeadError(message=None)¶: Returned more than one lead.

Labs¶

exception netlab.errors.lab.ContentNotFoundError(message=None)¶: con_id is not found.

exception netlab.errors.lab.ExerciseNotFoundError(message=None)¶: ex_id is not found.

Pods¶

exception netlab.errors.pod.ACLAdminNotFoundError(message=None)¶: Authorization for acc_id was not found for given pod_id.

exception netlab.errors.pod.AdminAlreadyAuthorizedError(message=None)¶: acc_id is already authorized for pod_id.

exception netlab.errors.pod.ClonePodNotFoundError(message=None)¶: The clone_pod_id is not found.

exception netlab.errors.pod.CloneRoleRequiredError(message=None)¶: The clone_role in pc_clone_specs is required.

exception netlab.errors.pod.CloneTypeRequiredError(message=None)¶: The clone_type in pc_clone_specs is required.

exception netlab.errors.pod.DuplicatePodACLError(message=None)¶: Pod ACL already exists.

exception netlab.errors.pod.DuplicatePodIDError(message=None)¶: pod_id already exists.

exception netlab.errors.pod.DuplicatePodNameError(message=None)¶: pod_name already exists.

exception netlab.errors.pod.HostNotFoundError(message=None)¶: The clone_hostname in pc_clone_specs is not found.

exception netlab.errors.pod.HostOrGroupRequiredError(message=None)¶: The clone_vh_id in pc_clone_specs is required.

exception netlab.errors.pod.InvalidCloneTypeError(message=None)¶: The clone_type in pc_clone_specs must be set to FULL or LINKED.

exception netlab.errors.pod.InvalidStorageAllocError(message=None)¶: The clone_storage_alloc in pc_clone_specs is not set to ONDEMAND or PREALLOCATED.

exception netlab.errors.pod.LabDevicesNotSupportedError(message=None)¶: Pod cloning does not support real equipment.

exception netlab.errors.pod.NoPCCloneSpecError(message=None)¶: The pc_clone_spec is invalid.

exception netlab.errors.pod.PCTypeNotSupportedError(message=None)¶: The pc_type in pc_clone_spec is not set to AVMI or NONE.

exception netlab.errors.pod.PodACLNotFoundError(message=None)¶: pacl_uuid was not found.

exception netlab.errors.pod.PodActiveError(message=None)¶: The pod_id is not currently OFFLINE or ONLINE.

exception netlab.errors.pod.PodBusyError(message=None)¶: Pod is currently busy performing another task.

exception netlab.errors.pod.PodEmptyError(message=None)¶: Pod has no devices or PCs.

exception netlab.errors.pod.PodIDMismatchError(message=None)¶: Given pod_id does not match pc_pod_id.

exception netlab.errors.pod.PodIDNotUniqueError(message=None)¶: The clone_pod_id is already in use.

exception netlab.errors.pod.PodInUseError(message=None)¶: Current pod is not OFFLINE.

exception netlab.errors.pod.PodIndexMismatchError(message=None)¶: Given pl_index does not match pc_pod_index.

exception netlab.errors.pod.PodMaxDeviceReachedError(message=None)¶: Max number of devices has been reached.

exception netlab.errors.pod.PodMaxLargeVLANReachedError(message=None)¶: Max number of pods with large VLANs (15) has been reached.

exception netlab.errors.pod.PodMaxSysReachedError(message=None)¶: Max number of pods on this system has been reached.

exception netlab.errors.pod.PodMaxTypeReachedError(message=None)¶: Max of this pod type has been installed.

exception netlab.errors.pod.PodNameNotUniqueError(message=None)¶: The clone_pod_name is already in use.

exception netlab.errors.pod.PodNotActiveError(message=None)¶: Pod/reservation is not in active lab state.

exception netlab.errors.pod.PodNotFoundError(message=None)¶: A pod could not be located from that request.

exception netlab.errors.pod.PodNotOnlineError(message=None)¶: Current pod is not OFFLINE.

exception netlab.errors.pod.PodNotSuspendedError(message=None)¶: Pod not in suspended state.

exception netlab.errors.pod.PodTypeIncompatibleError(message=None)¶: The pod type for the requested lab exercise is not the same as the reserved pod type.

exception netlab.errors.pod.PodTypeNotFoundError(message=None)¶: pt_id was not found.

exception netlab.errors.pod.SameVirtualMachineHostRequiredError(message=None)¶: The source_pod_id pod type requires all VMs to be pointing to same clone_vh_id in pc_clone_specs.

exception netlab.errors.pod.SnapshotRequiredForLinkedCloneError(message=None)¶: The source_snapshot in pc_clone_specs was not set correctly.

exception netlab.errors.pod.SourcePodNotFoundError(message=None)¶: The source_pod_id could not be found.

exception netlab.errors.pod.SourceVirtualMachineIDRequired(message=None)¶: The source_vm_id in pc_clone_specs is required.

exception netlab.errors.pod.SourceVirtualMachineNotFoundError(message=None)¶: The source_vm_id in pc_clone_specs is not found.

exception netlab.errors.pod.TemplateNotSupportedError(message=None)¶: clone_role in pc_clone_specs can not be set to TEMPLATE.

exception netlab.errors.pod.VirtualMachineInUseError(message=None)¶: vm_id is currently in use.

exception netlab.errors.pod.VirtualMachineNameInvalidError(message=None)¶: The clone_name in pc_clone_specs contains invalid characters.

exception netlab.errors.pod.VirtualMachineNameNotUniqueGlobalError(message=None)¶: The clone_name in pc_clone_specs is already in use.

exception netlab.errors.pod.VirtualMachineNameNotUniqueLocalError(message=None)¶: The clone_name in pc_clone_specs is already in use.

exception netlab.errors.pod.VirtualMachineNameRequiredError(message=None)¶: The clone_name in pc_clone_specs is required.

exception netlab.errors.pod.VirtualMachineNotAttachedError(message=None)¶: vm_id not attached.

Reservations¶

exception netlab.errors.reservation.AccessTypeError(message=None)¶: Account acc_id is not an instructor.

exception netlab.errors.reservation.ClassNoTeamMembersError(message=None)¶: There are no members in team.

exception netlab.errors.reservation.ClassNotMemberError(message=None)¶: acc_id is not part of cls_id.

exception netlab.errors.reservation.DateEndBeforeStartError(message=None)¶: The specified end_time is before start_time.

exception netlab.errors.reservation.DateEndNotSlotError(message=None)¶: The specified end_time must be on a time slot boundary.

exception netlab.errors.reservation.DateOutOfRangeError(message=None)¶: Reservation is outside of dates defined for the cls_id.

exception netlab.errors.reservation.PodNotAvailableError(message=None)¶: Pod is filtered out by pod assignment.

exception netlab.errors.reservation.ReservationActivePCMaxError(message=None)¶: This reservation exceeds the max active pc limit.

exception netlab.errors.reservation.ReservationActivePodMaxError(message=None)¶: This reservation exceeds the max active pod limit.

exception netlab.errors.reservation.ReservationCompletedError(message=None)¶: Reservation is already completed.

exception netlab.errors.reservation.ReservationConflictPodError(message=None)¶: This reservation conflicts with another reservation.

exception netlab.errors.reservation.ReservationNotActiveError(message=None)¶: res_id is not currently active.

exception netlab.errors.reservation.ReservationNotFoundError(message=None)¶: res_id is not found.

exception netlab.errors.reservation.ReservationPRAMaxCPUError(message=None)¶: This reservation exceeds the max number of CPUs for this host set by PRA.

exception netlab.errors.reservation.ReservationPRAMaxMemoryError(message=None)¶: This reservation exceeds the max amount of RAM for this host set by PRA.

exception netlab.errors.reservation.ReservationPRAMaxVirtualMachineError(message=None)¶: This reservation exceeds the max number of VMs for this host set by PRA.

exception netlab.errors.reservation.ReservationPodRulesError(message=None)¶: Pod rules do not alow this reservation.

exception netlab.errors.reservation.ReservationTimeInsufficientError(message=None)¶: Not enough time remaining to complete operation.

exception netlab.errors.reservation.ReservationTimeMTBRError(message=None)¶: The minimum time between reservations has not been exceeded.

exception netlab.errors.reservation.ReservationTimeTooLongError(message=None)¶: Reservation is longer than the max time allowed.

exception netlab.errors.reservation.ReservationTimeTooShortError(message=None)¶: The length of the reservation is too short.

exception netlab.errors.reservation.TimeEndPassedError(message=None)¶: The specified end_time has already passed.

Users¶

exception netlab.errors.user.AccountNotFoundError(message=None)¶: acc_id not found.

exception netlab.errors.user.ClassCommunityMismatchError(message=None)¶: cls_id exists but is not in com_id.

exception netlab.errors.user.ClassNotLeadError(message=None)¶: Requester acc_id must be a class lead.

exception netlab.errors.user.CommunityNotFoundError(message=None)¶: A pod could not be located from that request.

exception netlab.errors.user.DatabaseInsertFailedError(message=None)¶: Unable to insert record.

exception netlab.errors.user.DictionaryError(message=None)¶: Could not access the common word dictionary.

exception netlab.errors.user.InvalidSessionError(message=None)¶: acc_session_id is invalid.

exception netlab.errors.user.InvalidTransactionError(message=None)¶: TX number invalid.

exception netlab.errors.user.InvalidUserIdError(message=None)¶: user_id is invalid.

exception netlab.errors.user.LoginsDisabledSystemError(message=None)¶: Logins have been disabled globally on system.

exception netlab.errors.user.NameNotUniqueError(message=None)¶: acc_user_id already exists in the community.

exception netlab.errors.user.PasswordCommonError(message=None)¶: new_password is a common word.

exception netlab.errors.user.PasswordIsCurrentError(message=None)¶: new_password is the same as current password.

exception netlab.errors.user.PasswordIsEmailError(message=None)¶: new_password is the same as account email.

exception netlab.errors.user.PasswordIsFamilyNameError(message=None)¶: new_password is the same as account family name.

exception netlab.errors.user.PasswordIsFullNameError(message=None)¶: new_password is the same as account full name.

exception netlab.errors.user.PasswordIsGivenNameError(message=None)¶: new_password is the same as account given name.

exception netlab.errors.user.PasswordIsUserIdError(message=None)¶: new_password is the same as user id.

exception netlab.errors.user.PasswordLeadingWhitespaceError(message=None)¶: There is whitespace before new_password.

exception netlab.errors.user.PasswordRequiredError(message=None)¶: new_password is required.

exception netlab.errors.user.PasswordTooLongError(message=None)¶: new_password is > 64.

exception netlab.errors.user.PasswordTooShortError(message=None)¶: new_password is < 7.

exception netlab.errors.user.PasswordTrailingWhitespaceError(message=None)¶: There is whitespace after new_password.

exception netlab.errors.user.PasswordUniqueCharsError(message=None)¶: new_password requires at least 5 unique characters.

exception netlab.errors.user.SystemTerminatedError(message=None)¶: System was terminated by NDG.

exception netlab.errors.user.UserIdNotUniqueError(message=None)¶: This name is already in use.

exception netlab.errors.user.UserIdRequiredError(message=None)¶: user_id is required.

exception netlab.errors.user.UserIdReserveredError(message=None)¶: The following names are reserved for NDG and NETLAB+, administrator system techsupport

Virtual Machines¶

exception netlab.errors.vm.DataBaseUpdateFailedError(message=None)¶: Database error.

exception netlab.errors.vm.DatacenterMismatchError(message=None)¶: Host clone_vh_id is not in parent datacenter vdc_id.

exception netlab.errors.vm.InternalError(message=None)¶: VM pc_id not the same as inventory pc_id.

exception netlab.errors.vm.PCNotFoundError(message=None)¶: pc_id is not found.

exception netlab.errors.vm.VDCMONStopError(message=None)¶: Could not stop vdcmon for vdc_id.

exception netlab.errors.vm.ValueIsBlankError(message=None)¶: vdc_name can not be blank.

exception netlab.errors.vm.ValueNotWebsafeError(message=None)¶: vdc_name is not web safe.

exception netlab.errors.vm.ValueRequiredError(message=None)¶: vdc_name is required.

exception netlab.errors.vm.VirtualMachineDatacenterInvalidHostnameError(message=None)¶: vdc_agent_hostname is invalid.

exception netlab.errors.vm.VirtualMachineDatacenterInvalidTypeError(message=None)¶: vdt_type is invalid.

exception netlab.errors.vm.VirtualMachineDatacenterMismatchError(message=None)¶: vm_id and vh_id not in the same datacenter.

exception netlab.errors.vm.VirtualMachineDatacenterNotFoundError(message=None)¶: vdc_id not found.

netlab.errors.vm.VirtualMachineDatacenterNotFoundUnique¶: alias of netlab.errors.vm.VirtualMachineDatacenterNotUniqueError

exception netlab.errors.vm.VirtualMachineDatacenterNotUniqueError(message=None)¶: vdc_id not unique.

exception netlab.errors.vm.VirtualMachineHostGroupEmptyError(message=None)¶: clone_vhg_id is empty.

exception netlab.errors.vm.VirtualMachineHostGroupNotMemberError(message=None)¶: clone_vh_id is not a part of clone_vhg_id.

exception netlab.errors.vm.VirtualMachineHostInvalidNameError(message=None)¶: vh_name is invalid.

exception netlab.errors.vm.VirtualMachineHostNotFoundError(message=None)¶: vh_id not found.

exception netlab.errors.vm.VirtualMachineHostNotUniqueError(message=None)¶: vh_name is not unique.

exception netlab.errors.vm.VirtualMachineHostPortGroupNotFoundError(message=None)¶: Could not map portgroup.id to portgroup name. Portgroup does not exist on host.

exception netlab.errors.vm.VirtualMachineInvalidDeviceError(message=None)¶: Network adapter vnic does not exist on this vm.

exception netlab.errors.vm.VirtualMachineInvalidHostError(message=None)¶: Could not determine runtime host from virtual machine.

exception netlab.errors.vm.VirtualMachineInvalidPowerStateError(message=None)¶: If ok_if_on is not set, then VM was already powered on.

exception netlab.errors.vm.VirtualMachineInvalidStateError(message=None)¶: Virtual machine is not currently connected.

exception netlab.errors.vm.VirtualMachineIsPersistentError(message=None)¶: Virtual machine role is persistent.

exception netlab.errors.vm.VirtualMachineIsRuntimeError(message=None)¶: Virtual machine role is runtime.

exception netlab.errors.vm.VirtualMachineIsTemplateError(message=None)¶: Virtual machine role is a template.

exception netlab.errors.vm.VirtualMachineNotAVMI(message=None)¶: Virtual machine is a template.

exception netlab.errors.vm.VirtualMachineNotFoundError(message=None)¶: vm_id could not be found.

exception netlab.errors.vm.VirtualMachineNotUniqueError(message=None)¶: Duplicate vm_uuid in datacenter vdc_id.

exception netlab.errors.vm.VirtualMachineParentNotFoundError(message=None)¶: vm_parent_id is not found.

exception netlab.errors.vm.VirtualMachineShutdownTimeoutError(message=None)¶: The virtual machine did not shutdown within wait_seconds seconds.

exception netlab.errors.vm.VirtualMachineSnapshotCurrentNotFoundError(message=None)¶: Could not revert VM image to current snapshot, a current snapshot does not exist.

exception netlab.errors.vm.VirtualMachineSnapshotRequiredError(message=None)¶: snapshot_id or snapshot_name is required.

exception netlab.errors.vm.VirtualMachineToolsUnavailableError(message=None)¶: VMWare tools are unavailable.

exception netlab.errors.vm.VirtualMachineWrongHostError(message=None)¶: vm_id is powered up on incorrect host.