הסבר על המכסות

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

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

המכסות חלות על כל ה-API

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

יש לכך שתי השלכות כשמפעילים יותר מהגדרת API אחת:

  • שינוי הערך של מגבלה משנה אותה בכל שער של ה-API, כולל שערים שמשרתים הגדרת API קודמת.

  • שינוי השם או ההסרה של מדד משאירים מאחור הגדרת מכסה לא תקינה בכל שער שעדיין משרת הגדרת API קודמת. בקשות לשיטות שמוגבלות על ידי מכסות בשערי הכניסה האלה נכשלות עם שגיאת HTTP 500 וההודעה Failed to call Service Control Quota.

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