إرفاق سياسة بتدفق ProxyEndpoint أو "هدف نقطة النهاية"

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

لا يتم تنفيذ السياسات إلى أن يتم إرفاقها بمسار. يمكنك إنشاء عملية إرفاق سياسة من خلال تسمية سياسة في إعداد خطوة.

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

تنسيق عملية إرفاق السياسة هو:

<Step>
    <Name>{policy_name}</Name>
</Step>

على سبيل المثال:

<Step>
    <Name>QuotaPolicy</Name>
</Step>

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

يمكنك إرفاق سياسة بمسار طلب أو استجابة. يتم تقسيم مسارات الطلب والاستجابة بشكلٍ إضافي إلى PreFlow وPostFlow.

يوضّح المثال التالي الحد الأدنى من إعداد ProxyEndpoint، بدون عمليات إرفاق سياسات. ويحدّد ببساطة HTTPProxyConnection (الوارد) وRouteRule.

<ProxyEndpoint name="default">
    <HTTPProxyConnection>
        <BasePath>/weather</BasePath>
        <VirtualHost>default</VirtualHost>
    </HTTPProxyConnection>
    <RouteRule name="default">
        <TargetEndpoint>default</TargetEndpoint>
    </RouteRule>
</ProxyEndpoint>

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

لفرض هذا الإعداد، عليك إرفاق خطوة معالجة بـ PreFlow للطلب على النحو التالي:

<ProxyEndpoint name="default">
  <PreFlow>
    <Request>
      <Step><Name>QuotaPolicy</Name></Step>
    </Request>
  </PreFlow>
  <HTTPProxyConnection> 
    <BasePath>/weather</BasePath> 
    <VirtualHost>default</VirtualHost> 
  </HTTPProxyConnection> 
  <RouteRule name="default"> 
    <TargetEndpoint>default</TargetEndpoint> 
  </RouteRule> 
</ProxyEndpoint>

في بعض الأحيان، قد تريد تنفيذ سياسة بعد بعض المعالجة الأولية الأخرى على الـ ProxyEndpoint. على سبيل المثال، تريد التحقّق من الحصة في PreFlow، ثم إجراء مجموعة أخرى من المعالجة بعد التحقّق من الحصة، مثل تحويل الطلب من JSON إلى XML. لإجراء ذلك، عليك إرفاق سياسة بمسار طلب PostFlow. في ما يلي نموذج لعملية إرفاق طلب PostFlow. سيتم تنفيذ هذه السياسة على رسالة الطلب بعد تنفيذ جميع السياسات في الـ PreFlow (وأي مسارات مشروطة).

<PostFlow>
  <Request>
    <Step><Name>JSONtoXMLPolicy</Name></Step>
  </Request>
</PostFlow>

في ما يلي نموذج لعملية إرفاق استجابة PostFlow. سيتم تنفيذ هذه السياسة على رسالة الاستجابة. (إنّ استجابة PostFlow في ProxyEndpoint هي مرحلة المعالجة النهائية قبل إرجاع الاستجابة إلى تطبيق العميل الذي أرسل الطلب).

<PostFlow>
  <Response>
    <Step><Name>XMLtoJSONPolicy</Name></Step>
  </Response>
</PostFlow>