QiskitRuntimeService

사용된 채널 유형을 반환합니다.

리턴

사용된 채널 유형입니다.

active_account()

현재 세션에 사용 중인 IBM 퀀텀 계정을 반환합니다.

리턴

현재 세션에 있는 계정에 대한 정보가 포함된 사전입니다.

리턴 유형

[d] ictstr, str | None

active_instance()

현재 활성 인스턴스의 크런을 반환합니다.

리턴 유형

str

backend(name, instance=None, use_fractional_gates=False, calibration_id=None)

지정된 필터링과 일치하는 단일 백엔드를 반환합니다.

백엔드 가용성은 회로 제출 시에만 확인된다는 점에 유의하십시오. 백엔드 상태를 미리 확인하려면 백엔드 객체의 메서드를 status() 사용하세요:

from qiskit_ibm_runtime import QiskitRuntimeService

service = QiskitRuntimeService()
backend = service.backend()

status = backend.status()
assert status.operational and status.status_msg == "active"

매개변수

• name (str) – 백엔드 이름입니다.
• instance (str | None) – IBM Cloud 계정 CRN을 지정합니다.
• use_fractional_gates (bool | None) – 백엔드가 소수 게이트를 포함할 수 있도록 하려면 True로 설정하십시오. 제한 사항에 대해서는 ‘분수 게이트를 사용하지 말아야 할 경우’를 참조하십시오.
• calibration_id (str | None) – 백엔드를 인스턴스화하는 데 사용되는 캘리브레이션 ID입니다.

리턴

필터링과 일치하는 백엔드입니다.

레이즈

• QiskitBackendNotFoundError - 백엔드를 찾을 수 없는 경우
• IBMInputValueError – 분수 게이트가 요청되었으나 백엔드에서 지원되지 않는 경우.

리턴 유형

백엔드

backends(name=None, min_num_qubits=None, instance=None, dynamic_circuits=None, filters=None, *, use_fractional_gates=False, calibration_id=None, **kwargs)

선택적 필터링에 따라 이 계정을 통해 액세스할 수 있는 모든 백엔드를 반환합니다.

매개변수

• name (str | None) – 필터링할 백엔드 이름입니다.

• min_num_qubits (int | None) – 백엔드에 필요한 최소 큐비트 수입니다.

• instance (str | None) – IBM Cloud 계정 CRN

• dynamic_circuits (bool | None) – 백엔드가 동적 회로를 지원하는지 여부에 따라 필터링합니다.

• filters (Callable[[IBMBackend], bool] | None) –

  람다 함수 등 보다 복잡한 필터. 예를 들어,

  QiskitRuntimeService.backends(
      filters=lambda backend: (
          (status := backend.status()).operational
          and status.status_msg == "active"
      )
  )

  작동 중이고 활성 상태인 백엔드만 반환합니다.

• use_fractional_gates (bool | None) – True로 설정하면 백엔드에 프랙셔널 게이트가 포함될 수 있습니다. 이제 유니티의 백엔드는 동적 회로와 프랙셔널 게이트를 동시에 지원합니다. 동적 회로 기능을 사용할 때 더 이상 이 플래그를 비활성화할 필요가 없습니다(예: if_else) 를 알고리즘에 추가하세요. 이 플래그를 True로 설정하면 제어 흐름 명령이 백엔드에서 제거되지 않습니다. None 이면 분수 게이트와 제어 흐름 연산이 모두 백엔드에 포함됩니다.

• calibration_id (str | None) – 백엔드를 인스턴스화하는 데 사용되는 캘리브레이션 ID입니다. 캘리브레이션 ID는 백엔드별로 정의되므로 단일 백엔드를 선택할 때만 사용해야 합니다.

• **kwargs* (모든)* - -

  백엔드 구성 또는 상태의 속성에 특정 값이 필요한 단순 필터입니다. 예:

  # Get the operational real backends
  QiskitRuntimeService.backends(simulator=False, operational=True)
  
  # Get the backends with at least 127 qubits
  QiskitRuntimeService.backends(min_num_qubits=127)
  
  # Get the backends that support OpenPulse
  QiskitRuntimeService.backends(open_pulse=True)

  백엔드 어트리뷰트의 전체 목록은 IBMBackend 클래스 문서를 참조하세요

리턴

필터와 일치하는 사용 가능한 백엔드 목록입니다.

레이즈

• IBMInputValueError - 입력이 유효하지 않은 경우.
• QiskitBackendNotFoundError - 백엔드가 인스턴스에 없는 경우.

리턴 유형

목록[ IBMBackend ]

static delete_account(filename=None, name=None, channel=None)

