Creare e gestire istanze

L'accesso ai servizi di IBM Quantum Platform è controllato dalle istanze a cui si è assegnati. Gli utenti possono appartenere a più istanze.

Le istanze sono server virtuali (implementazioni del servizio di calcolo di IBM Quantum ) che gestiscono l'esecuzione dei carichi di lavoro, compresa l'esecuzione di programmi quantistici e attività di calcolo classico (come l'elaborazione per la mitigazione degli errori). Le istanze vengono identificate tramite il loro nome di risorsa cloud ( CRN ). Questo CRN può essere utilizzato per inviare carichi di lavoro dai propri programmi Qiskit.

È possibile vedere le istanze a cui si ha accesso nella dashboard o facendo clic sulla scheda "Istanze" dalla dashboard. Ogni istanza è elencata con il suo identificativo CRN.

È necessaria un'istanza diversa per ogni piano di servizio (come Open o Pay-As-You-Go) utilizzato in ogni regione che si desidera utilizzare. Il gestore dell'account e chiunque abbia sufficienti autorizzazioni può creare un'istanza e definirne la configurazione, come le allocazioni, i limiti di utilizzo, i computer quantici e le autorizzazioni degli utenti.

Il pannello di controllo di IBM Quantum Platform mostra le istanze a cui hai accesso. A seconda dei tuoi diritti di accesso, nella pagina Istanze puoi visualizzare tutti i dettagli, modificare ed eliminare le istanze.

È importante che tu sappia quale istanza stai utilizzando, poiché tutte le istanze non associate al piano Open comportano un costo (o vengono conteggiate nel tempo a tua disposizione previsto dal piano).

Istanza Open Plan

Gli utenti del piano Open Plan possono eseguire circuiti quantistici sulle migliori QPU al mondo gratuitamente (fino a 10 minuti per ogni periodo di 28 giorni). È possibile monitorare l'utilizzo della QPU nella dashboard della piattaforma e nelle pagine dedicate ai carichi di lavoro.

Istanza del piano Pay-As-You-Go

Il piano Pay-As-You-Go è un piano a pagamento. Per utilizzare questo piano, è necessario creare un'istanza e assegnarla al piano. Tutti i carichi di lavoro inviati alle QPU tramite questo piano sono soggetti a un costo. Le istanze con pagamento a consumo possono avere un limite di costo totale (facoltativo).

Istanza Flex Plan

Il piano Flex è un piano a pagamento. Per usufruire di questo piano, devi prima contattare IBM per registrarti. Quindi, crea un'istanza e assegnala al piano. Tutti i carichi di lavoro inviati alle QPU tramite questo piano vengono conteggiati nell'ambito dell'abbonamento assegnato.

Un amministratore può impostare un limite di utilizzo su un'istanza del Piano Flex che rimane valido per tutta la durata del contratto. Se un'istanza è stata contrassegnata come "limitata" dall'amministratore (nell'area di utilizzo sarà visibile una colonna "Rimanente") e l'istanza supera la propria quota (definita dall'amministratore), qualsiasi carico di lavoro attivo continuerà a essere eseguito (comprese le sessioni), ma i carichi di lavoro in sospeso rimarranno in coda fino a quando non sarà disponibile più tempo. Se un'istanza non è soggetta a limitazioni e supera la propria quota di risorse, i processi in esecuzione su tale istanza potrebbero essere elaborati con una priorità inferiore e subire tempi di attesa più lunghi.

Quando l'utilizzo di un'istanza supera la sua allocazione, viene visualizzato un avviso.

Istanza del piano Premium

Il piano Premium è un piano a pagamento. Per usufruire di questo piano, devi prima contattare IBM per registrarti. Quindi, crea un'istanza e assegnala al piano. Tutti i carichi di lavoro inviati alle QPU tramite questo piano vengono conteggiati nell'ambito dell'abbonamento assegnato.

