Перейти до основного вмісту

Збережи свої облікові дані

Якщо ти працюєш у довіреному середовищі Python (наприклад, на особистому ноутбуці або робочій станції), можна скористатися методом save_account(), щоб зберегти облікові дані локально, а потім використовувати їх для ініціалізації сервісу.

Примітки

Перш ніж почати​

  1. Переконайся, що маєш обліковий запис IBM Cloud.
  2. Переконайся, що працюєш у активному середовищі Python із встановленими Qiskit SDK та Qiskit Runtime.
  3. Активуй віртуальне середовище Python і запусти Python у ньому.
  4. Увійди в IBM Quantum Platform за допомогою IBMid або облікового запису Google.

Знайди свої облікові дані для доступу​

  1. Переконайся, що у перемикачі облікових записів у шапці обрано правильний акаунт і регіон.
  2. Знайди свій API-ключ. На головній сторінці створи API-ключ, скопіюй його в надійне місце — він знадобиться для автентифікації. Зверни увагу: один і той самий API-ключ можна використовувати для підключення до будь-якого регіону.
  3. Необов'язково: знайди потрібний інстанс на сторінці Instances. Наведи курсор на його CRN, клацни іконку копіювання та збережи значення в надійному місці — воно знадобиться для ідентифікації інстансу.

Збережи свої облікові дані для доступу​

Збережи облікові дані, запустивши відповідний код один раз для кожного акаунта, який хочеш зберегти. Після збереження завантаж їх, дотримуючись кроків у Ініціалізація сервісу Qiskit Runtime.

Збережи облікові дані для доступу до конкретного інстансу:​

Якщо у тебе кілька інстансів і ти хочеш легко вказати Qiskit Runtime, який із них використовувати, збережи облікові дані з CRN інстансу.

from qiskit_ibm_runtime import QiskitRuntimeService

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

Збережи облікові дані для автоматичного вибору інстансу:​

Якщо не вказати CRN інстансу і передати ці облікові дані в Qiskit Runtime, відповідний інстанс буде обрано автоматично на основі вказаних параметрів.

from qiskit_ibm_runtime import QiskitRuntimeService

QiskitRuntimeService.save_account(
  token="<your=api-key>", # Use the 44-character API_KEY you created and saved from the IBM Quantum Platform Home dashboard
  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: API-ключ IBM Cloud. Твій токен є конфіденційним. Не розкривай токен у публічному коді.
  • instance: Необов'язково: вкажи інстанс через його IBM Cloud CRN або назву інстансу.
  • plans_preference: Необов'язково: встанови пріоритет типів планів. Ігнорується, якщо вказано instance. Доступні значення: open, pay-as-you-go, flex, premium та on-prem. Інстанси певного типу плану виключаються, якщо назва плану не вказана. Наприклад, якщо передати [open], доступні лише інстанси Open Plan. Ігнорується, якщо вказано instance.
  • region: Необов'язково: встанови регіон. Допустимі значення: us-east і eu-de. Ігнорується, якщо вказано instance.
  • tags: Необов'язково: вкажи теги інстансу. Приймає список рядків з назвами тегів. Ігнорується, якщо вказано instance.
  • name: Необов'язково: дай цьому набору облікових даних ім'я.
  • set_as_default: Встанови значення True, щоб зберегти ці дані як облікові дані за замовчуванням. Якщо збережено лише один акаунт, він автоматично стає стандартним.
  • overwrite: Встанови значення True, щоб оновити свої облікові дані за замовчуванням.

Приклади​

Приклад 1​

У цьому прикладі зберігаються облікові дані для конкретних інстансів із доступом Open та Premium. Облікові дані для Open встановлюються як стандартні.

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​

У цьому прикладі зберігаються облікові дані для автоматичного вибору інстансу. Qiskit Runtime розглядатиме лише premium-інстанси в регіоні 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. Не редагуй цей файл вручну.
  • Якщо не збережеш облікові дані, їх потрібно буде вказувати щоразу при старті нової сесії (ініціалізації сервісу Qiskit Runtime).
  • Якщо вказати облікові дані вручну, збережений акаунт використовуватися не буде.

Наступні кроки

Рекомендації