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

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

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

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

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

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

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

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

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

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

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

   צרף אל	פעולה
   proxy ל-API	מבצעים אחת מהפעולות הבאות: מעבירים את הסמן מעל אחת מהתיקיות הבאות, לוחצים על ובוחרים באפשרות יצירת מדיניות: 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>