ההבדלים בין Apigee Edge ל-Apigee X

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

בנושא הזה מתוארים ההבדלים בין Apigee X (שמכונה לפעמים גם "Apigee") לבין Apigee Edge. המידע הזה מיועד ללקוחות קיימים של Apigee Edge ששוקלים לעבור ל-Apigee X.

מידע נוסף על התכונות של Apigee X זמין בסיכום התכונות של Apigee X.

בטבלה הבאה מפורטים מוצרי הניהול של Apigee API, שנעשה בהם השוואה בנושא הזה:

מוצר היכן מתארח בניהול
Apigee Edge לענן הציבורי הענן של אפיג' Apigee
Apigee Edge לענן פרטי מרכז הנתונים הפרטי של הלקוח. לקוח/ה
אפיג' X Google Cloud Apigee
Apigee היברידי גם Google Cloud וגם מרכז הנתונים הפרטי של הלקוח Apigee מנהלת את מישור הניהול והלקוח מנהל את מישור זמן הריצה.

השוואה בין תכונות מ-Apigee Edge ל-Apigee X

בקטעים הבאים נשווה בין התכונות של הענן הציבורי/הפרטי של Apigee Edge לבין הזמינות של התכונות ב-Apigee X ובגרסה ההיברידית.

שימו לב שגם המגבלות של Apigee X שונות מהמגבלות של Apigee Edge.

סיכום של ההבדלים הנוכחיים בתכונות

בטבלה הבאה מתוארים ההבדלים ברמת הפיצ'ר בין Apigee X (וההיברידי) לבין Apigee Edge לפלטפורמות של ענן ציבורי ופרטי.

תכונה של Apigee Edge תמיכה ב-Apigee X ובממשק היברידי
מהדורות של שרת proxy ל-API

לא משתנה בזמן הפריסה
בדיקות תקינות פעילות נתמכת עבור MIG חיצוניים (שבהם נעשה שימוש במכונות VM). אין תמיכה כשמשתמשים ב-Private Service Connect. למידע על סוגי הניתוב, קראו את המאמר הגדרת הניתוב.
Apigee Adapter ל-Istio הוצא משימוש: מומלץ להשתמש ב- Apigee Adapter ל-Envoy במקום זאת.
חברות ומפתחים

יש פתרון דומה אבל לא זהה. למידע נוסף, ראו שימוש בקבוצות AppGroup לארגון הבעלות על אפליקציות.

CwC (קוד עם Config)

לפי התכנון
פריסות
  • פריסות אסינכרוניות
  • אחזור סטטוס הפריסה מבוסס על הפעם האחרונה שבה מישור זמן הריצה 'עשה צ'ק-אין' במישור הניהול
סביבות
  • תמיכה בקבוצות של סביבה
  • שירות עצמי דרך ממשק המשתמש וממשקי ה-API של Apigee
  • גמישות רבה יותר בהצגת הטופולוגיה
  • אפשר להשתמש ב-Pod MP רק בסביבה אחת.

מידע נוסף זמין במאמר מידע על סביבות וקבוצות של סביבה.
יעדים מתארחים

צריך להשתמש ב-Cloud Run או ב-Cloud Functions
טיפול בשמות של שדה בכותרת HTTP/1.1 ממירה שמות של שדות כותרת HTTP/1.1 לאותיות קטנות כאשר הם מועברים לקצה העורפי. ב-Apigee Edge נשמרת הרישיות של שמות שדות הכותרת.
תפקידי IAM לבקרת גישה פרטנית מבוססת-תפקידים

לפי התכנון
JSONPath באמצעות [@.length-x]

השימוש ב-[@.length-x] בביטויים של JSONPath אינו נתמך ב-Apigee X. במפרט של JSONPath מצוין שהביטויים תלויים בשפת הסקריפט הבסיסית. length-x הוא מבנה JavaScript ולא Java, ו-[@.length-x] לא יושם כחלק מהמפרט. ב-Apigee X, הביטוי [@.length-x] מוחלף על ידי סכימת האינדקס ([-x]).

בדוגמה הזו:

{
    "books": [
      {
        "name": "A",
      },
      {
        "name": "B",
      }
    ]
}

