Vai al contenuto principale

Creare e gestire le istanze

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

Le istanze sono server virtuali (distribuzioni di Qiskit Runtime) che gestiscono l'esecuzione dei tuoi workload, inclusa l'esecuzione di programmi quantistici e attività di calcolo classico (come l'elaborazione della mitigazione degli errori). Le istanze sono identificate dal loro Cloud Resource Name (CRN). Questo CRN può essere utilizzato quando si inviano workload dai tuoi programmi Qiskit.

Puoi vedere le istanze a cui hai accesso nella dashboard, oppure facendo clic sulla scheda "Instances" dalla dashboard. Ogni istanza è elencata con il suo identificatore CRN.

Hai bisogno di un'istanza diversa per ogni piano di servizio (ad esempio Open o Pay-As-You-Go) che usi in ogni regione che vuoi utilizzare. Il gestore dell'account e chiunque abbia le autorizzazioni sufficienti può creare un'istanza e definirne la configurazione, come le allocazioni, i limiti di utilizzo, i computer quantistici e le autorizzazioni degli utenti.

La dashboard di IBM Quantum Platform mostra le istanze a cui hai accesso. A seconda del tuo livello di accesso, puoi visualizzare i dettagli completi, modificare ed eliminare le istanze nella pagina Instances.

È importante capire quale istanza stai utilizzando, perché tutte le istanze non associate al piano Open comportano un costo.

Istanza del piano Open​

Gli utenti del piano Open possono eseguire circuiti quantistici sui migliori QPU al mondo gratuitamente (fino a 10 minuti di tempo quantistico per finestra mobile di 28 giorni). L'utilizzo dei QPU può essere monitorato nella dashboard della piattaforma e nelle pagine Workloads.

Istanza del piano Pay-As-You-Go​

Il piano Pay-As-You-Go è un piano a pagamento. Per utilizzare questo piano, devi creare un'istanza e assegnarla al piano. Tutti i workload inviati ai QPU tramite questo piano comportano un addebito.

I job che esegui e quelli eseguiti da altri collaboratori nella stessa istanza vengono conteggiati nell'utilizzo dichiarato per quell'istanza. Puoi visualizzare l'utilizzo di un'istanza nella pagina Instances oppure, per chi dispone delle autorizzazioni appropriate, nella pagina Analytics. Nota che le pagine potrebbero mostrare numeri di utilizzo diversi: la pagina Instances mostra l'utilizzo in una finestra mobile di 28 giorni precedente al timestamp corrente, mentre la pagina Analytics usa confini di giorno interi.

Se un'istanza è stata contrassegnata come "limitata" dal tuo amministratore (vedrai una colonna "Remaining" nell'area di utilizzo) e l'istanza supera la sua allocazione (definita dall'amministratore) all'interno della finestra mobile di 28 giorni, qualsiasi workload attivo continuerà a essere eseguito (incluse le sessioni), ma i workload in attesa rimarranno in coda finché non sarà disponibile altro tempo. Se un'istanza non è limitata e supera la sua allocazione, i job eseguiti con quell'istanza verranno probabilmente eseguiti con priorità inferiore e tempi di coda più lunghi.

Un avviso viene visualizzato nell'utilizzo di un'istanza quando supera la sua allocazione.

Specificare un'istanza nel codice​

Puoi usare il CRN o il nome dell'istanza per specificare un'istanza da utilizzare — sia durante l'inizializzazione del servizio, sia quando invii il workload a un QPU (ad esempio con `QiskitRuntimeServicee.backend()). Per le istruzioni su come specificare un'istanza nel codice, consulta Inizializzare il tuo account.

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

Se non viene inclusa un'istanza durante l'inizializzazione del servizio, tutti i backend e i job di tutte le istanze nel tuo account sono disponibili. In questo caso, quando viene specificato un backend, viene trovata e utilizzata un'istanza che può accedere al backend, come descritto in Selezionare automaticamente l'istanza.

Versioni richieste

Qiskit Runtime v0.40.1 o versione successiva è richiesta per:

  • Usare il nome dell'istanza per specificare un'istanza
  • Non passare un'istanza
  • Impostare un tipo di istanza e una regione preferiti

Per Qiskit Runtime v0.42 o versione successiva, i piani gratuiti sono prioritari per impostazione predefinita quando viene utilizzata la selezione automatica dell'istanza.

