Zum Hauptinhalt springen

Zugangsdaten speichern

Wenn du in einer vertrauenswürdigen Python-Umgebung arbeitest (z. B. auf deinem persönlichen Laptop oder deiner Workstation), kannst du die Methode save_account() verwenden, um deine Zugangsdaten lokal zu speichern und sie anschließend zur Initialisierung des Dienstes zu nutzen.

Hinweise

Vorbereitung​

  1. Stelle sicher, dass du ein IBM Cloud-Konto hast.
  2. Stelle sicher, dass du in einer aktiven Python-Umgebung mit dem installierten Qiskit SDK und Qiskit Runtime arbeitest.
  3. Aktiviere die virtuelle Python-Umgebung und führe Python darin aus.
  4. Melde dich mit einer IBMid oder einem Google-Konto bei IBM Quantum Platform an.

Zugangsdaten finden​

  1. Stelle sicher, dass das richtige Konto und die richtige Region im Konto-Umschalter im Header ausgewählt sind.
  2. Finde deinen API-Schlüssel. Erstelle deinen API-Schlüssel im Dashboard und kopiere ihn an einen sicheren Ort, damit du ihn zur Authentifizierung verwenden kannst. Beachte, dass du denselben API-Schlüssel für die Verbindung zu jeder Region verwenden kannst.
  3. Optional: Finde die Instanz, die du verwenden möchtest, auf der Seite Instanzen. Fahre mit der Maus über deren CRN, klicke auf das Symbol zum Kopieren und speichere sie an einem sicheren Ort, damit du sie zur Identifizierung der Instanz verwenden kannst.

Zugangsdaten speichern​

Speichere deine Zugangsdaten, indem du den entsprechenden Code einmal pro Konto ausführst, das du speichern möchtest. Lade deine gespeicherten Zugangsdaten anschließend, indem du die Schritte unter Den Qiskit Runtime-Dienst initialisieren befolgst.

Zugangsdaten für eine bestimmte Instanz speichern:​

Wenn du mehrere Instanzen hast und Qiskit Runtime einfach mitteilen möchtest, welche Instanz verwendet werden soll, speichere Zugangsdaten, die einen Instanz-CRN enthalten.

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
)

Zugangsdaten für automatische Instanzauswahl speichern:​

Wenn du keinen Instanz-CRN angibst und diese Zugangsdaten an Qiskit Runtime übergibst, wird automatisch eine geeignete Instanz für dich ausgewählt, basierend auf den angegebenen Optionen.

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
)

Verfügbare Optionen​

  • token: IBM Cloud API-Schlüssel. Dein Token ist vertraulich. Teile deinen Token nicht in öffentlichem Code.
  • instance: Gibt optional die zu verwendende Instanz über deren IBM Cloud CRN oder Instanzname an.
  • plans_preference: Legt optional die zu priorisierenden Plantypen fest. Wird ignoriert, wenn die Instanz angegeben ist. Verfügbare Optionen sind open, pay-as-you-go, flex, premium und on-prem. Instanzen eines bestimmten Plantyps werden ausgeschlossen, wenn der Planname nicht angegeben wird. Wenn zum Beispiel [open] übergeben wird, sind nur Open Plan-Instanzen verfügbar. Wird ignoriert, wenn instance angegeben ist.
  • region: Legt optional die zu verwendende Region fest. Zulässige Werte sind us-east und eu-de. Wird ignoriert, wenn instance angegeben ist.
  • tags: Gibt optional die Tags der Instanz an. Nimmt eine Liste von Tag-Name-Zeichenketten entgegen. Wird ignoriert, wenn instance angegeben ist.
  • name: Gibt diesem Satz von Zugangsdaten optional einen Namen.
  • set_as_default: Setze den Wert auf True, um diese als Standardzugangsdaten zu speichern. Wenn du nur ein Konto speicherst, wird es automatisch als Standard festgelegt.
  • overwrite: Setze diesen Wert auf True, um deine Standardzugangsdaten zu aktualisieren.

Beispiele​

Beispiel 1​

Dieses Beispiel speichert Zugangsdaten für bestimmte Instanzen, die Open- und Premium-Zugang ermöglichen. Die Open-Zugangsdaten werden als Standard gesetzt.

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)

Beispiel 2​

Dieses Beispiel speichert Zugangsdaten für die automatische Instanzauswahl. Qiskit Runtime berücksichtigt dabei ausschließlich Premium-Instanzen in der EU-Region, die dem Konto zur Verfügung stehen. Diese Zugangsdaten werden zum neuen Standard.

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

Gespeicherte Zugangsdaten anzeigen​

Um alle gespeicherten Zugangsdaten anzuzeigen, führe service.saved_accounts() aus. Wenn du Standardzugangsdaten gespeichert hast, ohne ihnen einen Namen zu geben, heißen sie default-ibm-quantum-platform. Wenn du deinen Standardzugangsdaten einen Namen gegeben hast, wird "is_default_account": true in der Ausgabe angezeigt.

Hinweise​

  • Wenn du mehrere Konten speicherst, verwende den Parameter name, um sie voneinander zu unterscheiden.
  • Zugangsdaten werden unter $HOME/.qiskit/qiskit-ibm.json gespeichert. Bearbeite diese Datei nicht manuell.
  • Wenn du deine Zugangsdaten nicht speicherst, musst du sie jedes Mal neu angeben, wenn du eine neue Sitzung startest (d. h. den Qiskit Runtime-Dienst instanziierst).
  • Wenn du deine Zugangsdaten manuell angibst, werden gespeicherte Konten nicht verwendet.

Nächste Schritte

Empfehlungen