מכסות ומגבלות

בדף הזה מתוארות הגבלות המכסה של API Gateway.

מגבלות על ממשקי API, הגדרות API ושערים

‫API Gateway אוכף את המגבלות הבאות על ממשקי API, על הגדרות של ממשקי API ועל שערים:

• ‫APIs – 50 בסך הכול
• תצורות API – 100 לכל API
• שערי גישה – 50 לכל אזור

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

מגבלות על קצב הבקשות

כברירת מחדל, קיימת הגבלה של 10,000,000 יחידות מכסה לכל 100 שניות לכל פרויקט לשירות מנוהל. כל קריאה אל services.check וכל פעולה שמדווחת על ידי services.report צורכות יחידת מכסה אחת.

הערה: API Gateway משתמש באלגוריתמים יעילים של שמירת נתונים במטמון, ולכן הוא לא קורא ל-Service Control API בכל פעם שמתבצעת קריאה ל-API. לכן, למרות שמגבלת ברירת המחדל היא 10,000,000 לכל 100 שניות, ה-API יכול לתמוך בנפח גבוה בהרבה.

מגבלות על גודל המטען הייעודי (payload)

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

הגבלה	סכום
גודל הבקשה	‫32 מגה-בייט
גודל התשובה	‫32 מגה-בייט*
גודל התגובה של gRPC transcoding	מגה-בייט אחד
גודל הבקשה של gRPC transcoding	מגה-בייט אחד

* המגבלה הזו לא חלה על תשובות שמוזרמות ומחולקות לחלקים. ראו סטרימינג.

סטרימינג

הזרמת נתונים נתמכת ב-Public Preview בשערי גישה שנוצרו עם הזרמת נתונים מופעלת. סטרימינג מאפשר לשערי גישה להציג אירועים שנשלחים מהשרת (SSE),‏ WebSockets, סטרימינג דו-כיווני של gRPC ומסירה מצטברת של תגובות (מסגרות נתונים של HTTP/2 או קידוד העברה בחלקים של HTTP/1.1). תגובות שמועברות בסטרימינג או בחלקים פטורות ממגבלת הגודל של 32MB, אבל מגבלת הגודל של 32MB עדיין חלה על בקשות. מידע נוסף מופיע במאמר בנושא הגדרת סטרימינג.

מגבלות על גודל הכותרת

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

הגבלה	סכום
גודל כותרות הבקשות	‫60 קילו-בייט

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

איך מגדילים את המכסה

בקשות לשינוי מכסות ב-Cloud כפופות לבדיקה. אם הבקשה לשינוי המכסה דורשת בדיקה, תקבלו אימייל עם אישור על קבלת הבקשה. אם דרושה לך עזרה נוספת, אפשר להשיב לאימייל הזה. אחרי שנבדוק את הבקשה, תקבלו התראה באימייל אם הבקשה אושרה.

המסוף

כדי לשנות את ערך המכסה, פועלים לפי השלבים הבאים:

1. במסוף Google Cloud , נכנסים לדף IAM & Admin > Quotas & System Limits:

   כניסה לדף Quotas & System Limits

   אם מתבקשים לבחור פרויקט, בוחרים את הפרויקט שרוצים לשנות.

2. מחפשים את ערך המכסה שרוצים לעדכן בעמודה Quota ומסמנים את התיבה לצד המכסה שרוצים לעדכן.

   אם צריך, השתמשו בתיבת החיפוש Filter כדי לחפש את המכסה שלכם.

3. לוחצים על createEdit. תיבת הדו-שיח Quota changes תיפתח.

4. מקלידים את המכסה החדשה הרצויה בשדה New value. חלק מהמכסות מבוססות על יחידת מידה. במקרה כזה, בוחרים את היחידה מהרשימה שליד. לוחצים על סיום.

   אופציונלי: אם מופיעה תיבת סימון עם הטקסט I understand that this request will remove any overrides, המשמעות היא ששינוי ערך המכסה למספר ששווה לערך ברירת המחדל או גדול ממנו יגרום להסרה של ערך ברירת המחדל הקודם. אם זה מה שרוצים, מסמנים את התיבה וממשיכים.

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

   1. בטופס Quota changes, בשדה New value כותבים את ערך המכסה המעודכן שרוצים להגדיר. אם מופיע השדה Request description, כותבים תיאור. לוחצים על סיום.

   2. אם מופיע לחצן הבא, לוחצים עליו וממלאים את הפרטים ליצירת קשר במסך הבא.

6. לוחצים על Submit request.

אם אי אפשר לבקש לשנות מכסה במסוף, תוכלו לשלוח את הבקשה ל-Cloud Customer Care.

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

איך שולחים בקשות בקבוצות כדי להגדיל את ערכי המכסות

כדי לשלוח בקשות בכמות גדולה להגדלת המכסה, מסמנים את התיבה לצד כל מכסה שרוצים לכלול. עם זאת, אם תשלחו בקשות באצווה, יכול להיות שיידרש ל- Google Cloud יותר זמן כדי לבדוק את הבקשה שלכם.

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