استخدام وحدة وصول واجهة برمجة التطبيقات

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X. معلومات

تتيح لك وحدة apigee-access الوصول إلى متغيّرات تدفق الخادم الوكيل لواجهة برمجة التطبيقات وذاكرات التخزين المؤقت من ضمن رمز تطبيق Node.js. يتم تضمين الوحدة في منصة Apigee Edge. أنت لا تفعل عليك تثبيته كما تفعل مع وحدات Node.js الأخرى.

الحصول على الوصول إلى واجهة برمجة التطبيقات

تم دمج وحدة apigee-access في منصة Apigee Edge. عندما تريد نشر رمز Node.js إلى Edge، تكون هذه الوحدة متاحة لك. ما عليك سوى طلبها في أي رمز Node.js تنشره. على سبيل المثال:

var access=require('apigee-access');

الوصول إلى متغيرات التدفق

عند نشر تطبيق Node.js على Edge، يمكنك الوصول إلى أي من الأدوات "out-of-the-box" ومتغيرات التدفق، ومتغيرات التدفق التي تم إنشاؤها بواسطة السياسات، وأي متغيرات للتدفق يمكنك إنشاؤها بنفسك من داخل رمز Node.js. يتم إنشاء متغيرات التدفق وتوجد داخل سياق خادم وكيل واجهة برمجة التطبيقات الذي يعمل على Edge. للحصول على معلومات تفصيلية، يُرجى مراجعة الوصول إلى متغيرات التدفق في Node.js

الوصول إلى ذاكرة التخزين المؤقت

تتيح لك وحدة apigee-access الوصول إلى ذاكرة التخزين المؤقت الموزعة في Apigee Edge من رمز Node.js. للحصول على معلومات تفصيلية، يمكنك الاطّلاع على الوصول إلى ذاكرة التخزين المؤقت في Node.js.

استخدام خدمة الحصص

تتيح لك وحدة apigee-access الوصول إلى خدمة حصة Apigee Edge من رمز Node.js. للحصول على معلومات تفصيلية، يُرجى مراجعة الوصول إلى خدمة الحصة في Node.js

الوصول إلى خرائط القيم الرئيسية

تتيح لك وحدة apigee-access الوصول إلى خرائط القيم الأساسية في Apigee Edge (KVMs) من رمز Node.js. للحصول على معلومات تفصيلية، يُرجى مراجعة الوصول إلى خرائط القيم الرئيسية في Node.js

الفرق بين تفعيل الوضع المحلي ووضع النشر

لدعم التطوير والاختبار على المستوى المحلي، تستخدم وحدة apigee-access تعمل في الوضع المحلي بدون اعتماديات على Apigee Edge. وَلَكِنْ عند استخدام الوحدة مع خادم وكيل لواجهة برمجة التطبيقات الذي تم نشره إلى Edge و"المحلية" ستحل محلها وظيفة Edge الأصلية. على سبيل المثال، يمكن الوصول إلى الإضافة الكاملة لمتغيرات التدفق في وضع النشر، في حين يتم توفير مجموعة فرعية صغيرة فقط متاحة عند تشغيل تطبيق Node.js محليًا. للحصول على قائمة بمتغيرات الوضع المحلي هذه، راجع التشغيل في الوضع المحلي.

تحديد الوضع الذي يتم فيه تشغيل الوحدة

لتحديد الوضع الذي يتم فيه تشغيل الوصول إلى واجهة برمجة التطبيقات (apigee):

var access = require('apigee-access')
console.log('The deployment mode is ' + access.getMode());

تخبرك القيمة المعروضة في getMode() بما إذا تم نشر تطبيق Node.js أم لا إلى Apigee Edge أو يتم تشغيله في الوضع المستقل. تُرجع الطريقة إحدى هاتين السلسلتين النتائج:

• apigee - يعمل تطبيق Node.js على Apigee Edge وكل دعم وظيفة معينة.
• standalone - يعمل تطبيق Node.js خارج Apigee Edge البيئة، وتستغرق الوظيفة الافتراضية الموضحة أعلى المستند التأثير.

التشغيل في وضع النشر

عند تفعيل هذه السياسة على Edge، تظهر المتغيّرات التي تم ضبطها من خلال السياسات على apigee-access. والمتغيرات التي تمت إضافتها أو تعديلها بطرق هذه الوحدة مرئية للسياسات اللاحقة في تدفق الخادم الوكيل.

يمكنك العثور على رابط المتغيّرات المتوافقة في مرجع المتغيّرات. هذه المتغيرات وأي محتوى يتم إنشاؤه باستخدام أسمائك الخاصة سيكون مرئيًا لـ "apigee-access". ملاحظة أن بعض المتغيرات للقراءة فقط. يتم تحديدها في مرجع المتغيّرات.

التشغيل في الوضع المحلي

في "الوضع المحلي"، تشغيل رمز Node.js خارج سياق Apigee Edge. ضِمن هذا الوضع، لا يمكن الوصول إلى معظم متغيرات التدفق المحددة مسبقًا داخل Node.js الرمز. يوضح هذا الجدول مجموعة فرعية صغيرة من متغيرات التدفق المتاحة. هذه المتغيرات من أجل دعم التطوير المحلي واختبار تطبيقات Node.js في Apigee Edge.

المتغيّر	للقراءة فقط	النوع	ملاحظات
client.received.start.time	نعم	سلسلة	وقت استلام الطلب
client.received.end.time	نعم	سلسلة	وقت استلام الطلب
client.received.start.timestamp	نعم	عدد صحيح	وقت استلام الطلب
client.received.end.timestamp	نعم	عدد صحيح	وقت استلام الطلب

مرة أخرى، تتوفّر مجموعة أكبر بكثير من المتغيّرات المحدّدة مسبقًا في منصة Apigee Edge. الرجوع إلى متغيّرات Apigee Edge مرجع للقائمة الكاملة