Speichern Sie Ihre Anmeldedaten

Wenn Sie in einer vertrauenswürdigen Python Umgebung arbeiten (z. B. auf einem persönlichen Laptop oder einer Workstation), können Sie die Methode save_account() verwenden, um Ihre Anmeldedaten lokal zu speichern und sie dann zur Initialisierung des Dienstes zu verwenden.

Vorbereitende Schritte

1. Stellen Sie sicher, dass Sie in einer aktiven „ Python “-Umgebung arbeiten, in der die Pakete qiskit-ibm-runtime und qiskit installiert sind.
2. Aktivieren Sie die virtuelle Umgebung Python und führen Sie Python in Ihrer virtuellen Umgebung aus.
3. Melden Sie sich unter IBM Quantum Platform an.

Finden Sie Ihre Zugangsdaten

1. Vergewissern Sie sich, dass das richtige Konto und die richtige Region im Kontowechsler in der Kopfzeile ausgewählt sind.
2. Finden Sie Ihren API-Schlüssel. Erstellen Sie auf dem Dashboard Ihren API-Schlüssel und kopieren Sie ihn an einen sicheren Ort, damit Sie ihn zur Authentifizierung verwenden können. Beachten Sie, dass Sie denselben API-Schlüssel für die Verbindung zu jeder Region verwenden können.
3. Optional: Suchen Sie die gewünschte Instanz auf der Seite Instanzen. Bewegen Sie den Mauszeiger über die CRN, klicken Sie auf das Symbol, um sie zu kopieren, und speichern Sie sie an einem sicheren Ort, damit Sie sie zur Identifizierung der Instanz verwenden können.

Speichern Sie Ihre Zugangsdaten

Speichern Sie Ihre Anmeldedaten, indem Sie den entsprechenden Code einmal pro Konto ausführen, das Sie speichern möchten. Nachdem Sie Ihre Anmeldedaten gespeichert haben, laden Sie diese, indem Sie die Schritte unter „ IBM Quantum -Compute-Service initialisieren“ befolgen.

Speichern Sie Anmeldedaten, die auf eine bestimmte Instanz zugreifen:

Wenn Sie über mehrere Instanzen verfügen und Quantum Compute auf einfache Weise mitteilen möchten, welche Instanz verwendet werden soll, speichern Sie Anmeldedaten, die eine Instanz- CRN enthalten.

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
)

Anmeldedaten für die automatische Instanzauswahl speichern:

Wenn Sie keine Instanz CRN en angeben und diese Anmeldedaten nicht an Quantum Compute übergeben, wird anhand der angegebenen Optionen eine geeignete Instanz für Sie ausgewählt.

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
)

Verfügbare Optionen

• token: IBM Cloud API-Schlüssel. Ihr Token ist vertraulich. Geben Sie Ihr Token nicht in öffentlichem Code weiter.
• instance: Geben Sie optional die zu verwendende Instanz durch ihre IBM Cloud CRN oder ihren Instanznamen an.
• plans_preference: Legen Sie optional die Arten von Plänen fest, die priorisiert werden sollen. Dies wird ignoriert, wenn die Instanz angegeben ist. Die verfügbaren Optionen sind open, pay-as-you-go, flex, premium und on-prem. Instanzen eines bestimmten Plantyps werden ausgeschlossen, wenn der Name des Plans nicht angegeben ist. Zum Beispiel, wenn [open] übergeben wird, sind nur Open-Plan-Instanzen verfügbar. Dies wird ignoriert, wenn instance angegeben ist.
• region: Legen Sie optional die zu verwendende Region fest. Akzeptierte Werte sind us-east und eu-de. Dies wird ignoriert, wenn instance angegeben ist.
• tags: Geben Sie optional die Tags der Instanz an. Akzeptiert eine Liste von Tag-Namenstrings. Dies wird ignoriert, wenn instance angegeben ist.
• name: Benennen Sie optional diesen Satz von Anmeldeinformationen.
• set_as_default: Setzen Sie den Wert auf True , um diese als Ihre Standard-Anmeldedaten zu speichern. Wenn Sie nur ein Konto speichern, wird es automatisch als Standardkonto festgelegt.
• overwrite: Setzen Sie diesen Wert auf True , um Ihre Standard-Anmeldedaten zu aktualisieren.

Beispiele

Beispiel 1

In diesem Beispiel werden Anmeldeinformationen für bestimmte Instanzen gespeichert, die den offenen und den Premium-Zugang ermöglichen. Die offenen Anmeldeinformationen sind als Standard eingestellt.

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

In diesem Beispiel werden Anmeldedaten für die automatische Instanzauswahl gespeichert. Quantum Compute berücksichtigt ausschließlich Premium-Instanzen in der EU-Region, die für das Konto verfügbar sind. Diese Anmeldedaten 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 Anmeldedaten anzeigen

Um alle gespeicherten Anmeldeinformationen anzuzeigen, führen Sie service.saved_accounts() aus. Beachten Sie, dass die Standard-Anmeldeinformationen, wenn Sie sie gespeichert und nicht benannt haben, den Namen default-ibm-quantum-platform tragen. Wenn Sie Ihre Standard-Anmeldeinformationen benannt haben, wird in der Ausgabe "is_default_account": true angezeigt.

Überlegungen

• Wenn Sie mehrere Konten speichern, verwenden Sie den Parameter name , um sie zu unterscheiden.
• Die Anmeldeinformationen werden auf $HOME/.qiskit/qiskit-ibm.json gespeichert. Bearbeiten Sie diese Datei nicht manuell.
• Wenn Sie Ihre Anmeldedaten nicht speichern, müssen Sie diese bei jedem Start einer neuen Sitzung (beim Aufrufen des „ IBM Quantum -Compute-Service“) erneut angeben.
• Wenn Sie Ihre Anmeldedaten manuell eingeben, wird kein gespeichertes Konto verwendet.

Nächste Schritte