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