Zum Hauptinhalt springen

Instanzen erstellen und verwalten

Der Zugriff auf IBM Quantum Platform-Dienste wird durch die Instanzen gesteuert, denen du zugewiesen bist. Benutzer können mehreren Instanzen angehören.

Instanzen sind virtuelle Server (Deployments von Qiskit Runtime), die die Ausführung deiner Workloads verwalten, einschließlich der Ausführung von Quantenprogrammen und klassischen Berechnungsaufgaben (wie der Verarbeitung von Fehlerminderung). Instanzen werden durch ihren Cloud Resource Name (CRN) identifiziert. Dieser CRN kann beim Senden von Workloads aus deinen Qiskit-Programmen verwendet werden.

Du kannst die Instanzen, auf die du Zugriff hast, im Dashboard sehen, oder indem du auf die Registerkarte "Instances" im Dashboard klickst. Jede Instanz wird mit ihrer CRN-Kennung aufgelistet.

Du benötigst für jeden Serviceplan (wie Open oder Pay-As-You-Go), den du verwendest, in jeder Region, die du nutzen möchtest, eine andere Instanz. Der Account-Manager und jeder mit ausreichender Berechtigung kann eine Instanz erstellen und ihre Konfiguration definieren, wie z.B. ihre Zuweisungen, Nutzungslimits, Quantencomputer und Benutzerberechtigungen.

Das IBM Quantum Platform-Dashboard zeigt die Instanzen an, auf die du Zugriff hast. Je nach deinem Zugriff kannst du vollständige Details anzeigen, Instanzen bearbeiten und löschen auf der Instances-Seite.

Es ist wichtig, dass du verstehst, welche Instanz du verwendest, denn alle Instanzen, die nicht mit dem Open Plan verbunden sind, verursachen Kosten.

Open Plan-Instanz​

Open Plan-Benutzer können Quantenschaltungen auf den weltweit besten QPUs kostenlos ausführen (bis zu 10 Minuten Quantenzeit pro rollendem 28-Tage-Fenster). Die QPU-Nutzung kann auf dem Platform-Dashboard und den Workloads-Seiten verfolgt werden.

Pay-As-You-Go Plan-Instanz​

Der Pay-As-You-Go Plan ist ein kostenpflichtiger Plan. Um diesen Plan zu nutzen, musst du eine Instanz erstellen und sie dem Plan zuweisen. Alle Workloads, die mit diesem Plan an QPUs gesendet werden, verursachen Kosten.

Die Jobs, die du ausführst, und die Jobs, die von anderen Mitarbeitern in derselben Instanz ausgeführt werden, zählen zur gemeldeten Nutzung für diese Instanz. Du kannst die Nutzung einer Instanz auf der Instances-Seite oder, für diejenigen mit entsprechender Berechtigung, auf der Analytics-Seite anzeigen. Beachte, dass die Seiten möglicherweise unterschiedliche Nutzungszahlen anzeigen, da die Instances-Seite die Nutzung in einem rollenden 28-Tage-Fenster vor dem aktuellen Zeitstempel anzeigt, während die Analytics-Seite vollständige Tagesgrenzen verwendet.

Wenn eine Instanz von deinem Administrator als "limited" markiert wurde (du siehst eine "Remaining"-Spalte im Nutzungsbereich) und die Instanz ihre Zuweisung (definiert von deinem Administrator) innerhalb des rollenden 28-Tage-Fensters überschreitet, wird jede aktive Workload weiterhin ausgeführt (einschließlich Sessions), aber ausstehende Workloads verbleiben in der Warteschlange, bis mehr Zeit verfügbar ist. Wenn eine Instanz nicht begrenzt ist und die Instanz ihre Zuweisung überschreitet, werden Jobs, die mit dieser Instanz ausgeführt werden, wahrscheinlich mit niedrigerer Priorität ausgeführt und erfahren längere Wartezeiten in der Warteschlange.

Eine Warnung wird bei der Nutzung einer Instanz angezeigt, wenn sie ihre Zuweisung überschritten hat.

Angabe einer Instanz in deinem Code​

Du kannst den CRN oder den Instanznamen verwenden, um eine zu verwendende Instanz anzugeben - entweder bei der Initialisierung des Service oder beim Senden der Workload an eine QPU (zum Beispiel mit QiskitRuntimeServicee.backend()). Anweisungen zur Angabe einer Instanz in deinem Code finden sich unter Initialisiere dein Konto.

Wenn eine Instanz übergeben wird, sind nur Backends und Jobs aus dieser Instanz verfügbar (erlaubt in Qiskit Runtime v0.40.1 und später).

Wenn beim Initialisieren des Service keine Instanz angegeben wird, sind alle Backends und Jobs über alle Instanzen in deinem Konto hinweg verfügbar. In diesem Fall wird, wenn ein Backend angegeben wird, eine Instanz gefunden und verwendet, die auf das Backend zugreifen kann, wie in Automatische Auswahl der Instanz beschrieben.

Erforderliche Versionen

Qiskit Runtime v0.40.1 oder später ist erforderlich für Folgendes:

  • Verwendung des Instanznamens zur Angabe einer Instanz
  • Keine Übergabe einer Instanz
  • Festlegen eines bevorzugten Instanztyps und einer Region