Un amministratore può impostare un limite di utilizzo su un'istanza del Piano Premium che si applica al periodo di utilizzo di 28 giorni consecutivi previsto dal piano. Se un'istanza è stata contrassegnata come "limitata" dall'amministratore (nell'area di utilizzo sarà visibile una colonna "Rimanente") e l'istanza supera la propria quota (definita dall'amministratore), qualsiasi carico di lavoro attivo continuerà a essere eseguito (comprese le sessioni), ma i carichi di lavoro in sospeso rimarranno in coda fino a quando non sarà disponibile più tempo. Se un'istanza non è soggetta a limitazioni e supera la propria quota di risorse, i processi in esecuzione su tale istanza potrebbero essere elaborati con una priorità inferiore e subire tempi di attesa più lunghi.

Quando l'utilizzo di un'istanza supera la sua allocazione, viene visualizzato un avviso.

Specifica un'istanza nel tuo codice

È possibile utilizzare il CRN o il nome dell'istanza per specificare l'istanza da utilizzare, sia durante l'inizializzazione del servizio, sia quando si invia il carico di lavoro a una QPU (ad esempio, con \QiskitRuntimeService.backend() `). Per istruzioni su come specificare un'istanza nel codice, consultare la sezione "Inizializza il tuo account ".

Quando viene passata un'istanza, sono disponibili solo i backend e i job di quell'istanza (consentito in v0.40.1qiskit-ibm-runtime e versioni successive).

Se un'istanza non è inclusa durante l'inizializzazione del servizio, sono disponibili tutti i backend e i lavori su tutte le istanze del tuo account. In questo caso, quando viene specificato un backend, viene individuata un'istanza in grado di accedere al backend e utilizzata come descritto in Selezione automatica dell'istanza.

Crea un'istanza

Segui questi passaggi per creare un'istanza e aggiungerla al tuo account. Se sei un amministratore che deve configurare Quantum Compute on Cloud per la propria organizzazione, consulta la guida " Pianificazione di Quantum Compute per un'organizzazione ".

1. Per aggiungere un'istanza al vostro account, assicuratevi innanzitutto di aver selezionato l'account e la regione corretti nel selettore di account nell'intestazione.

   • È possibile avere (o far parte di) più account IBM Cloud. Se non si vedono le istanze o i lavori attesi, provare con un altro account.
   • È possibile accedere a entrambe le regioni utilizzando la stessa chiave API, ma è possibile vedere e accedere solo alle istanze create nella regione in cui si è effettuato l'accesso.
   • Se si desidera creare un'istanza Open, è necessario scegliere la regione USA-Est.

   

   Informazioni sulle regioni

   L'istanza verrà creata nella regione selezionata. Questa regione determina queste importanti caratteristiche:

   • Quali QPU sono disponibili.
   • Dove si svolgono i calcoli classici dei lavori, come la compilazione.
   • Dove rimangono i dati del flusso di lavoro dell'utente.

   I dati del flusso di lavoro comprendono i circuiti di ingresso, i parametri del circuito e i risultati della computazione quantistica. Non include metadati, come il numero di scatti, le dimensioni dei circuiti o altre statistiche sul lavoro.

   Per evitare l'esposizione dei dati del flusso di lavoro dell'utente a un livello di protezione Distributed Denial of Service globale, è possibile utilizzare Virtual Private Endpoint. qiskit-ibm-runtime lo supporta attraverso il parametro private_endpoint .

2. Nel riquadro Istanze del dashboard, fare clic su Visualizza tutto o andare alla pagina Istanze dal menu principale.

3. Dalla pagina Istanze, fare clic su Crea istanza.

   • Inserite un nome e aggiungete facoltativamente dei tag.
   • Se si ha accesso a più di un gruppo di risorse in IBM Cloud®, si può scegliere di cambiare il gruppo di risorse a cui appartiene questa istanza. Per ulteriori informazioni, vedere Gestione dei gruppi di risorse e Accesso alle risorse nei gruppi di risorse.

