אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X. info
כדאי להביא בחשבון את המגבלות הבאות של הגדרות המוצר כשאתם יוצרים, מנהלים ובודקים את ההטמעה של תוכנית ה-API. תכננו את המוצר של Apigee כך שיהיה יציב ויעיל כשמגדירים אותו במסגרת המגבלות האלה. הלקוחות אחראים לעקוב אחרי השימוש שלהם ולדאוג שלא יחרגו ממגבלות ההגדרה (ראו את העמודה 'איך בודקים את השימוש הנוכחי' בהמשך). לקוחות שעוברים את המגבלות עשויים להיתקל באחד או יותר מהתסמינים הבאים: זמני אחזור ארוכים ל-API, תפוקת API נמוכה וקריאות ל-API שנכשלו. לקוחות ששולחים בקשות תמיכה שקשורות לבעיות שנגרמו עקב החרגות מהמגבלות עשויים להתבקש לבצע את השינויים הנדרשים בהגדרות שלהם.
יכול להיות שהמגבלות יוטלו באופן אוטומטי, ויכול להיות שלא (ראו את העמודה 'האם המגבלה חלה כרגע?' בהמשך). כשנתחיל לאכוף באופן אוטומטי מגבלות שלא נאכפות כרגע, נשתדל מאוד להודיע ללקוחות שהושפעו מהמגבלות כדי שיוכלו לבצע פעולות מתקנות לפני שהן יתחילו להיות נאכפות.
קבוצה אחת של מגבלות הגדרה חלה על מוצרי Apigee בענן הציבורי ובענן הפרטי (באתר), וקבוצה אחרת חלה על Edge Microgateway. המגבלות האלה לא קשורות להזכאות שלכם בתוכנית. חלק מהתכונות שמפורטות כאן זמינות רק ב-Apigee Public Cloud.
ענן/ענן פרטי
| אזור התכונה | מגבלה | האם חלה עליו אכיפה כרגע? | איך בודקים את השימוש הנוכחי |
|---|---|---|---|
שרתי proxy ל-API |
|||
| גודל החבילה של קובץ ה-zip של שרת proxy ל-API או של תהליך עבודה משותף (שרתי proxy שאינם Hosted Targets ו-Node.js) | 15 MB | כן | בדיקת השימוש |
גודל החבילה של Hosted Targets יעדים מתארחים זמינים כרגע רק ב-Apigee Public Cloud. |
250 MB | לפי התכנון | בדיקת השימוש |
יעדים מתארחים |
התכונה יעדים מתארחים היא זכות שמגיעה עם התוכנית. |
||
| גרסאות proxy ל-API שנשמרות בהיסטוריה | 50 | לפי התכנון | בדיקת השימוש |
| גודל קובץ המשאב של שרת ה-proxy של ה-API (כמו קובצי XSL, JavaScript, Python או JAR). לא כולל משאבים של יעדי אירוח. | 15 MB | כן | בדיקת השימוש |
תוספים |
|||
| שאילתות של תוספים | 120 בקשות לשנייה לכל תוסף | לפי התכנון | לא רלוונטי |
| תוכן טעינה של תגובת התוספים | 2 MB | לפי התכנון | לא רלוונטי |
מכסה |
|||
| מרווח הזמן לסנכרון המכסות המפוזרות | >= 10 שניות | כן | בדיקת השימוש |
שימור: מטמון, KVM |
|||
| מאגרי מטמון ברמת הסביבה | 100 | לפי התכנון | בדיקת השימוש |
| פריטים במטמון | 2.5 מיליון פריטים בכל מטמון | לפי התכנון | לפי התכנון |
| גודל מפתח המטמון | 2 KB | כן | בדיקת השימוש |
| גודל הערך במטמון | 256 KB | כן | בדיקת השימוש |
| תפוגת התוקף של המטמון | 180 שניות לפחות, 30 ימים לכל היותר | לפי התכנון | בדיקת השימוש |
| מפות מפתח/ערך (KVM) ברמת הארגון | 100 | לפי התכנון | בדיקת השימוש |
| מפות מפתח/ערך (KVM) ברמת הסביבה | 100 | לפי התכנון | בדיקת השימוש |
| מפות מפתח/ערך (KVM) ברמת שרת ה-proxy | 100 שיתופיים בין כל שרתי ה-proxy ל-API שמוגדרים בארגון נתון | לפי התכנון | בדיקת השימוש |
| פריטים ב-KVM | 5 מיליון פריטים בסך הכול בכל מכונות ה-KVM בכל ההיקפים בארגון | לפי התכנון | בדיקת השימוש: ארגון סביבה proxy ל-API גרסה של proxy ל-API |
| גודל המפתח של מפת מפתחות (KVM)* | 2 KB | כן | בדיקת השימוש: ארגון סביבה proxy ל-API גרסה של proxy ל-API |
| גודל הערך של מפת מפתח/ערך (KVM)* | 10 KB | לפי התכנון | בדיקת השימוש |
|
* ב-Apigee Edge for Private Cloud, הגודל הכולל של המפתחות והערכים לא יכול לחרוג מ-15MB לכל KVM. כדי לקבוע את הגודל של מכונות ה-KVM, אפשר להשתמש בפקודה nodetool cfstats. |
|||
מפתחות, מפתחים, אפליקציות, מוצרים |
|||
| הגודל של מפתח הצרכן (מפתח ה-API) | 2 KB | כן | בדיקת השימוש |
| הגודל של סוד הצרכן | 2 KB | כן | בדיקת השימוש |
| מאפיינים מותאמים אישית שאפשר להגדיר למפתחים, לאפליקציות למפתחים, למוצרי API, לאסימוני גישה מסוג OAuth ולישויות אחרות ב-Edge | 18 | כן | בדיקת השימוש: מפתחים אפליקציות למפתחים מוצרי API אסימוני גישה |
| הגודל של שם המאפיין המותאם אישית | 1 KB | כן | בדיקת השימוש: מפתחים אפליקציות למפתחים מוצרי API אסימוני גישה |
| גודל ערך המאפיין המותאם אישית | 2 KB | כן | בדיקת השימוש: מפתחים אפליקציות למפתחים מוצרי API אסימוני גישה |
| מפתחים לכל ארגון | מיליון 1 | לפי התכנון | בדיקת השימוש |
OAuth |
|||
| תפוגת התוקף של אסימון הגישה ל-OAuth | 180 שניות לפחות, 30 ימים לכל היותר | כן | בדיקת השימוש |
| תוקף של טוקן רענון של OAuth | >= 1 day, <= 2 years | כן | לא רלוונטי |
| הגודל של אסימוני הגישה והרענון של OAuth | 2 KB | כן | בדיקת השימוש |
| מאפיינים מותאמים אישית שאפשר להגדיר בטוקני OAuth | 18 | כן | בדיקת השימוש |
| הגודל של שם המאפיין המותאם אישית | 1 KB | כן | בדיקת השימוש |
| גודל ערך המאפיין המותאם אישית | 2 KB | כן | בדיקת השימוש |
סביבה וארגון |
|||
| פורטלים למפתחים לכל ארגון | 10 | לפי התכנון | לפי התכנון |
| ארגוני הערכה | המחיקה מתבצעת אחרי 60 יום. כדאי גם לעיין בהתנאים וההגבלות של Google למוצרים של Apigee לגבי חשבונות לבדיקה. | כן | באנר בממשק המשתמש של המוצר |
| קריאות ל-Management API |
|
כן | לפי התכנון |
| שרתי יעד לכל סביבה | 500 | לפי התכנון | בדיקת השימוש |
| מארחים וירטואליים לכל סביבה | 20 | לפי התכנון | בדיקת השימוש |
| אישורי TLS לכל סביבה | 100 | לפי התכנון | בדיקת השימוש |
| מאגרי מפתחות לכל סביבה | 100 | לפי התכנון | בדיקת השימוש |
| מאגרי Truststore לכל סביבה | 1000 | לפי התכנון | בדיקת השימוש |
פורטלים |
|||
| מספר הדפים המקסימלי בכל פורטל | 1,000 | כן | לא רלוונטי |
| מספר המקסימום של ממשקי API או מוצרי API שאפשר לפרסם בכל פורטל | 1,200 | כן | לא רלוונטי |
| הגודל המקסימלי של מסמכי התיעוד של API שפורסם | 4 MB | כן | כן |
| מספר הקטגוריות המקסימלי של ממשקי API לכל פורטל | 200 | כן | לא רלוונטי |
| מספר הפריטים המקסימלי בתפריט לכל פורטל | 200 | כן | לא רלוונטי |
| מספר קבצים מקסימלי בכל פורטל | 500 | כן | לא רלוונטי |
| גודל קובץ מקסימלי | 10MB | כן | לא רלוונטי |
| שימוש מקסימלי באחסון קבצים | 100 MB | כן | לא רלוונטי |
| מספר הקהלים המקסימלי בכל פורטל | 16 | כן | לא רלוונטי |
| מספר חשבונות המפתח המקסימלי לכל קהל | 800 אלף (מספר משתמשים מקסימלי) | לפי התכנון | לא רלוונטי |
| מספר צוותי הפיתוח המקסימלי לכל קהל | 200 K | כן | לא רלוונטי |
| צוותי מפתחים לכל פורטל | 200 K | לפי התכנון | לא רלוונטי |
| מספר צוותי הפיתוח המקסימלי שיכולים להיות למפתח | 64 | כן | לא רלוונטי |
| מספר החברים המקסימלי בצוות פיתוח | 100 | כן | לא רלוונטי |
| מספר התווים המקסימלי בשדה JavaScript של סקריפטים מותאמים אישית בפורטל | 150,000 | כן | לא רלוונטי |
מערכת |
|||
| הגודל של כתובת ה-URL של בקשה ל-proxy ל-API | 7 KB | כן | בדיקת השימוש |
| גודל כותרת הבקשה | 25 KB | כן | בדיקת השימוש |
| גודל כותרת התגובה | 25 KB | כן | בדיקת השימוש |
גודל הבקשה/התגובה (גם לבקשות ללא סטרימינג וגם לבקשות בסטרימינג) דפוס נפוץ של API הוא אחזור כמויות גדולות של נתונים, כמו תמונות, מסמכים או טקסט פשוט/JSON. לנתונים בגודל של יותר מ-10MB, מומלץ להשתמש בתבנית של כתובות URL חתומות ב-Apigee. מוצרים אחרים של Google, כמו GCS (Google Cloud Storage), מספקים הטמעות עזרה שמשתמשות בתבנית הזו. |
10 MB | כן, לתוכן שלא משודר לא בסטרימינג |
שליחת בקשה באמצעות cURL ל-proxy ל-API |
|
מגבלת שורות של בקשה המגבלה שמוגדרת לכל שורה בכותרת הבקשה. |
7K | כן | בדיקת המגבלות |
|
Response Line Limit המגבלה שמוגדרת לכל שורה בכותרת התגובה. |
2K | כן | בדיקת המגבלות |
מעקב אחר API |
|||
| התראות של API Monitoring | 20 | כן | בדיקת השימוש |
| פריטי האוסף של Monitoring API | 20 | כן | בדיקת השימוש |
| תקופת שמירת הנתונים | 55 ימים |
כן | לא רלוונטי |
ממשקי API של Analytics(קריאות ל-API בלבד, לא נאכפות כשמשתמשים בממשק המשתמש) |
|||
| קריאות ל- Asynchronous Query API לכל סביבה (ענן ציבורי בלבד) | 7 שיחות לשעה | לא | לא רלוונטי |
| קריאות ל-Stats APIs לפי סביבה (Cloud ציבורי בלבד) | Postgres: 40 קריאות לדקה BigQuery: 12 קריאות לדקה |
לא | לא רלוונטי |
| קריאות ל- Data Export API לכל סביבה (ענן ציבורי בלבד) | 70 שיחות בחודש מונטיזציה מופעלת: 70 שיחות בחודש (נתונים רגילים) ו-70 שיחות בחודש (נתוני מונטיזציה) |
לא | לא רלוונטי |
מפרטים של OpenAPI |
|||
| מפרטי OpenAPI | 4MB (ראו הערה בהמשך) | כן | בדיקת גודל הקובץ במערכת המקומית |
Edge Microgateway
| אזור התכונה | מגבלה | האם חלה עליו אכיפה כרגע? | איך בודקים את השימוש הנוכחי |
|---|---|---|---|
מוצרים ושרתי proxy ל-API |
|||
| מספר המוצרים המקסימלי של ה-API שמוחזרים על ידי שרת ה-proxy של edgemicro-auth | 500 | לא | |
| המספר המקסימלי של שרתי proxy ל-API שנתמכים במכונה אחת של Edge Microgateway | 50 | לא | |
מערכת |
|||
גודל הבקשה/התגובה (גם לבקשות ללא סטרימינג וגם לבקשות בסטרימינג) דפוס נפוץ של API הוא אחזור כמויות גדולות של נתונים, כמו תמונות, מסמכים או טקסט פשוט/JSON. לנתונים בגודל של יותר מ-10MB, מומלץ להשתמש בתבנית של כתובות URL חתומות ב-Apigee. מוצרים אחרים של Google, כמו GCS (Google Cloud Storage), מספקים הטמעות עזרה שמשתמשות בתבנית הזו. |
10 MB | לא |
שליחת בקשה באמצעות cURL ל-proxy ל-API |
| הזמן הקצוב לתפוגה של חיבור ליעד | 600 שניות | לא | |
במאמר מגבלות מפורטות המגבלות על המוצרים העדכניים של Apigee ו-Apigee Hybrid.
המידע שלמעלה מייצג את המגבלות הנוכחיות על המוצרים. Google שומרת לעצמה את הזכות לשנות את התכונות והפונקציונליות של המוצרים או את המגבלות שלמעלה לאחר הפרסום שלהם או לאחר שהן יהיו נגישות בדרך אחרת.