디스크에서 저장된 계정을 삭제합니다.

매개변수

• filename (str | None) – 계정을 삭제할 파일 이름입니다.
• name (str | None) – 삭제할 저장된 계정의 이름입니다.
• channel (ChannelType | None) – 삭제할 기본 계정의 채널 유형. 계정 이름이 지정된 경우 무시됩니다.

리턴

계정이 삭제된 경우 true입니다. 계정을 찾을 수 없으면 거짓입니다.

리턴 유형

부울

delete_job(job_id)

IBM Quantum Compute 작업을 삭제합니다.

이 작업은 되돌릴 수 없음을 유의하십시오.

매개변수

job_id (str) – 삭제할 작업의 ID.

레이즈

• RuntimeJobNotFound – 그 직책은 존재하지 않습니다.
• IBMRuntimeError – 메서드가 지원되지 않습니다.

리턴 유형

없음

instances()

현재 계정에 사용할 수 있는 인스턴스 목록을 반환합니다.

각 인스턴스에 대해 “crn”, “plan”, “name”이라는 인스턴스 식별자를 가진 일련의 사전이 포함된 목록을 반환합니다.

리턴

활성 계정에 사용할 수 있는 인스턴스가 있는 목록입니다.

리턴 유형

Sequence[ [dic] tstr, Any]

job(job_id)

IBM Quantum Compute 작업을 조회합니다.

매개변수

job_id (str) – 작업 ID.

리턴

IBM Quantum Compute 구직 정보가 검색되었습니다.

레이즈

• RuntimeJobNotFound - 작업이 존재하지 않는 경우.
• IBMRuntimeError - 요청이 실패한 경우.

리턴 유형

RuntimeJobV2

jobs(limit=10, skip=0, backend_name=None, pending=None, program_id=None, instance=None, job_tags=None, session_id=None, created_after=None, created_before=None, descending=True)

선택적 필터링 조건에 따라 모든 ‘ IBM Quantum Compute ’ 작업을 조회합니다.

매개변수

• limit (int | None) – 검색할 작업 수입니다. None 는 제한이 없다는 의미입니다.
• skip (int) – 작업 검색을 위한 시작 인덱스입니다.
• backend_name (str | None) – 작업을 검색할 백엔드의 이름입니다.
• pending (bool | None) – 작업 보류 상태별로 필터링합니다. True, '대기 중' 및 '실행 중' 작업이 포함되어 있습니다. False, '완료', '취소됨', '오류' 작업이 포함되어 있습니다.
• program_id (str | None) – 프로그램 ID로 필터링합니다.
• instance (str | None) – IBM Cloud 인스턴스 crn으로 필터링합니다.
• job_tags (list[str] | None) – 작업에 할당된 태그로 필터링합니다. 일치하는 작업은 모든 태그와 연관됩니다.
• session_id (str | None) – 세션 ID로 필터링합니다. 세션의 모든 작업은 작업 생성 날짜가 오래된 순서대로 반환됩니다.
• created_after (datetime | None) – 지정된 시작 날짜(현지 시간)를 기준으로 필터링합니다. 생성 날짜가 이 현지 날짜/시간 이후(이보다 크거나 같은)인 작업을 찾는 데 사용됩니다.
• created_before (datetime | None) – 지정된 종료일(현지 시간)을 기준으로 필터링합니다. 생성 날짜가 이 현지 날짜/시간 이전(또는 이보다 작거나 같은)인 작업을 찾는 데 사용됩니다.
• descending (bool) – True, 한도에 도달할 때까지 일자리 생성 날짜의 내림차순(즉, 가장 최근의 일자리부터)으로 일자리를 반환합니다.

리턴

IBM Quantum Compute 채용 공고 목록.

레이즈

IBMInputValueError - 입력 값이 유효하지 않은 경우.

리턴 유형

목록[ RuntimeJobV2 ]

least_busy(min_num_qubits=None, instance=None, filters=None, use_fractional_gates=False, **kwargs)

사용 가능한 백엔드 중 가장 사용량이 적은 백엔드를 반환합니다.

매개변수

• min_num_qubits (int | None) – 백엔드에 필요한 최소 큐비트 수입니다.

• instance (str | None) – IBM Cloud 계정 CRN.

• filters (Callable[[IBMBackend], bool] | None) –

  필터는 다음과 같이 정의할 수 있습니다 backends() 메서드로 정의할 수 있습니다. 5개의 큐비트로 연산 백엔드를 가져오는 예제입니다:

  QiskitRuntimeService.least_busy(n_qubits=5, operational=True)

