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

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

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

หมายเหตุ

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

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

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

  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(
  # 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
)

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

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

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
)

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

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

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

คำแนะนำ
แหล่งที่มา: IBM Quantum docs — อัปเดตเมื่อ 10 มิ.ย. 2569
เวอร์ชันภาษาอังกฤษ บน doQumentation — อัปเดตเมื่อ 10 มิ.ย. 2569
การแปลนี้อิงตามเวอร์ชันภาษาอังกฤษวันที่ 11 มี.ค. 2569
ปัญหาเกี่ยวกับเว็บไซต์หรือการแปล?ปัญหาเกี่ยวกับเนื้อหา? แก้ไขที่ IBM Quantum docs