استخدام نقاط النهاية الخاصة الافتراضية لـ VPC للاتصال بـ IBM Quantum Platform بشكل خاص

استخدم نقاط النهاية الخاصة الافتراضية (VPE) لـ السحابة الخاصة الافتراضية (VPC) للاتصال بـ IBM Quantum® من شبكة VPC الخاصة بك. يستخدم الاتصال عنوان IP الذي تحدده أنت، مخصَّصًا من شبكة فرعية داخل VPC الخاصة بك.

نقاط VPE هي واجهات IP افتراضية مرتبطة ببوابة نقطة نهاية تُنشأ على أساس كل خدمة. بوابة نقطة النهاية هي وظيفة افتراضية قابلة للتوسع أفقياً، ومتكررة وعالية التوافر، وتمتد عبر جميع مناطق التوافر في VPC الخاص بك. تتيح بوابات نقاط النهاية الاتصالات بين نسخ الخوادم الافتراضية داخل VPC وخدمة IBM Cloud® على الشبكة الخاصة. تتيح لك VPE لـ VPC التحكم الكامل في عناوين IP الخاصة داخل سحابتك. لمزيد من المعلومات، راجع حول بوابات نقاط النهاية الخاصة الافتراضية.

بغض النظر عمّا إذا كنت تستخدم نقاط النهاية الخاصة الافتراضية (VPE)، فإن جميع الاتصالات الداخلية ضمن شبكة IBM Quantum Platform تستخدم دائمًا اتصالات خاصة بدلًا من الإنترنت العام.

ما إذا كان اتصالك بـ IBM Quantum Platform نفسها عامًا أو خاصًا يعتمد على ما إذا كنت تستخدم VPE. الاتصال عبر نقاط النهاية العامة يُرسل جميع بيانات الطلب والاستجابة عبر الإنترنت العام. أما الاتصال عبر VPE فيُبقي تلك الحركة على الشبكة الخاصة بدلًا من ذلك.

تُدعم نقاط النهاية الخاصة الافتراضية (VPE) فقط لواجهة برمجة التطبيقات (API) وحزمة SDK الخاصتين بـ IBM Quantum Platform، كما هو موضح في الأقسام التالية. لا يدعم موقع IBM Quantum Platform الإلكتروني نقاط النهاية الخاصة الافتراضية، ولا يمكن الوصول إليه إلا عبر الشبكة العامة.

قبل أن تبدأ

قبل استهداف VPE لـ IBM Quantum Platform، أكمل الخطوات التالية:

• إنشاء Virtual Private Cloud.

• التخطيط لطوبولوجيا الشبكة للاتصال بنقاط VPE.

• ضبط ضوابط الوصول لـ VPE الخاص بك.

• فهم قيود الخدمة.

• فهم كيفية عرض تفاصيل VPE.

إعداد VPE لـ IBM Quantum Platform

توجد عدة طرق لإنشاء بوابة VPE. إذا كنت تستخدم CLI أو API، فيجب تحديد اسم مورد السحابة (CRN) للمنطقة التي تريد الاتصال منها بـ IBM Quantum Platform. راجع الجدول التالي للاطلاع على المناطق وأسماء CRN المتاحة.

المنطقة	الخطط	اسم النطاق المؤهل بالكامل (FQDN)	اسم مورد السحابة (CRN)
us-east	Standard	private.us-east.quantum.cloud.ibm.com	crn:v1:bluemix:public:quantum-computing:us-east:::endpoint:private.us-east.quantum.cloud.ibm.com
eu-de	Standard	private.eu-de.quantum.cloud.ibm.com	crn:v1:bluemix:public:quantum-computing:eu-de:::endpoint:private.eu-de.quantum.cloud.ibm.com

إعداد بوابة نقطة النهاية

لإعداد بوابة VPE، اتبع هذه الخطوات:

1. اعرض الخدمات المتاحة، بما فيها خدمات البنية التحتية لـ IBM Cloud المتاحة (افتراضياً) لجميع مستخدمي VPC.

2. إنشاء بوابة نقطة نهاية لـ IBM Quantum Platform تريد أن تكون متاحة بشكل خاص لـ VPC.

3. ربط عنوان IP محجوز ببوابة نقطة النهاية.

4. عرض بوابات VPE التي تم إنشاؤها المرتبطة بـ IBM Quantum Platform.

الآن يمكن لنسخ الخوادم الافتراضية في VPC الوصول إلى نسخة IBM Quantum Platform الخاصة بك بشكل خاص.

استخدام VPE الخاص بك لـ IBM Quantum Platform

بعد إنشاء بوابة نقطة نهاية لـ IBM Quantum Platform، اتبع هذه الخطوات:

استخدام VPE مع qiskit-ibm-runtime (Python SDK)

ملاحظة

دعم VPE يتطلب qiskit-ibm-runtime الإصدار v0.24.0 أو أحدث.

عند إنشاء نسخة من QiskitRuntimeService، حدد private_endpoint=True.

# For `token`, use the 44-character API_KEY you created 
# and saved from the IBM Quantum Platform Home dashboard
service = QiskitRuntimeService(token="your-API_KEY", 
                              instance="INSTANCE_CRN",
                              channel="ibm_cloud",
                              private_endpoint=True)

استخدام VPE مع IBM Quantum API

بعد إنشاء بوابة نقطة نهاية لـ IBM Quantum Platform، استخدم اسم النطاق المؤهل بالكامل (FQDN) لنقطة نهاية الخدمة للمنطقة المستهدفة من الجدول السابق.

  curl -X POST \
  https://private.us-east.quantum.cloud.ibm.com/api/v1/jobs \
  -H "Authorization: Bearer $BEARER_TOKEN" \
  -H "Service-CRN: $SERVICE_INSTANCE_CRN" \
  -d '{
    "backend": "backend",
    "program_id": "sampler"
  }'