Usa gli endpoint privati virtuali per VPC per connetterti privatamente a IBM Quantum Platform

Usa i Virtual Private Endpoints (VPE) per Virtual Private Cloud (VPC) per connetterti a IBM Quantum® dalla tua rete VPC. La connessione usa l'indirizzo IP che specifichi tu, allocato da una sottorete all'interno del tuo VPC.

I VPE sono interfacce IP virtuali associate a un endpoint gateway creato su base per-servizio. L'endpoint gateway è una funzione virtualizzata che scala orizzontalmente, è ridondante e ad alta disponibilità, e copre tutte le zone di disponibilità del tuo VPC. Gli endpoint gateway abilitano le comunicazioni dalle istanze di server virtuali all'interno del tuo VPC e il servizio IBM Cloud® sul backbone privato. VPE per VPC ti permette di controllare tutto l'indirizzamento privato all'interno del tuo cloud. Per maggiori informazioni, consulta Informazioni sugli endpoint gateway privati virtuali.

Indipendentemente dal fatto che tu usi i VPE, tutte le comunicazioni all'interno della rete di IBM Quantum Platform usano sempre connessioni private anziché la rete internet pubblica.

Il fatto che la tua connessione a IBM Quantum Platform stessa sia pubblica o privata dipende dal fatto che tu usi o meno un VPE. Connettersi tramite gli endpoint pubblici trasmette tutti i dati di richiesta e risposta sulla rete internet pubblica. Connettersi tramite un VPE mantiene invece quel traffico sulla rete privata.

I VPE sono supportati solo per l'API e l'SDK di IBM Quantum Platform, come descritto nelle sezioni seguenti. Il sito web di IBM Quantum Platform non supporta i VPE ed è accessibile solo tramite la rete pubblica.

Prima di iniziare

Prima di usare un VPE per IBM Quantum Platform, completa i seguenti passaggi:

• Crea un Virtual Private Cloud.

• Pianifica la topologia di rete per connetterti ai VPE.

• Imposta i controlli di accesso per il tuo VPE.

• Comprendi le restrizioni del servizio.

• Scopri come visualizzare i dettagli del VPE.

Configura un VPE per IBM Quantum Platform

Ci sono diversi modi per creare un gateway VPE. Se usi la CLI o l'API, devi specificare il Cloud Resource Name (CRN) della regione in cui vuoi connetterti a IBM Quantum Platform. Consulta la tabella seguente per le regioni e i CRN disponibili.

Regione	Piani	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

Configurazione di un endpoint gateway

Per configurare un gateway VPE, segui questi passaggi:

1. Elenca i servizi disponibili, inclusi i servizi di infrastruttura IBM Cloud disponibili (per impostazione predefinita) per tutti gli utenti VPC.

2. Crea un endpoint gateway per IBM Quantum Platform che vuoi rendere accessibile privatamente al VPC.

3. Associa un indirizzo IP riservato all'endpoint gateway.

4. Visualizza i gateway VPE creati associati a IBM Quantum Platform.

Ora le tue istanze di server virtuali nel VPC possono accedere privatamente alla tua istanza di IBM Quantum Platform.

Usa il tuo VPE per IBM Quantum Platform

Dopo aver creato un endpoint gateway per IBM Quantum Platform, segui questi passaggi:

Usa il VPE con qiskit-ibm-runtime (Python SDK)

nota

Il supporto VPE richiede qiskit-ibm-runtime v0.24.0 o versioni successive.

Quando istanzi QiskitRuntimeService, specifica private_endpoint=True.

# 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)

Usa il VPE con l'API IBM Quantum

Dopo aver creato un endpoint gateway per IBM Quantum Platform, usa il nome di dominio completo (FQDN) dell'endpoint di servizio per la regione di destinazione dalla tabella precedente.

  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"
  }'