Creare un'istanza​

Segui questi passaggi per creare un'istanza e aggiungerla al tuo account. Se sei un amministratore che deve configurare Qiskit Runtime su Cloud per la tua organizzazione, consulta Pianificare Qiskit Runtime per un'organizzazione.

  1. Per aggiungere un'istanza al tuo account, assicurati prima di avere il corretto account e la regione corretta selezionati nel selettore account nell'intestazione.

    • Puoi avere (o far parte di) più account IBM Cloud. Se non vedi le istanze o i job che ti aspetti, prova con un account diverso.
    • Puoi accedere a entrambe le regioni usando la stessa chiave API, ma puoi vedere e accedere solo alle istanze create nella regione in cui sei connesso.
    • Se vuoi creare un'istanza Open, devi scegliere la regione us-east.

    Viene mostrata l'intestazione di IBM Quantum Platform. Il selettore account si trova immediatamente a destra della barra di ricerca. Il selettore regione si trova immediatamente a destra del selettore account.

    Informazioni sulle regioni

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

    • Quali QPU sono disponibili.
    • Dove avviene il calcolo classico dei job, come la compilazione.
    • Dove rimangono i dati del workflow dell'utente.

    I dati del workflow includono i circuiti di input, i parametri dei circuiti e i risultati del calcolo quantistico. Non includono i metadati, come il numero di shot, la dimensione dei circuiti o altre statistiche dei job.

    Per evitare l'esposizione dei dati del workflow dell'utente a un livello globale di protezione Distributed Denial of Service, puoi usare i Virtual Private Endpoints. qiskit-ibm-runtime supporta questo tramite il parametro private_endpoint.

  2. Dal pannello Instances della dashboard, fai clic su View all, oppure vai alla pagina Instances dal menu principale.

  3. Dalla pagina Instances, fai clic su Create instance.

  4. Seleziona il piano tariffario a cui è associata questa istanza (ad esempio, Pay-As-You-Go). A seconda del piano tariffario selezionato, puoi specificare altre opzioni, come il limite di costo o il numero di minuti da allocare a questa istanza. Nota che se questa istanza non è associata a un piano gratuito, verrà addebitato un costo quando l'istanza viene usata per eseguire workload.

  5. Fai clic su Next. Viene mostrato un elenco dei QPU a cui l'istanza può accedere.

    • Se vuoi che l'istanza abbia accesso a tutti i QPU elencati (e a tutti i QPU aggiunti a questo piano in futuro), fai clic su Next.
    • Se non stai configurando un'istanza open, puoi personalizzare a quali QPU si può accedere con questa istanza. Fai clic sul toggle "Customize allocated compute resources". Seleziona i QPU specifici a cui questa istanza può accedere, poi fai clic su Next.
      nota

      Se personalizzi le risorse di calcolo allocate, i QPU disponibili non verranno mai aggiornati automaticamente, indipendentemente dalle modifiche apportate al piano padre. Tuttavia, puoi aggiungere o rimuovere QPU manualmente in seguito. Se non li personalizzi, avrai sempre accesso a qualsiasi QPU a cui l'account ha accesso nel piano. Quindi, se in futuro viene aggiunto un nuovo QPU al piano, l'istanza vi avrà automaticamente accesso.

  6. Si apre il pannello Access group. Viene automaticamente creato un gruppo di accesso "collaborators" per questa istanza. Gli utenti aggiunti a questo gruppo di accesso possono utilizzare il tempo allocato a questa istanza. Puoi modificare o creare gruppi di accesso aggiuntivi usando la console IBM Cloud. Consulta Configurare i gruppi di accesso per le istruzioni.

  7. Fai clic su Create instance. Ora puoi visualizzare l'istanza nella pagina Instances. Se hai configurato più piani nel tuo account, ogni tipo di piano ha la propria scheda nella tabella Instances.

Modificare un'istanza e la sua allocazione​

Trova l'istanza nella pagina Instances. Fai clic sul menu overflow alla fine della riga dell'istanza e seleziona Edit details.

nota

Solo gli amministratori e i proprietari possono modificare l'istanza. Consulta la guida Creare policy di accesso e gruppi di accesso per informazioni sull'assegnazione degli accessi.

Passi successivi​

Raccomandazioni