Skip to main content
IBM Quantum Platform

RuntimeJobV2

class RuntimeJobV2(backend, api_client, job_id, program_id, service, creation_date=None, result_decoder=None, image='', session_id=None, tags=None, version=None, private=False)

GitHub

Bases: BasePrimitiveJob[PrimitiveResult, Literal['초기화 중', '대기 중', '실행 중', '취소됨', '완료됨', '오류']], BaseRuntimeJob

IBM Quantum Compute (이전 명칭: Qiskit Runtime ) V2 기본 연산의 표현.

매개변수

  • backend (Backend) – 이 작업을 실행하는 데 사용되는 백엔드 인스턴스.
  • api_client (RuntimeClient) – 서버에 연결하기 위한 객체입니다.
  • job_id (str) – 작업 ID.
  • program_id (str) – 이 작업이 속한 프로그램의 ID입니다.
  • creation_date (str | None) – 작업 생성 날짜(UTC 기준).
  • result_decoder (type[ResultDecoder] | Sequence[type[ResultDecoder]] | None) – 작업 결과를 디코딩하는 데 사용되는 하위 ResultDecoder 클래스, 또는 그러한 하위 클래스들의 목록. 두 개 이상의 디코더가 지정된 경우, 디코더의 n-th 출력을 다음 n+1-th 디코더의 입력으로 삼아 연쇄적으로 호출됩니다. 명시되지 않은 경우 기본값이 ResultDecoder 사용됩니다.
  • image (str | None) – IBM Quantum Compute 이 작업에 사용된 이미지: image_name:tag.
  • service (QiskitRuntimeService) – IBM Quantum Compute 서비스.
  • session_id (str | None) – IBM Quantum Compute 세션에서 첫 번째 작업의 작업 ID.
  • tags (list | None) – 작업에 할당된 태그.
  • version (int | None) – 원시 버전.
  • private (bool | None) – 작업을 비공개로 표시합니다.

기본 작업을 초기화합니다.

매개변수

  • job_id (str) – 작업 실행에 사용된 기본 객체의 컨텍스트 내 고유 ID.
  • kwargs – 이 작업과 연결할 키-값 형식의 메타데이터.
  • backend (Backend)
  • api_client (RuntimeClient)
  • program_id (str)
  • service (QiskitRuntimeService)
  • creation_date (str | None)
  • result_decoder (type[ResultDecoder] | Sequence[type[ResultDecoder]] | None)
  • image (str | None)
  • session_id (str | None)
  • tags (list | None)
  • version (int | None)
  • private (bool | None)

속성

오류

유형: str | RuntimeJobStatus

기본값: 'ERROR'

JOB_FINAL_STATES

유형: tuple[JobStatus,...]

기본값: ('DONE', 'CANCELLED', 'ERROR')

creation_date

일자리 생성 날짜(현지 시간 기준).

리턴

날짜/시간 개체의 작업 생성 날짜(현지 시간 기준) 또는 생성 날짜를 사용할 수 없는 경우 None .

image

해당 작업에 사용된 ‘ IBM Quantum Compute ’ 이미지를 반환합니다.

리턴

IBM Quantum Compute 이미지 또는 image_name:tag 기본 이미지가 사용되는 경우 "" .

inputs

작업 입력 매개변수.

리턴

이 작업에 사용되는 입력 매개변수입니다.

instance

IBM Cloud 인스턴스 CRN을 반환합니다.

primitive_id

원시 이름.

리턴

이 일은 정말 원시적이군.

private

작업이 비공개인지 여부를 나타내는 부울을 반환합니다.

session_id

세션 ID입니다.

리턴

세션 ID입니다. 백엔드가 시뮬레이터인 경우 없음.

tags

작업 태그.

리턴

필터링에 사용할 수 있는 작업에 할당된 태그입니다.

usage_estimation

이 작업에 대한 사용량 예상 정보를 반환합니다.

리턴

quantum_seconds 작업의 예상 시스템 실행 시간(초)입니다. 퀀텀 시간은 시스템이 작업을 처리하는 데 할애하는 시간을 나타냅니다.

메소드

backend

backend(timeout=None)

GitHub

이 작업이 실행된 백엔드를 반환합니다. 백엔드가 없음인 경우 데이터를 다시 검색합니다.

레이즈

IBMRuntimeError - 네트워크 오류가 발생한 경우.

매개변수

timeout (float | None)

리턴 유형

백엔드 | 없음

cancel

cancel()

GitHub

작업을 취소하십시오.

레이즈

  • RuntimeInvalidStateError - 작업이 취소할 수 없는 상태인 경우.
  • IBMRuntimeError - 작업을 취소할 수 없는 경우.

리턴 유형

없음

cancelled

cancelled()

GitHub

작업이 취소되었는지 여부를 반환합니다.

리턴 유형

부울

done

done()

GitHub

작업이 성공적으로 실행되었는지 여부를 반환합니다.

리턴 유형

부울

error_message

error_message()

GitHub

작업이 실패한 경우 그 이유를 반환합니다.

리턴

오류 메시지 문자열 또는 None.

리턴 유형

str | 없음

errored

errored()

GitHub

작업 실패 여부를 반환합니다.

리턴 유형

부울

in_final_state

in_final_state()

GitHub

작업이 DONE 또는 ERROR 과 같은 최종 작업 상태인지 반환합니다.

리턴 유형

부울