הקלט: $.books[@.length-1] מחזיר {“name”: “B”} ב-Apigee Edge ומחזיר את הערך [{“name”: “B”}] ב-Apigee X.
מאגרי מפתחות או Truststores

מנוהלת צפונה כסודות ב-Kubernetes
מכונות KVM
  • בממשק המשתמש של Apigee אפשר ליצור מכונות KVM מוצפנים עם רמת סביבה. מכונות ה-KVM תמיד מוצפנות. לא ניתן להוסיף, לעדכן או להציג רשומות KVM בממשק המשתמש.
  • משתמשים במאפיין private. בכל המשתנים שניגשים ל-KVM באמצעות הפקודה GET, כדי להסתיר את פרטי ה-KVM בסשן ניפוי באגים (Trace). אם לא נעשה שימוש במאפיין private., ה-KVM עדיין מוצפן. עם זאת, פרטי ה-KVM יופיעו מפוענחים במעקב אחר ניפוי הבאגים), ולא ניתן יהיה להפעיל חריגות.
  • אפשר לנהל רשומות KVM באמצעות keyvaluemaps.entries API או המדיניות של KeyValueMapOperations.
  • אפשר להשתמש בקבוצות של נכסים עבור חלק מהתרחישים לדוגמה של מכונות KVM. לפרטים, קראו את המאמר שימוש בקבוצות נכסים.
  • הרכיב <MapName> מאפשר למדיניות KeyValueMapOperations לזהות באיזה KVM יש להשתמש באופן דינמי, בזמן ריצה.

מידע נוסף על יצירת מכונות KVM בממשק המשתמש זמין במאמר שימוש במפות של ערכי מפתח. מידע נוסף על בחירת המנגנון המתאים לשמירת נתונים, זמין במאמר גישה לנתוני התצורה.
Microgateway במקומו מומלץ להשתמש ב-Apigee Adapter ל-Envoy.
מונטיזציה מידע נוסף על ההבדלים בנושא המונטיזציה
Node.js
  • אין תמיכה בשרתי proxy של Node.js API.
  • ההמלצה של Apigee היא לארח אפליקציות של Node.js כקונטיינרים נפרדים ב-Kubernetes (אשכול זהה או שונה)
mTLS צפונה לפי התכנון
OAuth מדיניות חדשה של ביטול OAuthv2 מבוטלת לפי מזהה משתמש קצה, מזהה אפליקציה או שניהם. המדיניות הזו מחליפה את Apigee Edge API לביטול אסימוני OAuth2.
כללי המדיניות
  • כללי המדיניות החדשים:
  • אין תמיכה במדיניות:
    • מדיניות StatisticsCollector (מחליפה את המדיניות החדשה DataCapture)
  • כללי המדיניות שהשתנו:
reasonPhrase ההודעה לא נתמכת.
מקורות מידע אי אפשר להשתמש במשאבים ברמת הארגון
תפקידים והרשאות
  • מנוהלות דרך שירות IAM של מסוף Google Cloud
  • יש כמה תפקידים חדשים שאפשר להגדיר
  • יש לך אפשרות ליצור תפקידים בהתאמה אישית שיכולים לכלול הרשאות אחרות ב-Google Cloud

למידע נוסף אפשר לקרוא את המאמר משתמשים ותפקידים.
Sense כדאי להשתמש באבטחה ב-API מתקדם.
שירותי SOAP באשף בניית שרת proxy ההודעה לא נתמכת. למידע נוסף אפשר לקרוא את המאמר wsdl2apigee, פרויקט קוד פתוח שמספק תוכניות שירות של SOAP לשימוש עם Apigee.
סשנים של מעקב וניפוי באגים לעיון בהבדלים עם Trace
מארחים וירטואליים

עבור Apigee היברידי:

  • תעבורת הנתונים הנכנסת (ingress) מיושמת באמצעות Anthos Service Mesh.
  • המפתחות והאישורים פרוסים ישירות ב-Kubernetes.

עבור Apigee X:

  • כל מכונה חושפת נקודת קצה של HTTPS באמצעות אישור בחתימה עצמית. ניתן להוריד את ה-CA של האישור על ידי שליחת שאילתות לארגון.

הבדלים עם 'מעקב'

