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

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

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

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

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

<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 للرد. يتم تنفيذ هذه السياسة على رسالة الرد. (استجابة ProxyEndpoint PostFlow هي مرحلة المعالجة النهائية قبل يتم إرجاع الرد إلى تطبيق العميل الذي أرسل الطلب).

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