• use_fractional_gates (bool | None) –

  True이 경우, 소수 게이트를 포함하는 백엔드만 고려되며, 반환된 백엔드에는 소수 게이트가 포함됩니다. 제한 사항에 대해서는 ‘분수 게이트를 사용하지 말아야 할 경우’를 참조하십시오.

• kwargs (Any) – 백엔드 쿼리에 전달된 추가 인자.

리턴

보류 중인 작업 수가 가장 적은 백엔드입니다.

레이즈

QiskitBackendNotFoundError - 기준과 일치하는 백엔드가 없는 경우.

리턴 유형

IBM 백엔드

static save_account(token=None, url=None, instance=None, channel=None, filename=None, name=None, proxies=None, verify=None, overwrite=False, set_as_default=None, private_endpoint=False, region=None, plans_preference=None, tags=None)

나중에 사용할 수 있도록 계정을 디스크에 저장합니다.

매개변수

• token (str | None) – IBM Cloud API 키.
• url (str | None) – API URL. 기본값은 https://cloud.ibm.com.
• instance (str | None) – 이 매개변수는 선택 사항으로, CRN 또는 서비스 이름을 지정하는 데 사용됩니다. 이 값이 설정된 경우, 서비스 인스턴스 생성을 위한 기본 인스턴스가 지정되며, 설정되지 않은 경우 서비스는 해당 계정 내에서 접근 가능한 모든 인스턴스를 가져옵니다. 을(를 "auto" )로 설정하면 자동 선택을 환경 설정으로 명시적으로 저장하게 되며, 이로 인해 이후 인스턴스화 시 “인스턴스가 설정되지 않았습니다”라는 경고가 표시되지 않습니다.
• channel (ChannelType | None) – 채널 유형. ibm_cloud 또는 ibm_quantum_platform.
• filename (str | None) – 계정이 저장된 파일의 전체 경로입니다.
• name (str | None) – 저장할 계정의 이름입니다.
• proxies (dict | None) – 프록시 설정. 지원되는 선택적 키는 urls (프로토콜 또는 프로토콜과 호스트를 프록시의 URL 에 매핑하는 사전으로, https://requests.readthedocs.io/en/latest/api/#requests.Session.proxies 에 설명되어 있음), username_ntlm, password_ntlm (NTLM 사용자 인증을 활성화하기 위한 사용자 이름과 비밀번호)입니다
• verify (bool | None) – 서버의 TLS 인증서를 확인합니다.
• overwrite (bool | None) – True 기존 계정을 덮어쓰려는 경우 를 입력합니다.
• set_as_default (bool | None) – True 이면 계정이 기본 계정으로 파일 이름에 저장됩니다.
• private_endpoint (bool | None) – 비공개 API에 연결 URL.
• region (RegionType | None) – 지역 설정을 지정하세요. us-east 또는 eu-de. 인스턴스가 전달되지 않은 경우, 이 리전을 가진 인스턴스가 우선적으로 선택됩니다.
• plans_preference (PlanType | None) – 계정 계획명 목록 (open, premium, 등), 선호도 순으로 정렬됨. 목록의 첫 번째 값을 가진 인스턴스가 우선적으로 고려되며, 지정된 플랜 이름을 가진 인스턴스만 검토 대상이 됩니다. 예를 들어, 프리미엄 계정의 사용을 피하고 싶다면, 오픈 플랜 인스턴스만 사용하도록 매개변수를 전달하기만 "open" 하면 됩니다. plans_preference 가 instance 지정된 경우 무시됩니다.
• tags (list[str] | None) – 사용 가능한 인스턴스를 필터링할 태그 목록을 설정합니다. 인스턴스가 전달되지 않은 경우, 이러한 태그를 가진 인스턴스가 우선순위로 처리됩니다.

리턴 유형

없음

static saved_accounts(default=None, channel=None, filename=None, name=None)

디스크에 저장된 계정을 나열합니다.

매개변수

• default (bool | None) – True로 설정하면 기본 계정만 반환됩니다.
• channel (ChannelType | None) – type.\ \ibm_cloud`` 채널 또는 ibm_quantum_platform.
• filename (str | None) – 계정이 반환되는 파일 이름입니다.
• name (str | None) – 이 옵션을 설정하면 지정된 이름의 계정만 반환됩니다.

리턴

디스크에 저장된 계정에 대한 정보가 포함된 사전입니다.

레이즈

ValueError - 디스크에서 잘못된 계정을 발견한 경우.

리턴 유형

dict

usage()

현재 활성 인스턴스에 대한 사용량 정보를 반환합니다.

리턴

사용 내역이 포함된 딕셔너리.

리턴 유형

딕셔너리 [str, Any]