אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע
אתם יכולים ליצור ולערוך מדיניות באופן מקומי, באמצעות עורך טקסט או IDE שאתם אוהבים או באמצעות עורך שמודע ל-XML. בנושא הזה נעשה שימוש בסוג המדיניות Quota (מכסת שימוש) כדוגמה לאופן שבו יוצרים, מגדירים, מצרפים, פורסים ובודקים מדיניות.
רוב שרתי ה-proxy של API אוכפים מכסה. המיכסות מאפשרות לשלוט בתדירות שבה אפליקציית לקוח יכולה להפעיל API במרווח זמן נתון. בדוגמה שלמטה, מדיניות המכסה מוגדרת להגבלת האפליקציות לבקשה אחת בדקה. (יכול להיות שזה לא ריאליסטי, אבל זו דרך פשוטה לראות את ההשפעות של מדיניות).
בהגדרת proxy ל-API, קובצי המדיניות מאוחסנים כקובצי 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: מציין אם המדיניות מופעלת (on) או מושבתת (off). אפשר להפעיל או להשבית את כללי המדיניות בזמן הריצה על ידי שינוי ההגדרה הזו. מדיניות שבה הערך שלenabledמוגדר כ-falseלא נאכפת. -
continueOnError: מגדיר אם הצינור צריך להמשיך לעבד את ההודעה אם המדיניות נכשלת. כשמפעילים מדיניות מכסות, שגיאות כנראה מצביעות על חריגה מהמכסה, ולכן צריך להגדיר את המאפיין הזה כ-False. name: השם שנותנים למדיניות הזו. השם הזה ייחודי למופע המדיניות הזה, והוא משמש לצירוף המדיניות לזרימה כשלב עיבוד.
בדוגמה שלמעלה, הרכיבים Allow, Interval ו-TimeUnit ספציפיים למדיניות בנושא מכסות. האלמנטים האלה מספקים הגדרות ששירותי API אוכפים בשם API. סוגי מדיניות אחרים מגדירים הגדרות משלהם, שאפשר לקרוא עליהן בהפניה למדיניות.