ข้ามไปยังเนื้อหาหลัก

บันทึกข้อมูลการเข้าสู่ระบบของคุณ

หากคุณทำงานในสภาพแวดล้อม Python ที่เชื่อถือได้ (เช่น บนแล็ปท็อปส่วนตัวหรือเวิร์กสเตชัน) คุณสามารถใช้เมธอด save_account() เพื่อบันทึกข้อมูลการเข้าสู่ระบบของคุณในเครื่อง แล้วใช้เพื่อเริ่มต้นบริการได้

หมายเหตุ

ก่อนเริ่มต้น​

  1. ตรวจสอบว่าคุณมีบัญชี IBM Cloud
  2. ตรวจสอบว่าคุณทำงานในสภาพแวดล้อม Python ที่ใช้งานอยู่พร้อมติดตั้ง Qiskit SDK และ Qiskit Runtime แล้ว
  3. เปิดใช้งาน Python virtual environment แล้วรัน Python ในสภาพแวดล้อม virtual ของคุณ
  4. ล็อกอินเข้าสู่ IBM Quantum Platform ด้วย IBMid หรือบัญชี Google

ค้นหาข้อมูลการเข้าสู่ระบบของคุณ​

  1. ตรวจสอบว่าเลือกบัญชีและภูมิภาคที่ถูกต้องใน account switcher ในส่วนหัว
  2. ค้นหา API key ของคุณ จากแดชบอร์ด สร้าง API key ของคุณ แล้วคัดลอกไปไว้ในที่ปลอดภัยเพื่อใช้สำหรับการยืนยันตัวตน โปรดสังเกตว่าคุณสามารถใช้ API key เดียวกันในการเชื่อมต่อกับทุกภูมิภาคได้
  3. ตัวเลือก: ค้นหา instance ที่ต้องการใช้จากหน้า Instances วางเมาส์เหนือ CRN คลิกไอคอนเพื่อคัดลอก แล้วบันทึกในที่ปลอดภัยเพื่อใช้ระบุ instance

บันทึกข้อมูลการเข้าสู่ระบบของคุณ​

บันทึกข้อมูลการเข้าสู่ระบบโดยรันโค้ดที่เหมาะสมครั้งละหนึ่งครั้งต่อบัญชีที่ต้องการบันทึก หลังจากบันทึกข้อมูลการเข้าสู่ระบบแล้ว โหลดข้อมูลเหล่านั้นโดยทำตามขั้นตอนใน เริ่มต้นบริการ Qiskit Runtime

บันทึกข้อมูลการเข้าสู่ระบบที่เข้าถึง instance เฉพาะ:​

หากคุณมีหลาย instance และต้องการบอก Qiskit Runtime ว่าจะใช้ instance ไหนได้ง่าย ๆ ให้บันทึกข้อมูลการเข้าสู่ระบบที่มี 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
)

บันทึกข้อมูลการเข้าสู่ระบบสำหรับการเลือก instance อัตโนมัติ:​

หากคุณไม่ระบุ instance CRN และส่งข้อมูลการเข้าสู่ระบบเหล่านี้ไปยัง Qiskit Runtime ระบบจะเลือก instance ที่เหมาะสมให้คุณโดยอัตโนมัติตามตัวเลือกที่ระบุ

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
)