Für Qiskit Runtime v0.42 oder später werden kostenlose Pläne standardmäßig priorisiert, wenn die automatische Instanzauswahl verwendet wird.

Erstellen einer Instanz​

Befolge diese Schritte, um eine Instanz zu erstellen und sie zu deinem Konto hinzuzufügen. Wenn du ein Administrator bist, der Qiskit Runtime on Cloud für deine Organisation einrichten muss, lies Plane Qiskit Runtime für eine Organisation.

  1. Um eine Instanz zu deinem Konto hinzuzufügen, stelle zunächst sicher, dass du das richtige Konto und die richtige Region im Kontoumschalter im Header ausgewählt hast.

    • Du kannst mehrere IBM Cloud-Konten haben (oder Teil davon sein). Wenn du nicht die erwarteten Instanzen oder Jobs siehst, versuche ein anderes Konto.
    • Du kannst auf beide Regionen mit demselben API-Schlüssel zugreifen, aber du kannst nur die Instanzen sehen und darauf zugreifen, die in der Region erstellt wurden, in der du angemeldet bist.
    • Wenn du eine Open-Instanz erstellen möchtest, musst du die Region us-east wählen.

    The IBM Quantum Platform header is shown. The account switcher is immediately to the right of the search bar. The region switcher is immediately to the right of the account switcher.

    Über Regionen

    Die Instanz wird in der ausgewählten Region erstellt. Diese Region bestimmt diese wichtigen Eigenschaften:

    • Welche QPUs verfügbar sind.
    • Wo die klassische Berechnung der Jobs, wie z.B. Kompilierung, stattfindet.
    • Wo die Workflow-Daten des Benutzers verbleiben.

    Die Workflow-Daten umfassen die Eingabeschaltungen, Schaltungsparameter und Quantenberechnungsergebnisse. Sie umfassen keine Metadaten wie Anzahl der Shots, Größe der Schaltungen oder andere Job-Statistiken.

    Um die Offenlegung der Workflow-Daten des Benutzers gegenüber einer globalen Distributed Denial of Service-Schutzschicht zu vermeiden, kannst du Virtual Private Endpoints verwenden. qiskit-ibm-runtime unterstützt dies über den private_endpoint-Parameter.

  2. Klicke im Dashboard-Bereich "Instances" auf View all, oder gehe vom Hauptmenü zur Instances-Seite.

  3. Klicke auf der Instances-Seite auf Create instance.

  4. Wähle den Preisplan aus, mit dem diese Instanz verknüpft ist (zum Beispiel Pay-As-You-Go). Je nach ausgewähltem Preisplan kannst du weitere Optionen angeben, wie z.B. das Kostenlimit oder die Anzahl der Minuten, die dieser Instanz zugewiesen werden sollen. Beachte, dass Kosten anfallen, wenn diese Instanz nicht mit einem kostenlosen Plan verknüpft ist und zur Ausführung von Workloads verwendet wird.

  5. Klicke auf Next. Eine Liste der QPUs, auf die die Instanz zugreifen kann, wird angezeigt.

    • Wenn du möchtest, dass die Instanz Zugriff auf alle aufgelisteten QPUs hat (und alle QPUs, die diesem Plan in Zukunft hinzugefügt werden), klicke auf Next.
    • Wenn du keine Open-Instanz einrichtest, kannst du anpassen, auf welche QPUs mit dieser Instanz zugegriffen werden kann. Klicke auf den "Customize allocated compute resources"-Schalter. Wähle spezifische QPUs aus, auf die diese Instanz zugreifen kann, und klicke dann auf Next.
      hinweis

      Wenn du die zugewiesenen Rechenressourcen anpasst, werden die verfügbaren QPUs niemals automatisch aktualisiert, unabhängig von Änderungen am übergeordneten Plan. Du kannst jedoch später manuell QPUs hinzufügen oder entfernen. Wenn du sie nicht anpasst, hast du immer Zugriff auf jede QPU, auf die das Konto im Plan Zugriff hat. Wenn also in Zukunft eine neue QPU zum Plan hinzugefügt wird, hat die Instanz automatisch Zugriff darauf.

  6. Der Bereich "Access group" wird geöffnet. Eine "collaborators"-Zugriffsgruppe wird automatisch für diese Instanz erstellt. Benutzer, die dieser Zugriffsgruppe hinzugefügt werden, können die dieser Instanz zugewiesene Zeit nutzen. Du kannst Zugriffsgruppen ändern oder zusätzliche erstellen, indem du die IBM Cloud-Konsole verwendest. Siehe Einrichten von Zugriffsgruppen für Anweisungen.

  7. Klicke auf Create instance. Du kannst die Instanz jetzt auf der Instances-Seite anzeigen. Wenn du mehrere Pläne in deinem Konto eingerichtet hast, hat jeder Plantyp seine eigene Registerkarte in der Instances-Tabelle.

Bearbeiten einer Instanz und ihrer Zuweisung​

Suche die Instanz auf der Instances-Seite. Klicke auf das Überlaufmenü am Ende der Zeile der Instanz und wähle "Edit details".

hinweis

Nur Administratoren und Eigentümer können die Instanz bearbeiten. Siehe den Leitfaden Zugriffsrichtlinien und Zugriffsgruppen erstellen für Informationen zum Zuweisen von Zugriff.

Nächste Schritte​

Empfehlungen