Managers#

class ManagerStatusEnum(value)[source]#

Bases: str, Enum

The state of a Queue Manager. The states which are available are a finite set.

active = 'active'#
inactive = 'inactive'#
class ManagerName(*, cluster, hostname, uuid)[source]#

Bases: BaseModel

Create a new model by parsing and validating input data from keyword arguments.

Raises ValidationError if the input data cannot be parsed to form a valid model.

Parameters:
  • cluster (str)

  • hostname (str)

  • uuid (str)

class Config[source]#

Bases: object

extra = 'forbid'#
cluster: str#
hostname: str#
uuid: str#
property fullname#
class ComputeManager(*, id, name, cluster, hostname, username=None, compute_tags, claimed, successes, failures, rejected, total_cpu_hours, active_tasks, active_cores, active_memory, status, created_on, modified_on, manager_version, programs)[source]#

Bases: BaseModel

Create a new model by parsing and validating input data from keyword arguments.

Raises ValidationError if the input data cannot be parsed to form a valid model.

Parameters:
  • id (int)

  • name (str)

  • cluster (str)

  • hostname (str)

  • username (str | None)

  • compute_tags (List[str])

  • claimed (int)

  • successes (int)

  • failures (int)

  • rejected (int)

  • total_cpu_hours (float)

  • active_tasks (int)

  • active_cores (int)

  • active_memory (float)

  • status (ManagerStatusEnum)

  • created_on (datetime)

  • modified_on (datetime)

  • manager_version (str)

  • programs (Dict[str, List[str]])

class Config[source]#

Bases: object

extra = 'forbid'#
id: int#
name: str#
cluster: str#
hostname: str#
username: str | None#
compute_tags: List[str]#
claimed: int#
successes: int#
failures: int#
rejected: int#
total_cpu_hours: float#
active_tasks: int#
active_cores: int#
active_memory: float#
status: ManagerStatusEnum#
created_on: datetime#
modified_on: datetime#
manager_version: str#
programs: Dict[str, List[str]]#
propagate_client(client, base_url_prefix)[source]#
Parameters:

base_url_prefix (str | None)

property tags: List[str]#
class ManagerActivationBody(*, name_data, manager_version, username, programs, compute_tags)[source]#

Bases: RestModelBase

Create a new model by parsing and validating input data from keyword arguments.

Raises ValidationError if the input data cannot be parsed to form a valid model.

Parameters:
  • name_data (ManagerName)

  • manager_version (str)

  • username (str | None)

  • programs (Dict[ConstrainedStrValue, List[str]])

  • compute_tags (List[ConstrainedStrValue])

name_data: ManagerName#
manager_version: str#
username: str | None#
programs: Dict[constr(to_lower=True), List[str]]#
compute_tags: List[constr(to_lower=True)]#
classmethod validate_tags(v)[source]#
classmethod validate_programs(v)[source]#
class Config#

Bases: object

extra = 'forbid'#
validate_assignment = True#
class ManagerUpdateBody(*, status, active_tasks, active_cores, active_memory, total_cpu_hours)[source]#

Bases: RestModelBase

Create a new model by parsing and validating input data from keyword arguments.

Raises ValidationError if the input data cannot be parsed to form a valid model.

Parameters:
  • status (ManagerStatusEnum)

  • active_tasks (int)

  • active_cores (int)

  • active_memory (float)

  • total_cpu_hours (float)

status: ManagerStatusEnum#
active_tasks: int#
active_cores: int#
active_memory: float#
total_cpu_hours: float#
class Config#

Bases: object

extra = 'forbid'#
validate_assignment = True#
class ManagerQueryFilters(*, include=None, exclude=None, limit=None, cursor=None, manager_id=None, name=None, cluster=None, hostname=None, status=None, modified_before=None, modified_after=None)[source]#

Bases: QueryProjModelBase

Create a new model by parsing and validating input data from keyword arguments.

Raises ValidationError if the input data cannot be parsed to form a valid model.

Parameters:
  • include (List[str] | None)

  • exclude (List[str] | None)

  • limit (int | None)

  • cursor (int | None)

  • manager_id (List[int] | None)

  • name (List[str] | None)

  • cluster (List[str] | None)

  • hostname (List[str] | None)

  • status (List[ManagerStatusEnum] | None)

  • modified_before (datetime | None)

  • modified_after (datetime | None)

manager_id: List[int] | None#
name: List[str] | None#
cluster: List[str] | None#
hostname: List[str] | None#
status: List[ManagerStatusEnum] | None#
modified_before: datetime | None#
modified_after: datetime | None#
classmethod parse_dates(v)[source]#
class Config#

Bases: object

extra = 'forbid'#
validate_assignment = True#
classmethod validate_lists(v)#
limit: int | None#
cursor: int | None#
include: List[str] | None#
exclude: List[str] | None#
class ManagerQueryAvailableFilters(*, compute_tag, programs)[source]#

Bases: RestModelBase

Create a new model by parsing and validating input data from keyword arguments.

Raises ValidationError if the input data cannot be parsed to form a valid model.

Parameters:
  • compute_tag (List[str])

  • programs (Dict[str, List[str]])

compute_tag: List[str]#
programs: Dict[str, List[str]]#
class Config#

Bases: object

extra = 'forbid'#
validate_assignment = True#
class ManagerQueryIterator(client, query_filters)[source]#

Bases: QueryIteratorBase[ComputeManager]

Iterator for manager queries

This iterator transparently handles batching and pagination over the results of a manager query

Construct an iterator

Parameters:
  • client – QCPortal client object used to contact/retrieve data from the server

  • query_filters (ManagerQueryFilters) – The actual query information to send to the server

reset()#

Starts retrieval of results from the beginning again