الخطوة 3: استخدام سياسة ExtensionCallout

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

عند تطوير خادم وكيل لواجهة برمجة التطبيقات، يمكنك إتاحة الإضافة لإضافة سياسة ExtensionCallout إلى الخادم الوكيل. (إذا كنت بحاجة إلى المساعدة بشأن إنشاء خادم وكيل بسيط، يُرجى الاطِّلاع على إنشاء أول خادم وكيل.)

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

لتثبيت إضافة على الخادم الوكيل لواجهة برمجة التطبيقات:

1. افتح الخادم الوكيل لواجهة برمجة التطبيقات في وحدة تحكُّم Apigee Edge، في عرض التطوير.

   يجب أن تكون مشرف المؤسسة لإنشاء إضافة، إلا أنّه يمكن لأي دور مستخدم تثبيت الإضافة في الخادم الوكيل لواجهة برمجة التطبيقات.

2. في لوحة المستكشف، اختَر PreFlow.

   

3. في أعلى يسار الصفحة، انقر على الزر + خطوة لإضافة سياسة.

   

4. في مربّع الحوار إضافة خطوة، وفي قائمة السياسات على يمين الصفحة، انقر على وسيلة شرح الإضافة.

   

   إذا لم تظهر لك سياسة ExtensionCallout في القائمة، احرص على استخدام واجهة مستخدم Edge الجديدة. بالإضافة إلى ذلك، تتوفّر إضافات Apigee حاليًا لعملاء Apigee Edge Cloud Enterprise فقط.

5. في الجزء الأيسر، حدِّد خيارات ضبط السياسة:

   الحقل	الوصف
   الاسم المعروض	أدخِل الاسم المعروض للسياسة.
   الاسم	أدخِل الاسم الذي تريد استخدامه للسياسة بشكل آلي. يجب أن يكون هذا فريدًا في الخادم الوكيل.
   الإضافة	اختر الإضافة التي تريد استخدامها. هذه هي الإضافة التي أعددتها سابقًا.
   الإجراءات	حدد إجراء "log".

6. انقر على إضافة.
7. في عرض التدفق، انقر على السياسة للاطّلاع على ملف XML الخاص بإعدادها.

   

   عند إدراج الإضافة، ستحصل على مثال عن سياسة XML. يُرجى العِلم بأنّها تتضمّن مخططًا يصف كيفية تنظيم إعدادات العنصر <Input>. (يمكنك تجاهل مخطّط العنصر <Output>، إذ لا يتم عرض نص استجابة من خلال إجراء الإضافة "log").

8. عدِّل ملف XML الخاص بالسياسة لكي يظهر على النحو التالي:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-Beta-1">
     <DisplayName>Logging Extension</DisplayName>
     <Connector>my-logging-extension</Connector>
     <Action>log</Action>
     <Input>{
       "logName": "example-log",
       "metadata": {
         "resource": {
           "type": "global",
           "labels": {
             "project_id": "my-gcp-project"
           }
         }
       },
       "message": "This is a test"
     }</Input>
   </ConnectorCallout><!--
   Input JSON Schema for package=gcp-stackdriver-logging version=0.0.4
   {"type":"object","properties":{"logName":{"type":"string"},"metadata":{"type":"string"},"message":{"type":"string"}},"required":["logName","message"]}
   -->
   <!--
   Output JSON Schema for package=gcp-stackdriver-logging version=0.0.4
   {"type":"object","properties":{"content":{"type":"string"}},"required":[]}
   -->

   تحدّد السمة <Input> هنا ما يلي:

   • logName هو اسم السجلّ المُراد الكتابة إليه. إذا لم يكن هذا المجلد متوفّرًا، سيتم إنشاؤه من خلال الإضافة.
   • يحدّد metadata المعلومات التي يمكنك استخدامها لتصفّح السجلّ في وحدة تحكُّم Stackdriver.
   • message هي ببساطة رسالة السجل التي تريد كتابتها.
9. انقر على الزر حفظ.

الخطوة التالية

الخطوة 1 الخطوة 2 الخطوة 3 الخطوة 4: تفعيل الخادم الوكيل الخطوة 5