הוספת תכונות באמצעות מדיניות

הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge

‫Apigee מאפשר לכם לתכנת את התנהגות ה-API בלי לכתוב קוד, באמצעות מדיניות. מדיניות היא כמו מודול שמטמיע פונקציית ניהול ספציפית ומוגבלת. כללי המדיניות נועדו לאפשר לכם להוסיף לממשק API יכולות ניהול נפוצות בצורה יעילה ומהימנה.

המדיניות מספקת תכונות כמו אבטחה, הגבלת קצב, טרנספורמציה ויכולות גישור, כך שלא תצטרכו ליצור ולתחזק את הקוד בעצמכם. אתם לא מוגבלים לסוגי המדיניות ש-Apigee מספקת. אפשר גם לכתוב סקריפטים וקוד בהתאמה אישית (כמו אפליקציות JavaScript) שמרחיבים את הפונקציונליות של proxy ל-API ומאפשרים לכם לחדש על בסיס יכולות הניהול הבסיסיות שנתמכות על ידי מדיניות Apigee.

יוצרים ומצרפים מדיניות לשרתי proxy ל-API ולזרימות משותפות באמצעות Apigee ב-Cloud Code, כמו שמתואר בקטעים הבאים. בהתאם לסוג המדיניות, יכול להיות שתצטרכו ליצור משאב, כמו שמתואר במאמר ניהול משאבים. אפשר גם לעיין במאמר בנושא ניהול תיקיות וקבצים במרחב עבודה של Apigee.

לפני שמתחילים: כדאי להכיר את המושגים שמתוארים בנושאים הבאים:

• מהי מדיניות?
• סקירה כללית של המדיניות
• מדיניות בנושא נכסי יתרונות מרכזיים של זרימת תנועה

הוספה של כלל מדיניות

כדי ליצור מדיניות באמצעות Apigee ב-Cloud Code:

1. בסביבת העבודה של Apigee, מבצעים אחת מהפעולות הבאות בהתאם למקום שבו רוצים לצרף את המדיניות:

   צרף אל	פעולה
   API מסוג proxy	מבצעים אחת מהפעולות הבאות: מעבירים את הסמן מעל אחת מהתיקיות הבאות, לוחצים על ובוחרים באפשרות יצירת מדיניות: apiproxy-name חבילת proxy apiproxy-name/apiproxy ממקמים את הסמן מעל תיקיית ה-proxy ל-API‏ apiproxy-name/apiproxy/policies ולוחצים על .
   תהליך עבודה משותף	מבצעים אחת מהפעולות הבאות: מעבירים את הסמן מעל אחת מהתיקיות הבאות, לוחצים על ובוחרים באפשרות יצירת מדיניות: sharedflow-name חבילת תהליכי עבודה משותפים sharedflow-name/sharedflowbundle מעבירים את הסמן מעל התיקייה sharedflow-name/sharedflowbundle/policies של התהליך המשותף ולוחצים על .

ייפתח האשף ליצירת מדיניות.

1. בוחרים את קטגוריית המדיניות שרוצים ליצור מתוך הרשימה. במאמר סקירה כללית של מאמרי העזרה בנושא מדיניות מופיע תיאור של קטגוריות המדיניות.

2. מזינים שם ייחודי למדיניות ולוחצים על Enter. המדיניות מתווספת לתיקייה /policies של ה-proxy ל-API או של הרכיב המשותף בקטע Apigee ונפתחת בעורך.

3. עורכים את הקובץ לפי הצורך ולוחצים על קובץ > שמירה או על ‎⌘S כדי לשמור את השינויים. מידע נוסף על הגדרת המדיניות זמין במאמר סקירה כללית של הפניות למדיניות.

4. יוצרים משאבים אם נדרש לפי סוג המדיניות, כמו שמתואר במאמר ניהול משאבים.

צירוף מדיניות לזרימה

המדיניות לא מופעלת עד שהיא מצורפת לזרימת עבודה. כדי לצרף מדיניות לזרימת נתונים, מוסיפים את האלמנט <Step> לבקשה המתאימה או לאלמנט של זרימת התגובה בהגדרה של ProxyEndpoint או TargetEndpoint, כמו שמתואר בנושאים הבאים:

• צירוף מדיניות לזרימת ProxyEndpoint או TargetEndpoint
• מדיניות בנושא נכסי יתרונות מרכזיים של זרימת תנועה

לדוגמה, ההגדרה הבאה מצרפת QuotaPolicy ל-<PreFlow> של ProxyEndpoint כדי להגדיר את מספר הודעות הבקשה ש-proxy ל-API מאפשר במשך פרק זמן מסוים.

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