Skip to main contentIBM Quantum Documentation Mirror

EnvironmentOptions

class EnvironmentOptions(log_level='WARNING', job_tags=<factory>, private=False, max_execution_time=None, image=None)

GitHub

Bases: object

Options related to the execution environment.


Attributes

Parameters

  • log_level (Literal['DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL'])
  • job_tags (list[str])
  • private (bool)
  • max_execution_time (int | None)
  • image (Annotated[str, FieldInfo(annotation=NoneType, required=True, metadata=[_PydanticGeneralMetadata(pattern='[a-zA-Z0-9]+([/.\\-_][a-zA-Z0-9]+)*:[a-zA-Z0-9]+([.\\-_][a-zA-Z0-9]+)*$')])] | None)

image

Type: Annotated[str, FieldInfo(annotation

Default value: NoneType, required=True, metadata=[_PydanticGeneralMetadata(pattern='[a-zA-Z0-9]+([/.\\-_][a-zA-Z0-9]+)*:[a-zA-Z0-9]+([.\\-_][a-zA-Z0-9]+)*$')])] | None = None

Runtime image used for this job.

job_tags

Type: list[str]

Default value: FieldInfo(annotation=NoneType, required=False, default_factory=list)

Tags to be assigned to the job.

The tags can subsequently be used as a filter in the qiskit_ibm_runtime.qiskit_runtime_service.jobs() function call.

log_level

Type: Literal['DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL']

Default value: 'WARNING'

logging level to set in the execution environment.

The valid log levels are: DEBUG, INFO, WARNING, ERROR, and CRITICAL.

max_execution_time

Type: int | None

Default value: None

Maximum execution time in seconds.

This value bounds system execution time (not wall clock time). System execution time is the amount of time that the system is dedicated to processing your job. If a job exceeds this time limit, it is forcibly cancelled.

private

Type: bool

Default value: False

Boolean that indicates whether the job is marked as private.

When set to true, input parameters are not returned, and the results can only be read once. After the job is completed, input parameters are deleted from the service. After the results are read, these are also deleted from the service. When set to false, the input parameters and results follow the standard retention behavior of the API.


Methods