فهم المسارات

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلىمستندات Apigee X. info

يحدّد المسار مسار الطلب من ProxyEndpoint إلى TargetEndpoint. ويتضمّن المسار عنوان URL المستخدَم للوصول إلى ProxyEndpoint الخاص بواجهة برمجة التطبيقات وعنوان URL لخدمة الخلفية التي يحدّدها TargetEndpoint.

شاهِد هذا الفيديو للحصول على مقدّمة عن المسارات، مع وصف العلاقة بين الـ ProxyEndpoint وTargetEndpoint.

تحديد عنوان URL لنقطة نهاية الخادم الوكيل لواجهة برمجة التطبيقات

تعرض الصورة التالية طلبًا واردًا إلى ProxyEndpoint من أحد التطبيقات، ويتم توجيه هذا الطلب إلى خدمة الخلفية:

بعد إنشاء خادم وكيل لواجهة برمجة التطبيقات على Edge، يكون عنوان URL التلقائي الذي يستخدمه التطبيق للوصول إلى الخادم الوكيل على النحو التالي:

http://{org-name}-{env-name}.apigee.net/{base-path}/{resource-path}

https://{org-name}-{env-name}.apigee.net/{base-path}/{resource-path}

حيث:

  • {org-name} هو اسم مؤسستك. يتم إنشاء هذا الاسم عند إنشاء حساب على Edge.
  • {env-name} هو اسم بيئة Edge. تتضمّن جميع مؤسسات Apigee التي تم إنشاؤها في السحابة الإلكترونية تلقائيًا بيئتين: "test" و"prod". عند نشر خادم وكيل لواجهة برمجة التطبيقات، يمكنك اختياره لنشره في إحدى البيئتين أو كلتيهما.
  • {base-path} و{resource-path} يتم تحديدهما عند إنشاء الخادم الوكيل لواجهة برمجة التطبيقات.

عندما يصل طلب إلى Edge، يحلّل Edge عنوان URL لتوجيه الطلب إلى ProxyEndpoint الصحيح. على سبيل المثال، يتم استخدام عنوان URL التالي للوصول إلى خادم وكيل لواجهة برمجة التطبيقات على Edge:

http://myOrg-prod.apigee.net/v1/weather/forecastrss

إذا اطّلعت على تعريف ProxyEndpoint للخادم الوكيل لواجهة برمجة التطبيقات في الشكل أعلاه، يمكنك الاطّلاع على كيفية تحليل Edge لعنوان URL هذا:

  1. يتطابق جزء النطاق من عنوان URL، http://myOrg-prod.apigee.net، مع مضيف افتراضي على Edge. في تعريف ProxyEndpoint أعلاه، يستخدم الخادم الوكيل لواجهة برمجة التطبيقات العلامة <VirtualHost> للإشارة إلى مضيف افتراضي باسم default. يمكنك تحديد عدة مضيفات افتراضية في بيئتك.

    يحدّد المضيف الافتراضي النطاقات والمنافذ التي يتم من خلالها عرض خادم وكيل لواجهة برمجة التطبيقات. يحدّد المضيف الافتراضي أيضًا ما إذا كان يتم الوصول إلى الخادم الوكيل لواجهة برمجة التطبيقات باستخدام بروتوكول HTTP أو بروتوكول HTTPS المشفّر. لمزيد من المعلومات التفصيلية عن المضيفات الافتراضية، يُرجى الاطّلاع على مقالة لمحة عن المضيفات الافتراضية (الإصدار التجريبي).
  2. يتم تحديد الجزء الثاني من عنوان URL، /v1/weather، من خلال العنصر <BasePath> في ProxyEndpoint. يجب أن يكون المسار الأساسي فريدًا للخادم الوكيل لواجهة برمجة التطبيقات في البيئة، بحيث لا يكون لخادمَي وكيلَين لواجهة برمجة التطبيقات المسار الأساسي نفسه.
  3. الجزء الثالث من عنوان URL، /forecastrss، هو مورد يحدّده الخادم الوكيل لواجهة برمجة التطبيقات مع Conditional Flow المقابل الذي تحدّده العلامة <Flows>.

الفيديو: شاهِد فيديو قصيرًا لمزيد من المعلومات عن نقاط نهاية الخادم الوكيل لواجهة برمجة التطبيقات.

تحديد عنوان URL لنقطة النهاية المستهدَفة

تحدّد العلامة <RouteRule> في تعريف ProxyEndpoint هدف الخادم الوكيل لواجهة برمجة التطبيقات، ويتم تقييمها بعد معالجة جميع السياسات في PreFlow وConditional Flows وPostFlow لطلب ProxyEndpoint.

