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