Lumaktaw sa pangunahing nilalaman

I-save ang iyong mga login credential

Kung nagtatrabaho ka sa isang trusted na Python environment (tulad ng personal na laptop o workstation), maaari mong gamitin ang save_account() method para i-save ang iyong mga credential nang lokal, tapos gamitin ang mga ito para i-initialize ang serbisyo.

Mga Tala

Bago ka magsimula​

  1. Siguraduhin na mayroon kang IBM Cloud account.
  2. Siguraduhin na nagtatrabaho ka sa isang aktibong Python environment na may Qiskit SDK at Qiskit Runtime na naka-install.
  3. I-activate ang Python virtual environment at patakbuhin ang Python sa iyong virtual environment.
  4. Mag-login sa IBM Quantum Platform gamit ang IBMid o Google account.

Hanapin ang iyong mga access credential​

  1. Tiyaking napili ang tamang account at rehiyon sa account switcher sa header.
  2. Hanapin ang iyong API key. Mula sa dashboard, gumawa ng iyong API key, tapos kopyahin ito sa isang ligtas na lugar para magamit mo ito para sa authentication. Tandaan na maaari mong gamitin ang parehong API key para kumonekta sa anumang rehiyon.
  3. Opsyonal: Hanapin ang instance na gusto mong gamitin mula sa pahina ng Instances. I-hover ang cursor sa CRN nito, i-click ang icon para kopyahin ito, tapos i-save sa ligtas na lugar para magamit mo ito para matukoy ang instance.

I-save ang iyong mga access credential​

I-save ang iyong mga credential sa pamamagitan ng pagpapatakbo ng angkop na code nang isang beses bawat account na gusto mong i-save. Pagkatapos i-save ang iyong mga credential, i-load ang mga ito sa pamamagitan ng pagsunod sa mga hakbang sa I-initialize ang Qiskit Runtime service.

I-save ang mga credential na nag-a-access sa isang specific na instance:​

Kung mayroon kang maraming instance at gusto mong madaling sabihin sa Qiskit Runtime kung aling instance ang gagamitin, mag-save ng mga credential na naglalaman ng instance CRN.

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
)

I-save ang mga credential para sa awtomatikong pagpili ng instance:​

Kung hindi ka magbibigay ng instance CRN at ipapasa ang mga credential na ito sa Qiskit Runtime, pipiliin para sa iyo ang angkop na instance batay sa mga tinukoy na opsyon.

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
)

Mga available na opsyon​

  • token: IBM Cloud API key. Kumpidensyal ang iyong token. Huwag ibahagi ang iyong token sa pampublikong code.
  • instance: Opsyonal na tukuyin ang instance na gagamitin sa pamamagitan ng IBM Cloud CRN o pangalan ng instance nito.
  • plans_preference: Opsyonal na itakda ang mga uri ng plano na uunahin. Hindi ito pinapansin kung tinukoy na ang instance. Ang mga available na opsyon ay open, pay-as-you-go, flex, premium, at on-prem. Ang mga instance ng isang partikular na uri ng plano ay hindi kasama kung hindi tinukoy ang pangalan ng plano. Halimbawa, kung [open] ang ipinasa, available lang ang mga Open Plan instance. Hindi ito pinapansin kung tinukoy na ang instance.
  • region: Opsyonal na itakda ang rehiyong gagamitin. Ang mga tinatanggap na halaga ay us-east at eu-de. Hindi ito pinapansin kung tinukoy na ang instance.
  • tags: Opsyonal na tukuyin ang mga tag ng instance. Tumatanggap ng listahan ng mga string ng pangalan ng tag. Hindi ito pinapansin kung tinukoy na ang instance.
  • name: Opsyonal na pangalanan ang set ng mga account credential na ito.
  • set_as_default: Itakda ang halaga sa True para i-save ang mga ito bilang iyong default na mga credential. Kung isa lang ang account na iyong na-save, awtomatiko itong itinakda bilang default.
  • overwrite: Itakda ang halagang ito sa True para i-update ang iyong default na mga credential.

Mga Halimbawa​

Halimbawa 1​

Ang halimbawang ito ay nagse-save ng mga credential para sa mga specific na instance, na nagbibigay-daan sa open at premium na access. Ang open na mga credential ay itinakda bilang default.

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)

Halimbawa 2​

Ang halimbawang ito ay nagse-save ng mga credential para sa awtomatikong pagpili ng instance. Titingnan lang ng Qiskit Runtime ang mga premium instance sa rehiyong EU na available sa account. Ang mga credential na ito ang magiging bagong default.

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

Tingnan ang mga na-save na credential​

Para makita ang lahat ng credential na na-save mo, patakbuhin ang service.saved_accounts(). Tandaan na kung nag-save ka ng default na mga credential at hindi mo pinangalanan ang mga ito, ang pangalan nila ay default-ibm-quantum-platform. Kung pinangalanan mo ang iyong default na mga credential, makikita mo ang "is_default_account": true sa output.

Mga Konsiderasyon​

  • Kung nagse-save ka ng maraming account, gamitin ang parameter na name para makilala ang mga ito.
  • Ang mga credential ay nase-save sa $HOME/.qiskit/qiskit-ibm.json. Huwag manu-manong i-edit ang file na ito.
  • Kung hindi mo ise-save ang iyong mga credential, kailangan mong tukuyin ang mga ito sa bawat beses na magsisimula ka ng bagong session (pag-instantiate ng Qiskit Runtime service).
  • Kung manu-mano mong tinukoy ang iyong mga credential, hindi gagamitin ang na-save na account.

Mga Susunod na Hakbang

Mga Rekomendasyon