أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلىمستندات Apigee X. info
يمكنك إنشاء السياسات وتعديلها محليًا باستخدام محرّر النصوص أو المحرّر المتوافق مع XML أو بيئة التطوير المتكاملة المفضّلة لديك. يستخدم هذا الموضوع نوع سياسة "الحصة" كمثال على كيفية إنشاء السياسات وضبطها وإرفاقها ونشرها واختبارها.
تفرض معظم خوادم واجهة برمجة التطبيقات الوكيلة حصة. توفر الحصص إمكانية التحكم في عدد المرات التي يسمح فيها لتطبيق عميل بـ استدعاء واجهة برمجة تطبيقات خلال فترة زمنية معينة. في المثال أدناه، تم ضبط سياسة "الحصة" بحيث لا تسمح للتطبيقات إلا بطلب واحد في الدقيقة. (على الرغم من أنّ هذا قد لا يكون واقعيًا، فإنّه يوفّر طريقة بسيطة للاطّلاع على تأثيرات السياسة).
في إعداد خادم واجهة برمجة التطبيقات الوكيلة، يتم تخزين ملفات السياسات كملفات XML ضمن الدليل
/apiproxy/policies.
على سبيل المثال، يمكن إنشاء سياسة من نوع "الحصة" باسم "QuotaPolicy" كملف باسم
QuotaPolicy.xml يتضمّن المحتوى التالي:
<Quota enabled="true" continueOnError="false" name="QuotaPolicy">
<Allow count="1"/>
<Interval>1</Interval>
<TimeUnit>minute</TimeUnit>
</Quota>يمكنك إنشاء ملف نصي يدويًا أو إنشاء السياسة من مخطط XML. تتضمّن جميع السياسات بعض الإعدادات الخاصة بنوع السياسة، وبعض الإعدادات العامة لجميع السياسات.
تحدّد جميع السياسات السمات التالية:
enabled: يشير إلى ما إذا كانت السياسة "مفعّلة" أو "غير مفعّلة". يمكن تفعيل السياسات أو إيقافها في وقت التشغيل من خلال تغيير هذا الإعداد. لا يتم فرض سياسة تم ضبطenabledفيها علىfalse.continueOnError: يحدّد ما إذا كان يجب أن يستمر خط أنابيب المعالجة في معالجة الرسالة في حال تعذّر تنفيذ السياسة. عند فرض سياسات الحصة، من المرجّح أن تشير الأخطاء إلى تجاوز الحصة، وبالتالي يجب ضبط هذه السمة على "خطأ".name: الاسم الذي تمنحه لهذه السياسة. هذا الاسم فريد لنموذج السياسة هذا ، ويُستخدم لإرفاق السياسة بالتدفق كخطوة معالجة.
في المثال أعلاه، تكون العناصر Allow وInterval و
TimeUnit خاصة بسياسة "الحصة". توفّر هذه العناصر إعدادات تفرضها "خدمات واجهة برمجة التطبيقات"
نيابةً عن واجهة برمجة التطبيقات. تحدّد أنواع السياسات الأخرى إعداداتها الخاصة، والتي يمكنك التعرّف عليها في مرجع السياسات.