בטבלה הבאה ניתן לראות את ההבדלים באופן הפעולה של Trace ב-Apigee X ובגרסה היברידית לעומת Apigee Edge Cloud:

התכונה ענן Apigee Edge Apigee X וגרסה היברידית
לוח זמנים זמן אמת, סינכרוני השהיה קלה; אסינכרוני
שם/מזהה סשן המשתמש יכול לקבל את שם הסשן לא מקבל את שם הסשן מהמשתמש
מסננים תמיכה בסיסית בסינון, כגון סינון של כותרות ופרמטרים של שאילתות תמיכה בלוגיקת סינון מורכבת, כולל פעולות לוגיות של AND ו-OR. גישה לכל משתנה זרימה שהוזכר בהפניה למשתני זרימה. התחביר זהה לאופן השימוש בתנאים, כפי שמוצג בהפניה לתנאים.
זמן קצוב לתפוגה של סשן

המדיניות הזו מגדירה את משך הסשן של ניפוי הבאגים ואת משך הזמן שבו הנתונים נשמרים.

ערך ברירת המחדל הוא 20 דקות כשמפעילים אותו דרך קריאות ל-API, ו-10 דקות כשמפעילים אותו בממשק המשתמש.

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

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

הנתונים נשמרים למשך 24 שעות לפני שהמערכת מוחקת אותם באופן אוטומטי על ידי מערכת היברידית.
תקינות סשנים

משך הזמן שבו הבקשה ליצירת סשן חוקית. אם הסשן של ניפוי הבאגים לא מתחיל בפרק הזמן הזה, הסנכרן יכולים להתעלם מהבקשה ליצירת הסשן. חשוב לוודא שהשעונים של מכשירי הסנכרן מסונכרנים, כפי שמתואר בדרישות המוקדמות.
מספר בקשות מעקב עד 20 לכל מעבד הודעות ברירת המחדל היא 10 לכל מעבד הודעות, המקסימום הוא 15.
API ענן Apigee Edge Apigee X
Apigee X חושף את Debug Session API ואת Debug Session Data API, אבל הוא לא תומך בממשקי ה-API הבאים של Apigee X API:
הפסקת הסשן של ניפוי הבאגים

מחיקה של עסקאות ספציפיות

הבדלים בנוגע למונטיזציה

בטבלה הבאה מוצגת השוואה של התכונות העיקריות בין המונטיזציה ב-Apigee Edge לבין המונטיזציה ב-Apigee X.

מונטיזציה ב-Apigee Edge Apigee X/מונטיזציה היברידית
תוכניות תמחור ותשלומים משויכות לחבילות מוצרים של API שאפשר לצרף לכמה מוצרי API תוכניות התעריפים משויכות למוצרי API (קשר של אחד לאחד)
תוכניות תעריפי רכישה של מפתחי אפליקציות מפתחי אפליקציות רוכשים מוצרי API
המכסות מנוהלות ברמת שרת ה-proxy של ה-API המכסות מנוהלות ברמת המוצר של ה-API (ברמת העסק)
תוכניות תעריפים שפורסמו הן רק שפג תוקפן. אי אפשר לערוך או למחוק אותן אפשר לקבוע שתוכניות תעריפים שפורסמו כבר לא בתוקף, לערוך אותן, להעביר אותן לטיוטה או למחוק אותן
תצורה מורכבת (ללא אשף או כלי תצוגה מקדימה) הגדרה פשוטה יותר של תוכניות תעריפים באמצעות אשף וכלי התצוגה המקדימה
המדיניות MonetizationLimitsCheck חוסמת את הגישה לאחר העיבוד של הקריאה הראשונה ל-API אם מפַתח האפליקציה לא רכש מינוי המדיניות MonetizationLimitsCheck חוסמת את הגישה באופן מיידי אם מפתחי האפליקציות לא רכשו מינוי או חורגים מהמכסה
אפשר לתעד את נתוני המונטיזציה של העסקאות באמצעות משתנים מותאמים אישית במדיניות בנושא תיעוד עסקאות. Apigee מתעדת באופן אוטומטי נתוני מונטיזציה, וניתן לבטל נתוני מונטיזציה של עסקאות באמצעות מדיניות DataCapture. למידע נוסף, אפשר לקרוא את המאמר תיעוד נתוני מונטיזציה.
אפשר להגדיר חשבונות בתשלום מראש וחשבונות של תשלום לאחר השימוש גם למפתחים וגם לתוכניות תמחור ותשלומים. רק מפתחים יכולים להגדיר חשבונות בתשלום מראש וחשבונות של תשלום לאחר השימוש (postpay).

