로그인 자격 증명 저장

신뢰할 수 있는 Python 환경(예: 개인 노트북 또는 워크스테이션)에서 작업하는 경우 save_account() 방법을 사용하여 자격 증명을 로컬에 저장한 다음 이를 사용하여 서비스를 초기화할 수 있습니다.

시작하기 전에

1. Python 환경이 정상적으로 작동 중이며, 및 qiskit 패키지가 qiskit-ibm-runtime 설치되어 있는지 확인하십시오.
2. Python 가상 환경을 활성화하고 가상 환경에서 Python 을 실행합니다.
3. IBM Quantum Platform 에 로그인하세요.

접근 자격 증명을 찾으세요

1. 헤더의 계정 전환기에서 올바른 계정과 지역이 선택되었는지 확인합니다.
2. API 키를 찾습니다. 대시보드에서 API 키를 생성한 다음 안전한 위치에 복사하여 인증에 사용할 수 있도록 합니다. 동일한 API 키를 사용하여 모든 지역에 연결할 수 있습니다.
3. 선택 사항입니다: 인스턴스 페이지에서 사용하려는 인스턴스를 찾습니다. CRN 위로 마우스를 가져가 아이콘을 클릭하여 복사한 다음 안전한 위치에 저장하여 인스턴스를 식별하는 데 사용할 수 있습니다.

접근 자격 증명을 저장하세요

저장하고자 하는 계정마다 해당 코드를 한 번씩 실행하여 인증 정보를 저장하세요. 인증 정보를 저장한 후, ‘ IBM Quantum Compute Service 초기화’의 단계에 따라 해당 정보를 불러오십시오.

특정 인스턴스에 액세스하는 자격 증명을 저장합니다:

인스턴스가 여러 개 있고 Quantum Compute에 사용할 인스턴스를 쉽게 지정하려면, 인스턴스 CRN 를 포함한 자격 증명을 저장하세요.

from qiskit_ibm_runtime import QiskitRuntimeService

QiskitRuntimeService.save_account(
  # For `token`, use the 44-character API_KEY you created 
  # and saved from the IBM Quantum Platform Home dashboard:
  token="<your-api-key>", 
  name="<account-name>", # Optional
  instance="<IBM Cloud CRN or instance name>", # Optional
  set_as_default=True, # Optional
  overwrite=True, # Optional
)

자동 인스턴스 선택을 위한 자격 증명 저장:

CRN 에 인스턴스를 지정하지 않고 이러한 자격 증명을 Quantum Compute에 전달하지 않으면, 지정된 옵션을 바탕으로 사용자에게 적합한 인스턴스가 자동으로 선택됩니다.

from qiskit_ibm_runtime import QiskitRuntimeService

QiskitRuntimeService.save_account(
  # For `token`, use the 44-character API_KEY you created 
  # and saved from the IBM Quantum Platform Home dashboard:
  token="<your=api-key>", 
  name="<account-name>", # Optional
  instance="<instance-to-use>", # Optional
  plans_preference="<plan_types>", # Optional
  region="<region>", # Optional
  tags="<instance-tags>", # Optional
  set_as_default=True, # Optional
  overwrite=True, # Optional
)

사용 가능 옵션

• token: IBM Cloud API 키. 토큰은 기밀로 유지됩니다. 토큰을 공개 코드로 공유하지 마세요.
• instance: 선택적으로 IBM Cloud CRN 또는 인스턴스 이름을 통해 사용할 인스턴스를 지정합니다.
• plans_preference: 선택적으로 우선순위를 지정할 플랜 유형을 설정합니다. 인스턴스가 지정되어 있으면 무시됩니다. 사용 가능한 옵션은 open, pay-as-you-go, flex, premium, on-prem 입니다. 요금제 이름이 지정되지 않은 경우 특정 요금제 유형의 인스턴스는 제외됩니다. 예를 들어 [open] 을 전달하면 오픈 플랜 인스턴스만 사용할 수 있습니다. instance 을 지정하면 무시됩니다.
• region: 선택적으로 사용할 지역을 설정합니다. 허용되는 값은 us-east 및 eu-de 입니다. instance 을 지정하면 무시됩니다.
• tags: 선택적으로 인스턴스의 태그를 지정합니다. 태그 이름 문자열 목록을 허용합니다. instance 을 지정하면 무시됩니다.
• name: 선택적으로 이 계정 자격 증명 집합의 이름을 지정합니다.
• set_as_default: 값을 True 으로 설정하여 기본 자격 증명으로 저장합니다. 하나의 계정만 저장하면 해당 계정이 자동으로 기본값으로 설정됩니다.
• overwrite: 기본 자격 증명을 업데이트하려면 이 값을 True 으로 설정합니다.

예

예제 1

이 예에서는 특정 인스턴스에 대한 자격 증명을 저장하여 공개 및 프리미엄 액세스를 허용합니다. 열린 자격 증명이 기본값으로 설정되어 있습니다.

from qiskit_ibm_runtime import QiskitRuntimeService

QiskitRuntimeService.save_account(token="<API_TOKEN>", 
                                  instance="<CRN_for_premium_instance>",
                                  name="premium")
QiskitRuntimeService.save_account(token="<API_TOKEN>", 
                                  instance="<CRN_for_open_instance>",
                                  name="open", set_as_default=True)

예제 2

이 예제는 자동 인스턴스 선택을 위해 자격 증명을 저장합니다. Quantum Compute는 해당 계정에서 사용할 수 있는 EU 지역의 프리미엄 인스턴스만 검토합니다. 이 자격 증명이 새로운 기본값이 됩니다.

QiskitRuntimeService.save_account(
    token="your-api-key",
    set_as_default=True,
    overwrite = True,

    # Set instance "filters" instead of specifying the instance:
    region="eu-de",
    plans_preference=["premium"]
  )

저장된 자격 증명 보기

저장한 모든 자격 증명을 확인하려면 service.saved_accounts() 을 실행합니다. 기본 자격 증명을 저장하고 이름을 지정하지 않은 경우에는 default-ibm-quantum-platform 라는 이름이 지정됩니다. 기본 자격 증명의 이름을 지정한 경우 출력에 "is_default_account": true 이 표시됩니다.

고려사항

• 여러 계정을 저장하는 경우 name 매개변수를 사용하여 계정을 구분하세요.
• 자격 증명은 $HOME/.qiskit/qiskit-ibm.json 에 저장됩니다. 이 파일을 수동으로 편집하지 마세요.
• 인증 정보를 저장하지 않은 경우, 새 세션을 시작할 때마다( IBM Quantum Compute Service를 인스턴스화할 때마다) 해당 정보를 직접 입력해야 합니다.
• 자격 증명을 수동으로 지정하는 경우 저장된 계정은 사용되지 않습니다.

다음 단계