Ulož své přihlašovací údaje

Pokud pracuješ v důvěryhodném prostředí Pythonu (například na osobním laptopu nebo pracovní stanici), můžeš použít metodu save_account() k uložení svých přihlašovacích údajů lokálně a poté je použít k inicializaci služby.

Poznámky

• Pokud používáš veřejný počítač nebo jiné nedůvěryhodné prostředí, postupuj místo toho podle pokynů v části Inicializace služby v nedůvěryhodném prostředí.
• Postupuj podle těchto pokynů, pokud se chceš připojit pomocí REST API místo Qiskit.
• V případě potřeby použij tyto informace ke konfiguraci firewallu a povolení přístupu k API koncovým bodům IBM Quantum.

Než začneš

1. Ujisti se, že máš účet IBM Cloud.
2. Ujisti se, že pracuješ v aktivním prostředí Pythonu s nainstalovaným Qiskit SDK a Qiskit Runtime.
3. Aktivuj virtuální prostředí Pythonu a spusť Python ve svém virtuálním prostředí.
4. Přihlas se na IBM Quantum Platform pomocí účtu IBMid nebo Google.

Najdi své přístupové údaje

1. Ujisti se, že v přepínači účtů v záhlaví je vybrán správný účet a region.
2. Najdi svůj API klíč. Na nástěnce vytvoř svůj API klíč a zkopíruj jej na bezpečné místo, abys jej mohl/a použít k ověření. Všimni si, že stejný API klíč můžeš použít pro připojení k libovolnému regionu.
3. Volitelné: Najdi instanci, kterou chceš použít, na stránce Instance. Najeď myší na její CRN, klikni na ikonu pro kopírování a ulož ji na bezpečné místo, abys ji mohl/a použít k identifikaci instance.

Ulož své přístupové údaje

Ulož své přihlašovací údaje spuštěním příslušného kódu jednou pro každý účet, který chceš uložit. Po uložení přihlašovacích údajů je načti podle kroků v části Inicializace služby Qiskit Runtime.

Ulož přihlašovací údaje pro přístup ke konkrétní instanci:

Pokud máš více instancí a chceš Qiskit Runtime snadno říct, kterou instanci použít, ulož přihlašovací údaje, které obsahují CRN instance.

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
)

Ulož přihlašovací údaje pro automatický výběr instance:

Pokud nezadáš CRN instance a předáš tyto přihlašovací údaje Qiskit Runtime, bude za tebe vybrána vhodná instance na základě zadaných možností.

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
)

Dostupné možnosti

• token: API klíč IBM Cloud. Tvůj token je důvěrný. Nesdílej svůj token ve veřejném kódu.
• instance: Volitelně zadej instanci k použití prostřednictvím jejího CRN IBM Cloud nebo názvu instance.
• plans_preference: Volitelně nastav typy plánů, kterým dát přednost. Toto je ignorováno, pokud je instance zadána. Dostupné možnosti jsou open, pay-as-you-go, flex, premium a on-prem. Instance určitého typu plánu jsou vyloučeny, pokud název plánu není zadán. Například pokud je předáno [open], jsou dostupné pouze instance plánu Open. Toto je ignorováno, pokud je zadán instance.
• region: Volitelně nastav region k použití. Přijímané hodnoty jsou us-east a eu-de. Toto je ignorováno, pokud je zadán instance.
• tags: Volitelně zadej tagy instance. Přijímá seznam řetězců s názvy tagů. Toto je ignorováno, pokud je zadán instance.
• name: Volitelně pojmenuj tuto sadu přihlašovacích údajů účtu.
• set_as_default: Nastav hodnotu na True, aby se tyto přihlašovací údaje uložily jako výchozí. Pokud uložíš pouze jeden účet, je automaticky nastaven jako výchozí.
• overwrite: Nastav tuto hodnotu na True pro aktualizaci výchozích přihlašovacích údajů.

Příklady

Příklad 1

Tento příklad uloží přihlašovací údaje pro konkrétní instance, které umožňují otevřený a prémiový přístup. Otevřené přihlašovací údaje jsou nastaveny jako výchozí.

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)

Příklad 2

Tento příklad uloží přihlašovací údaje pro automatický výběr instance. Qiskit Runtime bude hledat pouze prémiové instance v regionu EU, které jsou dostupné pro daný účet. Tyto přihlašovací údaje se stanou novými výchozími.

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"]
  )

Zobrazení uložených přihlašovacích údajů

Chceš-li zobrazit všechny uložené přihlašovací údaje, spusť service.saved_accounts(). Všimni si, že pokud jsi uložil/a výchozí přihlašovací údaje bez pojmenování, budou pojmenovány default-ibm-quantum-platform. Pokud jsi výchozí přihlašovací údaje pojmenoval/a, uvidíš ve výstupu "is_default_account": true.

Důležité poznámky

• Pokud ukládáš více účtů, použij parametr name k jejich rozlišení.
• Přihlašovací údaje se ukládají do $HOME/.qiskit/qiskit-ibm.json. Tento soubor ručně neupravuj.
• Pokud neuložíš své přihlašovací údaje, musíš je zadávat pokaždé, když zahájíš novou Session (vytvoříš instanci služby Qiskit Runtime).
• Pokud zadáš přihlašovací údaje ručně, uložený účet nebude použit.

Další kroky

Doporučení

• Inicializuj službu Qiskit Runtime v důvěryhodném prostředí Pythonu.
• Inicializuj službu Qiskit Runtime v nedůvěryhodném prostředí.
• Zobraz dostupné QPU.
• Konfiguruj Qiskit SDK lokálně.
• Postupuj podle kroků v části Hello world pro napsání a spuštění kvantového programu.
• Nastav připojení k IBM Quantum Platform pomocí REST API.
• Vyzkoušej tutoriál.