Virtuelle private Endpunkte für VPC nutzen, um eine private Verbindung zur IBM Quantum Platform herzustellen

Nutze Virtual Private Endpoints (VPE) für Virtual Private Cloud (VPC), um aus deinem VPC-Netzwerk eine Verbindung zu IBM Quantum® herzustellen. Die Verbindung nutzt die von dir angegebene IP-Adresse, die aus einem Subnetz innerhalb deines VPC zugewiesen wird.

VPEs sind virtuelle IP-Schnittstellen, die an ein Endpoint-Gateway gebunden sind, das pro Service erstellt wird. Das Endpoint-Gateway ist eine virtualisierte Funktion, die horizontal skaliert, redundant und hochverfügbar ist und alle Verfügbarkeitszonen deines VPC umspannt. Endpoint-Gateways ermöglichen die Kommunikation zwischen virtuellen Server-Instanzen innerhalb deines VPC und dem IBM Cloud®-Service über das private Backbone-Netzwerk. VPE für VPC ermöglicht dir die vollständige Kontrolle über die private Adressierung in deiner Cloud. Weitere Informationen findest du unter About virtual private endpoint gateways.

Unabhängig davon, ob du VPEs verwendest, nutzt die gesamte interne Kommunikation innerhalb des Netzwerks der IBM Quantum Platform stets private Verbindungen statt des öffentlichen Internets.

Ob deine Verbindung zur IBM Quantum Platform selbst öffentlich oder privat ist, hängt davon ab, ob du einen VPE verwendest. Verbindungen über die öffentlichen Endpunkte übertragen alle Anfrage- und Antwortdaten über das öffentliche Internet. Verbindungen über einen VPE halten diesen Datenverkehr stattdessen im privaten Netzwerk.

VPEs werden nur für die IBM Quantum Platform API und das SDK unterstützt, wie in den folgenden Abschnitten beschrieben. Die IBM Quantum Platform-Website unterstützt keine VPEs und kann nur über das öffentliche Netzwerk aufgerufen werden.

Bevor du beginnst

Bevor du einen VPE für IBM Quantum Platform verwendest, führe die folgenden Schritte aus:

• Erstelle eine Virtual Private Cloud.

• Plane die Netzwerktopologie für die Verbindung zu VPEs.

• Lege Zugriffskontrollen fest für deinen VPE.

• Mache dich mit den Dienstbeschränkungen vertraut.

• Erfahre, wie du VPE-Details anzeigst.

Einen VPE für IBM Quantum Platform einrichten

Es gibt mehrere Möglichkeiten, ein VPE-Gateway zu erstellen. Wenn du die CLI oder die API verwendest, musst du den Cloud Resource Name (CRN) der Region angeben, in der du dich mit der IBM Quantum Platform verbinden möchtest. Die verfügbaren Regionen und CRNs findest du in der folgenden Tabelle.

Region	Pläne	Fully Qualified Domain Name (FQDN)	Cloud Resource Name (CRN)
us-east	Standard	private.us-east.quantum.cloud.ibm.com	crn:v1:bluemix:public:quantum-computing:us-east:::endpoint:private.us-east.quantum.cloud.ibm.com
eu-de	Standard	private.eu-de.quantum.cloud.ibm.com	crn:v1:bluemix:public:quantum-computing:eu-de:::endpoint:private.eu-de.quantum.cloud.ibm.com

Ein Endpoint-Gateway konfigurieren

Um ein VPE-Gateway zu konfigurieren, führe die folgenden Schritte aus:

1. Liste die verfügbaren Services auf, einschließlich der IBM Cloud-Infrastrukturservices, die (standardmäßig) für alle VPC-Nutzer verfügbar sind.

2. Erstelle ein Endpoint-Gateway für IBM Quantum Platform, das im VPC privat verfügbar sein soll.

3. Binde eine reservierte IP-Adresse an das Endpoint-Gateway.

4. Zeige die erstellten VPE-Gateways an, die mit IBM Quantum Platform verknüpft sind.

Deine virtuellen Server-Instanzen im VPC können jetzt privat auf deine IBM Quantum Platform-Instanz zugreifen.

Den VPE für IBM Quantum Platform verwenden

Nachdem du ein Endpoint-Gateway für IBM Quantum Platform erstellt hast, führe die folgenden Schritte aus:

Den VPE mit qiskit-ibm-runtime (Python SDK) verwenden

hinweis

Die VPE-Unterstützung erfordert qiskit-ibm-runtime v0.24.0 oder höher.

Gib beim Instanziieren von QiskitRuntimeService den Parameter private_endpoint=True an.

# For `token`, use the 44-character API_KEY you created 
# and saved from the IBM Quantum Platform Home dashboard
service = QiskitRuntimeService(token="your-API_KEY", 
                              instance="INSTANCE_CRN",
                              channel="ibm_cloud",
                              private_endpoint=True)

Den VPE mit der IBM Quantum API verwenden

Nachdem du ein Endpoint-Gateway für IBM Quantum Platform erstellt hast, verwende den vollqualifizierten Domainnamen (FQDN) des Service-Endpunkts für die Zielregion aus der vorherigen Tabelle.

  curl -X POST \
  https://private.us-east.quantum.cloud.ibm.com/api/v1/jobs \
  -H "Authorization: Bearer $BEARER_TOKEN" \
  -H "Service-CRN: $SERVICE_INSTANCE_CRN" \
  -d '{
    "backend": "backend",
    "program_id": "sampler"
  }'