אילו תכונות של Apigee Edge לא נתמכות ב-Apigee X?

Google לא מתכננת לתמוך בתכונות הבאות:

  • תוספי Apigee Edge
  • חנות המפרט של OpenAPI
  • ממשקי API לחיפוש או לביטול אסימוני גישה מסוג OAuth (כי האסימונים עוברים גיבוב)
  • מדיניות OAuth v1 או OAuthv1.0a של OAuth
  • Trireme (EOL בתאריך 10/10/2019)
  • כותרות עם קידומת "X-Apigee-" אינן נתמכות ב-Apigee X, והמערכת מסירה אותן מהבקשות והתגובות לפני השליחה ליעדים וללקוחות.

השוואה בין API

באופן כללי, לרוב ממשקי ה-API של Apigee Edge יש ממשקי API של Apigee API. הקטע הזה כולל:

סיכום השינויים שבוצעו באמצעות ה-API

בהמשך מפורטים השינויים בהתנהגות בכל ממשקי ה-API של Apigee X בהשוואה לממשקי API של Apigee Edge.

התנהגות ממשקי API של Apigee Edge ממשקי API של Apigee X
דומיין בסיסי api.enterprise.apigee.com apigee.googleapis.com
סוגי מדיה application/json
application/xml		 application/json
אימות OAuth2, SAML, Basic OAuth2
חותמות זמן במפתחות פורמט int64 
{
  "createdAt": 1234,
  "lastModifiedAt": 5678
}
 פורמט String 
{
  "createdAt": "1234",
  "lastModifiedAt": "5678"
}
המבנה של פרמטר שאילתה expand=false 
[
        "helloworld",
        "weather"
      ]
 
{
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
}
פרמטרים של שאילתה מופיעים עם קו תחתון נתמכים (_optimal=true) לא נתמך (optimal=true)
נכסים במטענים ייעודיים (payload):
  • created_by
  • modified_by
  • self
 נתמך לא נתמכים
ערכי ברירת מחדל במטענים ייעודיים (payloads) כלולה לא כלולה
טיפול בשגיאות במבנה 
{
        "code": "...",
        "message": "..",
        "contexts": []
      }
 
{
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}
תגובה למחיקת מטמון החזרות: 200 OK ופרטי המטמון החזרות: 204 No Content
פעולות ב-Cache API רשימה, יצירה, get, עדכון, מחיקה, ניקוי הכל ו ניקוי. הצגה של רשימה ו מחיקה בלבד. מטמון L1 לטווח קצר נוצר באופן אוטומטי כשפורסים שרת proxy ל-API. מידע נוסף מופיע במאמר נתונים פנימיים של מטמון.

ההבדלים בין ממשקי ה-API של המדדים Apigee Edge ו-Apigee X

בסיכום השינויים שבוצעו באמצעות ה-API מפורטים ההבדלים הכלליים בין Apigee Edge API לבין Apigee X API. בטבלה הבאה מפורטים הבדלים ספציפיים בין ממשקי ה-API של המדדים:

התכונה ממשקי API של Apigee Edge ממשקי API של Apigee X
נקודת הקצה ל-API api.enterprise.apigee.com apigee.googleapis.com
אימיילים יומיים בנושא ניתוח נתונים אין ממשקי API נתמכים
ממשק API של רשימת שאילתות אסינכרונית קבלת רשימה של שאילתות ניתוח אסינכרוניות המאפיין userId הושמט מהתגובה. למידע נוסף, אפשר לקרוא את השיטה: Organizations.environments.queries.list.
ממשקי API של דוחות בהתאמה אישית Reports API המאפיינים createdBy ו-lastModifiedBy הוסרו מהתגובה. מידע נוסף זמין במאמר Reports API.

ממשקי API של Apigee Edge שאינם נתמכים

