Salvează-ți datele de autentificare

Dacă lucrezi într-un mediu Python de încredere (cum ar fi un laptop personal sau o stație de lucru), poți folosi metoda save_account() pentru a-ți salva datele de autentificare local, apoi să le folosești pentru a inițializa serviciul.

Note

• Dacă folosești un computer public sau un alt mediu neîncredibil, urmează instrucțiunile din Inițializează serviciul într-un mediu neîncredibil.
• Urmează aceste instrucțiuni dacă vrei să te conectezi folosind REST API în loc de Qiskit.
• Dacă este necesar, folosește aceste informații pentru a configura firewall-ul și a permite accesul la endpoint-urile IBM Quantum API.

Înainte de a începe

1. Asigură-te că ai un cont IBM Cloud.
2. Asigură-te că lucrezi într-un mediu Python activ cu Qiskit SDK și Qiskit Runtime instalate.
3. Activează mediul virtual Python și rulează Python în mediul tău virtual.
4. Autentifică-te pe IBM Quantum Platform cu un cont IBMid sau Google.

Găsește-ți datele de acces

1. Asigură-te că în selectorul de conturi din antet sunt selectate contul și regiunea corecte.
2. Găsește-ți cheia API. Din tabloul de bord, creează cheia ta API, apoi copiaz-o într-un loc sigur pentru a o putea folosi la autentificare. Reține că poți folosi aceeași cheie API pentru a te conecta la orice regiune.
3. Opțional: Găsește instanța pe care vrei să o folosești din pagina Instances. Treci cu cursorul peste CRN-ul ei, fă clic pe pictogramă pentru a o copia, apoi salveaz-o într-un loc sigur pentru a o putea folosi la identificarea instanței.

Salvează-ți datele de acces

Salvează-ți datele de autentificare rulând codul corespunzător o singură dată pentru fiecare cont pe care vrei să îl salvezi. După salvarea datelor de autentificare, încarcă-le urmând pașii din Inițializează serviciul Qiskit Runtime.

Salvează datele de autentificare pentru accesarea unei instanțe specifice:

Dacă ai mai multe instanțe și vrei să îi spui ușor serviciului Qiskit Runtime pe care instanță să o folosească, salvează datele de autentificare care includ un CRN de instanță.

from qiskit_ibm_runtime import QiskitRuntimeService

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

Salvează datele de autentificare pentru selecția automată a instanței:

Dacă nu furnizezi un CRN de instanță și transmiți aceste date de autentificare către Qiskit Runtime, o instanță corespunzătoare va fi aleasă automat pentru tine, pe baza opțiunilor specificate.

from qiskit_ibm_runtime import QiskitRuntimeService

QiskitRuntimeService.save_account(
  token="<your=api-key>", # Use the 44-character API_KEY you created and saved from the IBM Quantum Platform Home dashboard
  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
)

Opțiuni disponibile

• token: Cheia API IBM Cloud. Token-ul tău este confidențial. Nu îți distribui token-ul în cod public.
• instance: Opțional, specifică instanța de utilizat prin CRN-ul său IBM Cloud sau numele instanței.
• plans_preference: Opțional, setează tipurile de planuri cărora să li se acorde prioritate. Această opțiune este ignorată dacă instanța este specificată. Opțiunile disponibile sunt open, pay-as-you-go, flex, premium și on-prem. Instanțele de un anumit tip de plan sunt excluse dacă numele planului nu este specificat. De exemplu, dacă se transmite [open], sunt disponibile doar instanțele Open Plan. Această opțiune este ignorată dacă instance este specificat.
• region: Opțional, setează regiunea de utilizat. Valorile acceptate sunt us-east și eu-de. Această opțiune este ignorată dacă instance este specificat.
• tags: Opțional, specifică etichetele instanței. Acceptă o listă de șiruri cu numele etichetelor. Această opțiune este ignorată dacă instance este specificat.
• name: Opțional, denumește acest set de date de autentificare ale contului.
• set_as_default: Setează valoarea la True pentru a le salva ca date de autentificare implicite. Dacă salvezi un singur cont, acesta este setat automat ca implicit.
• overwrite: Setează această valoare la True pentru a-ți actualiza datele de autentificare implicite.

Exemple

Exemplul 1

Acest exemplu salvează datele de autentificare pentru instanțe specifice, care permit accesul open și premium. Datele de autentificare open sunt setate ca implicite.

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)

Exemplul 2

Acest exemplu salvează datele de autentificare pentru selecția automată a instanței. Qiskit Runtime va lua în considerare doar instanțele premium din regiunea EU care sunt disponibile pentru cont. Aceste date de autentificare devin noul implicit.

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"]
  )

Vizualizează datele de autentificare salvate

Pentru a vizualiza toate datele de autentificare pe care le-ai salvat, rulează service.saved_accounts(). Reține că, dacă ai salvat date de autentificare implicite fără să le denumești, acestea se numesc default-ibm-quantum-platform. Dacă ți-ai denumit datele de autentificare implicite, vei vedea "is_default_account": true în rezultat.

Considerații

• Dacă salvezi mai multe conturi, folosește parametrul name pentru a le diferenția.
• Datele de autentificare sunt salvate în $HOME/.qiskit/qiskit-ibm.json. Nu edita manual acest fișier.
• Dacă nu îți salvezi datele de autentificare, trebuie să le specifici de fiecare dată când pornești o sesiune nouă (instanțiezi serviciul Qiskit Runtime).
• Dacă îți specifici manual datele de autentificare, un cont salvat nu va fi folosit.

Pașii următori

Recomandări

• Inițializează serviciul Qiskit Runtime într-un mediu Python de încredere.
• Inițializează serviciul Qiskit Runtime într-un mediu neîncredibil.
• Vizualizează QPU-urile disponibile.
• Configurează Qiskit SDK local.
• Urmează pașii din Hello world pentru a scrie și rula un program cuantic.
• Configurează utilizarea IBM Quantum Platform cu REST API.
• Încearcă un tutorial.