הוספת מדיניות SpikeArrest ל-API

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

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

מה תלמדו

במדריך הזה תלמדו:

• מוסיפים מדיניות שמשפיעה על הבקשה והתגובה.
• איך המדיניות משפיעה על הביצועים

מה תצטרכו

• התקנה של Apigee. סקירה כללית ודרישות מוקדמות
• proxy ל-API פעיל עם מדיניות אחת לפחות שמצורפת אליו. מידע נוסף מופיע במאמר סקירה כללית על יצירת proxy ראשון ל-API.
• לקוח HTTP API שמותקן במחשב כדי לבצע קריאות ל-API. בדוגמאות במדריך הזה נעשה שימוש ב-curl.

הוספת המדיניות SpikeArrest

במדריך הזה נסביר איך להוסיף ולהגדיר את מדיניות SpikeArrest כדי להגן על שירות היעד מפני עליות פתאומיות בתנועה, שיכולות להיגרם כתוצאה מעלייה בשימוש, מלקוחות עם באגים או מהתקפות זדוניות. אם מספר הבקשות חורג מהקצב המקסימלי, ה-API מחזיר שגיאת HTTP 429.

כדי להוסיף את מדיניות SpikeArrest ל-proxy ל-API:

1. במסוף Google Cloud , נכנסים לדף Apigee > Proxy development > API Proxies.

   מעבר אל API Proxies

   אם פעלתם לפי המדריך לתחילת העבודה, תוכלו להוסיף אותו ל-proxy ל-API שיצרתם במאמר יצירת proxy ל-API.

2. לוחצים על הכרטיסייה פיתוח.
3. בחלונית הימנית, לוחצים על הלחצן + בשורה Policies (מדיניות).

4. בתיבת הדו-שיח Create policy (יצירת מדיניות), לוחצים בשדה Select policy type (בחירת סוג מדיניות), גוללים למטה אל Traffic Management (ניהול תנועה) ובוחרים באפשרות SpikeArrest (מניעת עליות פתאומיות).

5. אופציונלי: אפשר לשנות את השם והשם המוצג של המדיניות. כברירת מחדל, Apigee מספק קידומת קצרה לשם המדיניות, במקרה הזה, SA-. אפשר להוסיף אחרי הקידומת רצף של מילים תיאוריות, מופרדות במקפים. מוסכמות למתן שמות

   

   כשמסיימים, לוחצים על יצירה כדי ליצור את המדיניות.

אחרי שיצרתם את מדיניות Spike Arrest, אתם יכולים להוסיף אותה לשלב ב-PreFlow.

1. בחלונית הימנית, בוחרים באפשרות Proxy Endpoints > default > PreFlow:

   

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

2. לוחצים על הלחצן + לצד PreFlow בחלונית Response בפינה השמאלית התחתונה של כלי העריכה החזותי:

   

3. בתיבת הדו-שיח Add policy step (הוספת שלב מדיניות), בוחרים במדיניות Spike Arrest (מניעת עליות פתאומיות בתנועה).

4. לוחצים על הוספה כדי לצרף את המדיניות.

   המדיניות Spike Arrest מוצגת עכשיו בחלונית Response:

   

   הערה: בדוגמה הזו נעשה שימוש בשם ברירת המחדל, SA-, למדיניות Spike Arrest. אפשר לשנות את השם ברכיב PolicyName ב-XML של המדיניות, על ידי הוספת תיאור אחרי SA-. מידע נוסף על שינוי שם המדיניות

עכשיו, אחרי שצירפתם את מדיניות Spike Arrest ל-PreFlow, אתם יכולים לנסות לשנות את הקוד של המדיניות:

1. בחלונית תגובה, בוחרים באפשרות SA-.

   

2. בעורך הטקסט מוצג קוד ה-XML של ה-proxy, כולל שלב המדיניות Spike Arrest ברכיב Response של PreFlow.

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <SpikeArrest continueOnError="false" enabled="true" name="SA-">
       <DisplayName>SA-</DisplayName>
       <Properties/>
       <Identifier ref="request.header.some-header-name"/>
       <MessageWeight ref="request.header.weight"/>
       <Rate>30ps</Rate>
   </SpikeArrest>

3. ב-XML של המדיניות, משנים את הערך של רכיב <Rate> ל-1pm (שמתורגם בערך לשתי בקשות שמותרות כל 60 שניות בענן).

   הערה: ההתנהגות של SpikeArrest כוללת אלגוריתם החלקה בכמה מעבדי הודעות, שמשפיע על ההתנהגות בפועל שתראו. פרטים נוספים זמינים במאמר בנושא מדיניות SpikeArrest.

   אפשר לציין את התדירות כערך מספרי של מספר הפעמים בדקה (pm) או בשנייה (ps). זוהי מגבלה נמוכה מאוד, והיא משמשת רק במדריך הזה כדי להדגים את המדיניות. בדרך כלל, מגדירים מגבלה גבוהה בהרבה.

   שימו לב שהערך Rate ב'כלי לבדיקת נכסים' משתנה גם הוא ל-Rate.1pm לחלופין, אפשר לשנות את הערך של הקצב בכלי לבדיקת מאפיינים והשינוי ישתקף בתצוגת ה-XML.

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