בטבלה הבאה מפורטים ממשקי ה-API של Apigee Edge שאינם נתמכים (שאין להם מקבילים ל-Apigee X API).

קטגוריית API ממשקי API של Apigee Edge שאינם נתמכים
מעקב באמצעות API אין ממשקי API נתמכים
ממשקי proxy ל-API
  • אילוץ ביטול הפריסה של שרת proxy של API
  • קבלת יחסי תלות של npm
  • ניהול מודולים של npm
ביקורות שימוש ב-Stackdriver Logging API
יומנים במטמון אין ממשקי API נתמכים
חברות אין ממשקי API נתמכים
אפליקציות של החברה אין ממשקי API נתמכים
משפחת אפליקציות של החברה אין ממשקי API נתמכים
מפתחות לאפליקציות של החברה אין ממשקי API נתמכים
סשנים של ניפוי באגים
  • לא ניתן להפסיק סשנים של מעקב
  • לא ניתן למחוק עסקאות בודדות

מידע נוסף זמין במאמר הבדלים עם נתוני המעקב.
אפליקציה למפתחים קבלת מספר משאבי ה-API
משפחה של אפליקציות למפתחים אין ממשקי API נתמכים
תוספים אין ממשקי API נתמכים
Keystore: Truststore בדיקת מאגר מפתחות או Truststore
LDAP אין ממשקי API נתמכים
מונטיזציה אין ממשקי API נתמכים
OAuth גרסה 2 אין ממשקי API נתמכים
כללי מדיניות אין ממשקי API נתמכים
קובצי משאבים
  • היקף הגרסה של שרת ה-API של ה-API
  • היקף ההרשאות של הארגון
Sense אין ממשקי API נתמכים
תפקידי משתמשים ומשתמשים שימוש בממשקי API שקשורים לניהול הזהויות והרשאות הגישה (IAM), כפי שמתואר במאמר ניהול משתמשים, תפקידים והרשאות באמצעות ממשקי API.
מארחים וירטואליים אין ממשקי API נתמכים

Apigee Edge לענן פרטי לעומת Apigee היברידי

בטבלה הבאה מוצגת השוואה בין Apigee Edge לענן פרטי לבין Apigee היברידי:

שירות אזור המוצרים או התכונות של Apigee
Apigee Edge לענן פרטי Apigee היברידי
Analytics שרתי Qpid ו-Postgres רצף איסוף הנתונים במישור זמן הריצה משתמש ב-fluentd וב-UDCA (סוכן לאיסוף נתונים אוניברסלי) כדי לאסוף ניתוחי נתונים ולהזין את הנתונים ל-UAP (Unified Analytics Platform) במישור הניהול.
API Proxy Gateway מעבד בקשות מעבד ההודעות (MP) מעבד בקשות נכנסות. קובצי MP מוטמעים כאפליקציה אחת או יותר בקונטיינרים במישור זמן הריצה.
התמדה צומת או טבעת של קסנדרה Cassandra מספקת הגדרות עקביות לתכונות KMS, KVM, מכסות ומטמון.
פריסה ZooKeeper באמצעות הסנכרון אפשר לוודא שההגדרות של שרת ה-API של ה-API, המידע לגבי הסביבה ונתונים אחרים מעודכנים בין מישור הניהול לבין מישור זמן הריצה.
ממשק משתמש מנהלי ממשק המשתמש של Apigee Edge מתארח בשרת הניהול ממשק המשתמש של Apigee מתארח במישור הניהול.
איזון עומסים נתב בקר Istio Ingress מעביר בקשות להצגת מעבד הודעות (MP) באפליקציה בקונטיינרים במישור זמן הריצה.
ממשקי API שרת ניהול אפשר לגשת ל-Apigee X APIs דרך שרת הניהול ו-MART. MART יוצר אינטראקציה עם מאגר הנתונים המקומי של Cassandra, ומשמש כספק API של ממשקי ה-API של Apigee X, כדי לגשת לישויות של נתוני זמן ריצה ולנהל אותן.
מדדים כל רכיב שהוגדר באמצעות JMX מנוהל על ידי שרת Prometheus יחיד לכל אשכול עבור כל השירותים.