job_id

job_id()

작업을 식별하는 고유 ID를 반환합니다.

리턴 유형

str

logs

logs()

GitHub

작업 로그를 반환합니다.

참고

작업 로그는 작업이 완료된 후에만 사용할 수 있습니다.

리턴

표준 출력 및 오류를 포함한 작업 로그.

레이즈

IBMRuntimeError - 네트워크 오류가 발생한 경우.

리턴 유형

str

metrics

metrics()

GitHub

작업 메트릭을 반환합니다.

리턴

  • timestamps: 작업이 생성, 실행 시작, 완료된 시점의 타임스탬프입니다.

  • usage: 작업 사용량에 대한 세부 정보, 작업량 측정

    워크로드에 대해 QPU가 잠겨 있는 시간입니다.

리턴 유형

다음을 포함하되 이에 국한되지 않는 작업 지표가 포함된 사전입니다

레이즈

IBMRuntimeError - 네트워크 오류가 발생한 경우.

properties

properties(refresh=False)

GitHub

이 작업에 대한 백엔드 속성을 반환합니다.

매개변수

refresh (bool) – True, 서버에 백엔드 속성을 다시 쿼리합니다. 그렇지 않으면 캐시된 버전을 반환합니다.

리턴

이 작업에 사용된 백엔드 속성, 작업 실행이 시작된 시점, 또는 속성을 사용할 수 없는 경우 None .

리턴 유형

BackendProperties | 없음

result

result(timeout=None, decoder=None, poll_interval=None)

GitHub

작업 결과를 반환합니다.

매개변수

  • timeout (float | None) – 작업 대기 시간(초)입니다.

  • decoder (type[ResultDecoder] | Sequence[type[ResultDecoder]] | None) – 작업 결과를 디코딩하는 데 사용되는 하위 ResultDecoder 클래스, 또는 그러한 하위 클래스들의 목록. 두 개 이상의 디코더가 지정된 경우, 디코더의 n-th 출력을 다음 n+1-th 디코더의 입력으로 삼아 연쇄적으로 호출됩니다.

  • poll_interval (float | None) –

    작업 상태를 연속으로 조회할 때 각 조회 사이에 대기할 초 수. 그 일의.

    • 100ms``500ms세션이 아닌 작업의 경우 기본값은 이며, 하한값은 입니다.
    • 세션 작업의 경우, 기본값과 하한값은 100ms.

리턴

IBM Quantum Compute 작업 결과 (해당되는 경우 후처리된 결과).

레이즈

  • RuntimeJobFailureError - 작업이 실패한 경우.
  • RuntimeJobMaxTimeoutError - 주어진 시간 내에 작업이 완료되지 않은 경우.
  • RuntimeInvalidStateError - 작업이 취소되어 결과 검색을 시도하는 경우.

리턴 유형

임의

running

running()

GitHub

작업이 활발하게 실행 중인지 반환합니다.

리턴 유형

부울

status

status()

GitHub

작업 상태를 반환합니다.

리턴

이 작업의 상태.

리턴 유형

리터럴[ '초기화 중', '대기 중', '실행 중', '취소됨', '완료됨', '오류']

update_tags

update_tags(new_tags)

GitHub

이 작업과 관련된 태그를 업데이트합니다.

매개변수

new_tags (list[str]) – 작업에 할당할 새 태그들.

리턴

이 작업과 관련된 새 태그입니다.

레이즈

IBMApiError - 서버와 통신하거나 작업 태그를 업데이트할 때 예기치 않은 오류가 발생한 경우.

리턴 유형

[목] 록 문자열

usage

usage(partial=False)

GitHub

몇 초 만에 작업 사용량을 반환합니다.

기본적으로, 사용량 계산이 완료될 때까지 반환되는 작업 사용량은 입니다 0 . 이 메서드에서는 플래그를 partial 사용하여 누적된 중간 사용량을 반환할 수 있습니다.

참고

partial를 사용할 때, 작업이 완료되는 즉시 최종 결과가 반환된다는 보장은 없음을 유의하십시오. 반환된 사용 정보가 최종적인 것임을 보장하려면 를 사용하여 partial=False 메서드를 호출하거나, 완료 상태에 대한 세부 정보를 확인하려면 메서드를 metrics() 사용하는 것이 좋습니다.

매개변수

Truepartial (bool) – if 조건이 성립할 경우, 최종 사용량에 도달할 때까지 누적된 중간 사용량을 반환한다.

리턴 유형

플로트(스위치일 경우)

wait_for_final_state

wait_for_final_state(timeout=None, poll_interval=None)

GitHub

상태가 최종 상태가 될 때까지 API에서 작업 상태를 폴링합니다.

매개변수

  • timeout (float | None) – 작업을 기다리는 데 몇 초가 걸립니다. None 이면 무기한 대기합니다.

  • poll_interval (float | None) –

    서비스에 작업 상태를 조회할 때마다 대기할 초 수.

    • 100ms``500ms세션이 아닌 작업의 경우 기본값은 이며, 하한값은 입니다.
    • 100ms세션 작업의 경우, 기본값이자 하한값은.입니다.

레이즈

RuntimeJobTimeoutError - 주어진 시간 내에 작업이 완료되지 않은 경우.

리턴 유형

없음

이 페이지가 도움이 되었습니까?
GitHub에서 버그, 오타를 보고하거나 컨텐츠를 요청하십시오.