4. Seleziona il piano tariffario associato a questa istanza (ad esempio, Pay-As-You-Go). A seconda del piano tariffario scelto, è possibile specificare altre opzioni, come il limite di spesa o il numero di minuti da assegnare a questa istanza. Si noti che, se questa istanza non è associata a un piano gratuito, verrà addebitato un costo quando verrà utilizzata per eseguire carichi di lavoro.

5. Fare clic su Avanti. Viene mostrato un elenco delle QPU a cui l'istanza può accedere.

   • Se si desidera che l'istanza abbia accesso a tutte le QPU elencate (e a tutte le QPU aggiunte a questo piano in futuro), fare clic su Avanti.
   • Se non si sta impostando un'istanza aperta, è possibile personalizzare le QPU a cui si può accedere con questa istanza. Fare clic sulla levetta "Personalizza le risorse di calcolo allocate". Selezionare le QPU specifiche a cui questa istanza può accedere, quindi fare clic su Avanti.
     Note

     Se si personalizzano le risorse di calcolo allocate, le QPU disponibili non verranno mai aggiornate automaticamente, indipendentemente dalle modifiche apportate al piano padre. Tuttavia, è possibile aggiungere o rimuovere manualmente le QPU in un secondo momento. Se non li si personalizza, si avrà sempre accesso a qualsiasi QPU a cui l'account ha accesso sul piano. Quindi, se in futuro verrà aggiunta una nuova QPU al piano, l'istanza vi avrà automaticamente accesso.

6. Si apre il riquadro del gruppo Accesso. Per questa istanza viene creato automaticamente un gruppo di accesso "collaboratori". Gli utenti aggiunti a questo gruppo di accesso possono utilizzare il tempo assegnato a questa istanza. È possibile modificare o creare gruppi di accesso aggiuntivi utilizzando la console IBM Cloud. Per istruzioni, consultare Impostazione dei gruppi di accesso.

7. Fare clic su Crea istanza. Ora è possibile visualizzare l'istanza nella pagina Istanze. Se sono stati impostati più piani sul proprio account, ogni tipo di piano ha una propria scheda nella tabella Istanze.

Modifica un'istanza e la sua allocazione

Trovare l'istanza nella pagina Istanze. Fare clic sul menu a comparsa alla fine della riga dell'istanza e selezionare Modifica dettagli.

Istanze archiviate

Un'istanza archiviata è il risultato di uno dei seguenti scenari.

Un utente privilegiato ha archiviato l'account

Un utente con privilegi sufficienti per l'account ha archiviato l'istanza.

• Tutti i lavori in sospeso nell'istanza vengono annullati.
• Le istanze archiviate vengono visualizzate in una sezione separata denominata "Archivio" nella pagina Istanze.
• I lavori possono ancora essere recuperati.
• Gli utenti non possono inviare nuovi lavori all'istanza archiviata.
• L'istanza archiviata non viene conteggiata nell'allocazione del tuo piano.
• Un utente con privilegi sufficienti può riattivare in qualsiasi momento un'istanza che lui stesso (o un altro utente con privilegi) ha archiviato.

Per archiviare un'istanza che gestisci, vai alla pagina Istanze. Alla fine della riga relativa a quell'istanza, clicca sul menu a tre puntini sulla destra, quindi seleziona Archivia istanza.

L'account non ha più accesso al piano dell'istanza

L'account non ha più accesso al piano in base al quale è stata creata l'istanza.

• Le istanze archiviate vengono visualizzate in una sezione separata denominata "Archivio" nella pagina Istanze.
• I lavori possono ancora essere recuperati.
• Gli utenti non possono inviare nuovi lavori all'istanza archiviata.
• L'istanza archiviata non viene conteggiata nell'allocazione del tuo piano.
• Le istanze che sono state archiviate perché non hanno più visibilità sul piano dell'istanza non possono essere riattivate.

Passi successivi