ตัวเลือกที่ใช้ได้​

  • token: IBM Cloud API key โทเคนของคุณเป็นความลับ อย่าแชร์โทเคนในโค้ดสาธารณะ
  • instance: ระบุ instance ที่ต้องการใช้ผ่าน IBM Cloud CRN หรือชื่อ instance (ตัวเลือก)
  • plans_preference: ตั้งค่าประเภทแผนที่ต้องการให้ความสำคัญ (ตัวเลือก) ตัวเลือกนี้จะถูกละเว้นหาก instance ถูกระบุ ตัวเลือกที่ใช้ได้คือ open, pay-as-you-go, flex, premium และ on-prem instance ของประเภทแผนหนึ่งจะถูกยกเว้นหากไม่ได้ระบุชื่อแผน ตัวอย่างเช่น หากส่ง [open] เข้ามา จะมีเพียง Open Plan instances เท่านั้นที่ใช้ได้ ตัวเลือกนี้จะถูกละเว้นหากระบุ instance
  • region: ตั้งค่าภูมิภาคที่ต้องการใช้ (ตัวเลือก) ค่าที่รับได้คือ us-east และ eu-de ตัวเลือกนี้จะถูกละเว้นหากระบุ instance
  • tags: ระบุ tag ของ instance (ตัวเลือก) รับรายการของสตริงชื่อ tag ตัวเลือกนี้จะถูกละเว้นหากระบุ instance
  • name: ตั้งชื่อชุดข้อมูลการเข้าสู่ระบบบัญชีนี้ (ตัวเลือก)
  • set_as_default: ตั้งค่าเป็น True เพื่อบันทึกข้อมูลเหล่านี้เป็นข้อมูลการเข้าสู่ระบบเริ่มต้น หากบันทึกเพียงบัญชีเดียว จะถูกตั้งเป็นค่าเริ่มต้นโดยอัตโนมัติ
  • overwrite: ตั้งค่านี้เป็น True เพื่ออัปเดตข้อมูลการเข้าสู่ระบบเริ่มต้นของคุณ

ตัวอย่าง​

ตัวอย่างที่ 1​

ตัวอย่างนี้บันทึกข้อมูลการเข้าสู่ระบบสำหรับ instance เฉพาะ ซึ่งช่วยให้เข้าถึงแบบ open และ premium ได้ ข้อมูลการเข้าสู่ระบบแบบ open ถูกตั้งเป็นค่าเริ่มต้น

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)

ตัวอย่างที่ 2​

ตัวอย่างนี้บันทึกข้อมูลการเข้าสู่ระบบสำหรับการเลือก instance อัตโนมัติ Qiskit Runtime จะมองหาเฉพาะ premium instances ในภูมิภาค EU ที่บัญชีสามารถเข้าถึงได้เท่านั้น ข้อมูลการเข้าสู่ระบบเหล่านี้จะกลายเป็นค่าเริ่มต้นใหม่

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

ดูข้อมูลการเข้าสู่ระบบที่บันทึกไว้​

หากต้องการดูข้อมูลการเข้าสู่ระบบทั้งหมดที่คุณบันทึกไว้ รัน service.saved_accounts() โปรดสังเกตว่าหากคุณบันทึกข้อมูลการเข้าสู่ระบบเริ่มต้นและไม่ได้ตั้งชื่อ ข้อมูลเหล่านั้นจะถูกตั้งชื่อว่า default-ibm-quantum-platform หากคุณตั้งชื่อข้อมูลการเข้าสู่ระบบเริ่มต้น คุณจะเห็น "is_default_account": true ในผลลัพธ์

ข้อควรพิจารณา​

  • หากคุณบันทึกหลายบัญชี ใช้พารามิเตอร์ name เพื่อแยกแยะความแตกต่าง
  • ข้อมูลการเข้าสู่ระบบจะถูกบันทึกที่ $HOME/.qiskit/qiskit-ibm.json อย่าแก้ไขไฟล์นี้ด้วยตนเอง
  • หากคุณไม่บันทึกข้อมูลการเข้าสู่ระบบ คุณต้องระบุข้อมูลเหล่านั้นทุกครั้งที่เริ่ม session ใหม่ (instantiate บริการ Qiskit Runtime)
  • หากคุณระบุข้อมูลการเข้าสู่ระบบด้วยตนเอง ข้อมูลบัญชีที่บันทึกไว้จะไม่ถูกใช้

ขั้นตอนถัดไป

คำแนะนำ
Source: IBM Quantum docs — updated 5 มี.ค. 2569
English version on doQumentation — updated 7 พ.ค. 2569
This translation based on the English version of 11 มี.ค. 2569