Salvare le credenziali di accesso

Se si lavora in un ambiente Python fidato (ad esempio su un computer portatile o una workstation personale), si può usare il metodo save_account() per salvare le credenziali in locale e poi usarle per inizializzare il servizio.

Prima di iniziare

1. Assicurati di lavorare in un ambiente Python attivo con i pacchetti qiskit-ibm-runtime e qiskit installati.
2. Attivare l'ambiente virtuale Python ed eseguire Python nell'ambiente virtuale.
3. Accedi al sito IBM Quantum Platform.

Trova le tue credenziali di accesso

1. Assicuratevi che il conto e la regione corretti siano selezionati nel selettore dei conti nell'intestazione.
2. Trovate la vostra chiave API. Dalla dashboard, creare la chiave API e copiarla in un luogo sicuro per poterla utilizzare per l'autenticazione. Si noti che è possibile utilizzare la stessa chiave API per connettersi a qualsiasi regione.
3. Facoltativo: Individuare l'istanza che si desidera utilizzare dalla pagina Istanze. Passare il mouse sul CRN, fare clic sull'icona per copiarlo e salvarlo in un luogo sicuro per poterlo utilizzare per identificare l'istanza.

Salva le tue credenziali di accesso

Salva le tue credenziali eseguendo il codice appropriato una volta per ogni account che desideri salvare. Dopo aver salvato le credenziali, caricale seguendo la procedura descritta nella sezione " Inizializzazione del servizio di computazione IBM Quantum ".

Salva le credenziali che accedono a un'istanza specifica:

Se disponi di più istanze e desideri indicare facilmente a Quantum Compute quale istanza utilizzare, salva le credenziali che includono l' CRN dell'istanza.

from qiskit_ibm_runtime import QiskitRuntimeService

QiskitRuntimeService.save_account(
  # For `token`, use the 44-character API_KEY you created 
  # and saved from the IBM Quantum Platform Home dashboard:
  token="<your-api-key>", 
  name="<account-name>", # Optional
  instance="<IBM Cloud CRN or instance name>", # Optional
  set_as_default=True, # Optional
  overwrite=True, # Optional
)

Salva le credenziali per la selezione automatica dell'istanza:

Se non si specifica un'istanza CRN e non si trasmettono tali credenziali a Quantum Compute, verrà selezionata automaticamente un'istanza adeguata in base alle opzioni specificate.

from qiskit_ibm_runtime import QiskitRuntimeService

QiskitRuntimeService.save_account(
  # For `token`, use the 44-character API_KEY you created 
  # and saved from the IBM Quantum Platform Home dashboard:
  token="<your=api-key>", 
  name="<account-name>", # Optional
  instance="<instance-to-use>", # Optional
  plans_preference="<plan_types>", # Optional
  region="<region>", # Optional
  tags="<instance-tags>", # Optional
  set_as_default=True, # Optional
  overwrite=True, # Optional
)

Opzioni disponibili

• token: IBM Cloud Chiave API. Il vostro token è riservato. Non condividete il vostro token nel codice pubblico.
• instance: Specificare facoltativamente l'istanza da utilizzare attraverso il CRN IBM Cloud o il nome dell'istanza.
• plans_preference: Impostare facoltativamente i tipi di piani a cui dare priorità. Questo viene ignorato se l'istanza è specificata. Le opzioni disponibili sono open, pay-as-you-go, flex, premium e on-prem. Le istanze di un determinato tipo di piano sono escluse se il nome del piano non è specificato. Ad esempio, se si inserisce [open] è stato inserito, sono disponibili solo le istanze di Open Plan. Questo viene ignorato se viene specificato instance .
• region: Imposta facoltativamente la regione da utilizzare. I valori accettati sono us-east e eu-de. Questo viene ignorato se viene specificato instance .
• tags: Specificare facoltativamente i tag dell'istanza. Accetta un elenco di stringhe di nomi di tag. Questo viene ignorato se viene specificato instance .
• name: Denominazione facoltativa di questo set di credenziali dell'account.
• set_as_default: Impostare il valore su True per salvare queste credenziali come predefinite. Se si salva un solo account, questo viene automaticamente impostato come predefinito.
• overwrite: Impostare questo valore su True per aggiornare le credenziali predefinite.

Esempi

Esempio 1

Questo esempio salva le credenziali per istanze specifiche, che consentono l'accesso aperto e premium. Le credenziali aperte sono impostate come predefinite.

from qiskit_ibm_runtime import QiskitRuntimeService

QiskitRuntimeService.save_account(token="<API_TOKEN>", 
                                  instance="<CRN_for_premium_instance>",
                                  name="premium")
QiskitRuntimeService.save_account(token="<API_TOKEN>", 
                                  instance="<CRN_for_open_instance>",
                                  name="open", set_as_default=True)

Esempio 2

Questo esempio salva le credenziali per la selezione automatica dell'istanza. Quantum Compute prenderà in considerazione solo le istanze premium nella regione UE disponibili per l'account. Queste credenziali diventano il nuovo valore predefinito.

QiskitRuntimeService.save_account(
    token="your-api-key",
    set_as_default=True,
    overwrite = True,

    # Set instance "filters" instead of specifying the instance:
    region="eu-de",
    plans_preference=["premium"]
  )

Visualizza credenziali salvate

Per visualizzare tutte le credenziali salvate, eseguire service.saved_accounts(). Si noti che se si sono salvate le credenziali predefinite senza assegnare loro un nome, esse sono denominate default-ibm-quantum-platform. Se si è dato un nome alle credenziali predefinite, si vedrà "is_default_account": true nell'output.

Considerazioni

• Se si salvano più conti, utilizzare il parametro name per differenziarli.
• Le credenziali vengono salvate in $HOME/.qiskit/qiskit-ibm.json. Non modificare manualmente questo file.
• Se non si salvano le credenziali, è necessario specificarle ogni volta che si avvia una nuova sessione (si avvia un'istanza del servizio Compute di IBM Quantum ).
• Se si specificano manualmente le credenziali, non verrà utilizzato un account salvato.

Passi successivi