احفظ بيانات تسجيل الدخول

إذا كنت تعمل في بيئة Python موثوقة (مثل حاسوبك الشخصي أو محطة العمل الخاصة بك)، فيمكنك استخدام طريقة save_account() لحفظ بيانات اعتمادك محلياً، ثم استخدامها لتهيئة الخدمة.

ملاحظات

• إذا كنت تستخدم حاسوباً عاماً أو أي بيئة غير موثوقة، فاتبع التعليمات الموجودة في تهيئة الخدمة في بيئة غير موثوقة عوضاً عن ذلك.
• اتبع هذه التعليمات إذا أردت الاتصال عبر REST API بدلاً من استخدام Qiskit.
• إذا لزم الأمر، استخدم هذه المعلومات لضبط جدار الحماية الخاص بك وتمكين الوصول إلى نقاط نهاية IBM Quantum API.

قبل أن تبدأ

1. تأكد من أنك تعمل في بيئة Python نشطة مع تثبيت Qiskit SDK و Qiskit Runtime.
2. فعِّل البيئة الافتراضية لـ Python وشغِّل Python داخلها.
3. سجّل الدخول إلى IBM Quantum Platform.

ابحث عن بيانات اعتمادك

1. تأكد من اختيار الحساب والمنطقة الصحيحين في مبدِّل الحساب الموجود في الرأس.
2. ابحث عن مفتاح API الخاص بك. من لوحة التحكم، أنشئ مفتاح API ثم انسخه إلى مكان آمن لتتمكن من استخدامه في المصادقة. لاحظ أنه يمكنك استخدام نفس مفتاح API للاتصال بأي منطقة.
3. اختياري: ابحث عن النسخة التي تريد استخدامها من صفحة Instances. مرِّر المؤشر فوق CRN الخاص بها، وانقر على الأيقونة لنسخه، ثم احفظه في مكان آمن لتتمكن من استخدامه لتحديد النسخة.

احفظ بيانات اعتمادك

احفظ بيانات اعتمادك بتشغيل الكود المناسب مرةً واحدة لكل حساب تريد حفظه. بعد حفظ بيانات اعتمادك، حمِّلها باتباع الخطوات الموجودة في تهيئة خدمة Qiskit Runtime.

احفظ بيانات اعتماد للوصول إلى نسخة محددة:

إذا كان لديك نسخ متعددة وتريد إخبار Qiskit Runtime بسهولة أيَّ نسخة تستخدم، فاحفظ بيانات اعتماد تتضمن 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
)

احفظ بيانات اعتماد لاختيار النسخة تلقائياً:

إذا لم تُقدِّم CRN نسخة وأرسلت هذه البيانات إلى Qiskit Runtime، فسيتم اختيار نسخة مناسبة لك بناءً على الخيارات المحددة.

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: مفتاح API الخاص بـ IBM Cloud. رمزك سري، لا تشاركه في كود عام.
• instance: حدِّد اختيارياً النسخة التي تريد استخدامها من خلال CRN الخاص بها على IBM Cloud أو اسمها.
• plans_preference: حدِّد اختيارياً أنواع الخطط التي تريد إعطاءها الأولوية. يُتجاهل هذا الخيار إذا تم تحديد النسخة. الخيارات المتاحة هي open وpay-as-you-go وflex وpremium وon-prem. يتم استبعاد نسخ نوع خطة معين إذا لم يُحدَّد اسم الخطة. على سبيل المثال، إذا تم تمرير [open]، فلن تتوفر إلا نسخ الخطة المفتوحة. يُتجاهل هذا الخيار إذا تم تحديد instance.
• region: حدِّد اختيارياً المنطقة التي تريد استخدامها. القيم المقبولة هي us-east وeu-de. يُتجاهل هذا الخيار إذا تم تحديد instance.
• tags: حدِّد اختيارياً وسوم النسخة. يقبل قائمة من سلاسل أسماء الوسوم. يُتجاهل هذا الخيار إذا تم تحديد instance.
• name: أعطِ اختيارياً اسماً لهذه المجموعة من بيانات اعتماد الحساب.
• set_as_default: اضبط القيمة على True لحفظ هذه البيانات كبيانات اعتمادك الافتراضية. إذا حفظت حساباً واحداً فقط، فيُضبط تلقائياً كحساب افتراضي.
• overwrite: اضبط هذه القيمة على True لتحديث بيانات اعتمادك الافتراضية.

أمثلة

مثال 1

يحفظ هذا المثال بيانات اعتماد لنسخ محددة، تتيح الوصول المفتوح والمتميز. تُضبط بيانات الاعتماد المفتوحة كبيانات افتراضية.

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

يحفظ هذا المثال بيانات اعتماد لاختيار النسخة تلقائياً. لن ينظر Qiskit Runtime إلا في النسخ المتميزة في منطقة الاتحاد الأوروبي المتاحة للحساب. تصبح هذه البيانات الافتراضية الجديدة.

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. لا تُعدِّل هذا الملف يدوياً.
• إذا لم تحفظ بيانات اعتمادك، فيجب عليك تحديدها في كل مرة تبدأ فيها جلسة جديدة (عند إنشاء نسخة من خدمة Qiskit Runtime).
• إذا حددت بيانات اعتمادك يدوياً، فلن يُستخدم الحساب المحفوظ.

الخطوات التالية

توصيات

• هيِّئ خدمة Qiskit Runtime في بيئة Python موثوقة.
• هيِّئ خدمة Qiskit Runtime في بيئة غير موثوقة.
• اعرض وحدات المعالجة الكمومية (QPUs) المتاحة لك.
• اضبط Qiskit SDK محلياً.
• اتبع الخطوات في Hello world لكتابة برنامج كمومي وتشغيله.
• اضبط استخدام IBM Quantum Platform مع REST API.
• جرِّب درساً تعليمياً.