يمكن أن يحدّد ProxyEndpoint الهدف على النحو التالي:

  • عنوان URL مباشر لخدمة الخلفية
  • تعريف TargetEndpoint واحد
  • نقاط نهاية مستهدَفة متعددة يفوّض فيها الخادم الوكيل لواجهة برمجة التطبيقات الطلب إلى نقطة نهاية مستهدَفة استنادًا إلى شرط
  • مسار أو هدف فارغ، ما يعني أنّه لا يتم إعادة توجيه الطلب إلى هدف بدلاً من ذلك، تتم جميع عمليات معالجة الطلب وإنشاء الرد على Edge.

الفيديو: شاهِد فيديو قصيرًا لمزيد من المعلومات عن نقاط النهاية المستهدَفة.

عنوان URL مباشر

يمكن أن يستدعي ProxyEndpoint خدمة خلفية مباشرةً، متجاوزًا أي إعداد TargetEndpoint باسم. على سبيل المثال، يُجري <RouteRule> التالي دائمًا طلب HTTP إلى http://api.mycompany.com/myAPI:

<RouteRule name="default">
  <URL>http://api.mycompany.com/myAPI</URL> 
</RouteRule>

ومع ذلك، بما أنّه لا يوجد TargetEndpoint، يمكنك فقط إضافة سياسات إلى عمليات سير العمل التي يحدّدها ProxyEndpoint.

هدف واحد

في تعريف الهدف الواحد، يشير ProxyEndpoint إلى تعريف TargetEndpoint واحد بالاسم، كما هو موضّح في الشكل أعلاه:

<RouteRule name="default">
  <TargetEndpoint>default</TargetEndpoint>
</RouteRule>

يتم توجيه جميع الطلبات إلى الخادم الوكيل لواجهة برمجة التطبيقات هذا إلى تعريف TargetEndpoint نفسه. تحدّد العلامة <URL> في TargetEndpoint موقع خدمة الخلفية. في الشكل أعلاه، عنوان URL المستهدَف هو http://weather.yahooapis.com.

الأهداف الشرطية

تتيح لك العلامة <RouteRule> توجيه طلب إلى هدف استنادًا إلى شرط. يمكنك استخدام متغيرات سير العمل أو مَعلمات طلب البحث أو عناوين HTTP أو محتوى الرسالة أو المعلومات السياقية، مثل الوقت من اليوم واللغة والمنطقة لتحديد نقطة النهاية المستهدَفة. على سبيل المثال، يمكنك تضمين منطقة جغرافية، مثل الولايات المتحدة والمملكة المتحدة، في عنوان URL للطلب. بعد ذلك، يمكنك توجيه طلب إلى نقطة نهاية مستهدَفة استنادًا إلى الـ منطقة.

تقيِّم قاعدة التوجيه التالية عنوان HTTP في الطلب. إذا كان عنوان HTTP routeTo يتضمّن القيمة TargetEndpoint1، تتم إعادة توجيه الطلب إلى TargetEndpoint باسم TargetEndpoint1. إذا لم يكن الأمر كذلك، تتم إعادة توجيه الطلب إلى TargetEndpoint2.

<RouteRule name="MyRoute">
  <Condition>request.header.routeTo = "TargetEndpoint1"</Condition>
  <TargetEndpoint>TargetEndpoint1</TargetEndpoint>
</RouteRule>
<RouteRule name="default">
 <TargetEndpoint>TargetEndpoint2</TargetEndpoint>
</RouteRule>

إذا كان لديك قواعد توجيه متعددة، أنشئ واحدة كقاعدة 'تلقائية'، أي كقاعدة توجيه بدون شرط. احرص على تحديد قاعدة التوجيه التلقائية آخرًا في قائمة المسارات الشرطية لأنّه يتم تقييم القواعد من أعلى إلى أسفل في ProxyEndpoint.

يمكنك أيضًا الاطّلاع على المسارات الشرطية ومرجع الشروط.

الفيديو: شاهِد فيديو قصيرًا للتعرّف على كيفية التوجيه إلى نقطة نهاية مستهدَفة باستخدام الأهداف الشرطية.

المسار الفارغ

يدعم المسار الفارغ السيناريوهات التي لا تحتاج فيها رسالة الطلب إلى إعادة توجيهها إلى TargetEndpoint. يكون هذا مفيدًا عندما يُجري ProxyEndpoint جميع عمليات المعالجة اللازمة، مثلاً باستخدام JavaScript لاستدعاء خدمة خارجية.

يحدّد المثال التالي مسارًا فارغًا:

<RouteRule name="GoNowhere"/>

مزيد من المعلومات