4.16.09 – נתוני גרסה של Edge לענן פרטי

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X.
מידע

ביום שני, 19 בספטמבר 2016, השקנו גרסה חדשה של Apigee Edge for Private Cloud.

מאז הגרסה הקודמת של Edge for Private Cloud, הגרסאות הבאות הופצו ונכללות בגרסה הזו:

במאמר מידע על מספור הגרסאות מוסבר איך אפשר לדעת אם גרסה ספציפית של Edge for Private Cloud כוללת גרסה מסוימת של Cloud.

סקירה כללית של הגרסה

בגרסה הזו, הסרנו את הגרסה הקלאסית של כלי העריכה של שרתי proxy ל-API, והחלפנו אותה בכלי העריכה החדש של שרתי proxy, שהיה זמין לשימוש לצד הגרסה הקלאסית של כלי העריכה. שיפורים משמעותיים נוספים כוללים שיפור בהתנהגות של נתיבי משאבים של מוצרי API, שיפור בטיפול במטענים ייעודיים (payloads) של JSON שמוגדרים במדיניות של Assign Message ו-Raise Fault, שיפורים בהמרות מ-XML ל-JSON, שיפור באימות משאבים, אפשרות להגדיר פסק זמן (timeout) לכל proxy ל-API בנפרד, עדכון של יצירת proxy ל-API של SOAP באשף של proxy ל-API ואובייקט Crypto עם ביצועים גבוהים ל-JavaScript.

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

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

הוצא משימוש

שירותי API

הוסר הכלי הקלאסי לעריכת שרת Proxy (ממשק משתמש של Cloud 16.04.20)

הגרסה החדשה של הכלי לעריכת שרתי proxy של API היא עכשיו הגרסה היחידה שנתמכת. הגרסה הקלאסית כבר לא זמינה, והקישור 'גישה לגרסה הקלאסית של כלי העריכה של שרת ה-Proxy' הוסר. אם השתמשתם בגרסה הקלאסית, פרוקסי ה-API שלכם ייטענו אוטומטית בכלי העריכה החדש. (EDGEUI-498)

מונטיזציה

התכונות הבאות שהוצאו משימוש הוסרו ולא נתמכות יותר:

  • הגדרת מגבלות
  • התראות על הגעה למגבלת שליחה

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

(DEVRT-2742)

עדכונים ותכונות חדשות

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

פרטים נוספים והוראות זמינים במסמכי התיעוד של Edge for Private Cloud.

ענן פרטי

שדרוג של PostgreSQL לגרסה 9.4

הגרסה הזו כוללת שדרוג ל-Postgres 9.4. הוראות לעדכון המערכת מופיעות במאמר עדכון Apigee Edge לגרסה 4.16.09.

תמיכה ב-GeoMap בממשק המשתמש של Edge

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

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

API BaaS

הוספנו מסמכים בנושאים הבאים:

  • איך מגדירים API BaaS לשימוש ב-TLS. מידע נוסף זמין במאמר בנושא הגדרת TLS ל-API BaaS.
  • איך מגדירים את כל הצמתים של API BaaS Stack לשימוש באחסון משותף, כך שכל הנכסים יהיו זמינים לכל הצמתים של API BaaS Stack. מידע נוסף זמין במאמר בנושא העלאת נכסים.
  • איך מצפינים סיסמת Cassandra כשמגדירים צמתים של BaaS Stack. מידע נוסף זמין במאמר איפוס סיסמאות ב-Edge.

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

הגרסה הזו כוללת גרסת בטא של כלי הניטור החדש ולוח הבקרה החדש ל-Edge. הכלי הזה מאפשר לכם להבין את תקינות הרכיבים השונים (נתבים, מעבדי הודעות, ZooKeeper, ‏ Cassandra) וגם את קודי שגיאות ה-HTTP של ארגונים וסביבות שונים בפריסה שלכם. אפשר גם לצלם תמונה של נתוני לוח הבקרה ולשתף אותה עם Apigee כדי לעזור בפתרון בעיות שקשורות לתמיכה.

המסמכים, כולל הוראות ההתקנה, כלולים במסמך Edge 4.16.09 בכתובת Version 4.18.01.

עם זאת, לפני שתוכלו להתקין את לוח הבקרה ולהשתמש בו, תצטרכו למלא את הסכם ההערכה של Apigee, שזמין גם בכתובת Version 4.18.01, ולשלוח אותו בחזרה ל-Apigee באימייל לכתובת orders@apigee.com.

גרסת בטא של כלי לאיסוף נתונים לצורך ניתוח

כל הלקוחות של Edge for Private Cloud נדרשים לשלוח ל-Apigee נתונים סטטיסטיים על תעבורת ה-API proxy. ‫Apigee ממליצה ללקוחות להעלות את המידע הזה פעם ביום, אולי על ידי יצירת משימת cron.

כדי לעזור בהעלאת הנתונים האלה, Apigee מספקת את גרסת הבטא של כלי שורת הפקודה apigee-analytics-collector. הכלי הזה שולח את דוח נפח הקריאות ל-API בחזרה אל Apigee. כל התקנה של Edge for the Private Cloud יכולה להשתמש בכלי הזה כדי לאחזר נתוני תנועה ולדווח עליהם ל-Apigee.

מידע נוסף מופיע במאמר העלאת נתוני תנועה של API אל Apigee – גרסת בטא.


שירותי API

מטענים ייעודיים (payloads) של JSON בפעולות Assign Message ו-Raise Fault ‏(Cloud 16.08.17)

כשמגדירים מטען ייעודי (payload) של JSON באמצעות מדיניות Assign Message או Raise Fault, לפעמים נדרשו פתרונות עקיפים כדי לוודא שפורמט הודעת ה-JSON תקין בזמן הריצה, למשל התחלת המטען הייעודי בקו נטוי הפוך '\' או ציון variablePrefix ו-variableSuffix ברכיב Payload, גם אם לא נעשה שימוש במשתנים בהודעה.

השיפור הזה מאפשר להשתמש במשתנים באמצעות סוגריים מסולסלים בלי ליצור קובץ JSON לא תקין, כך שלא צריך פתרונות עקיפים כדי לוודא שפורמט הודעת ה-JSON תקין. לדוגמה, הפקודה הבאה מוסיפה את הערך של message.content להודעת ה-JSON:

<Payload contentType="application/json">{"Message: " : "{message.content}"}</Payload>

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

אפשר לעיין ברכיב <Set><Payload> במסמכי העיון בנושא הקצאת מדיניות להודעה והעלאת מדיניות שגיאה. (APIRT-1160)

שיפורים במדיניות XML ל-JSON (Cloud 16.08.17)

הוספנו את היכולות הבאות למדיניות XML ל-JSON. אפשר להגדיר את המדיניות כך:

  • התייחסות לחלק מאלמנטי ה-XML כמערכים במהלך ההמרה, כך שהערכים מוצבים בסוגריים מרובעים '[ ]' במסמך ה-JSON.
  • הסרה או ביטול של רמות בהיררכיה של מסמך ה-XML במסמך ה-JSON הסופי.

מידע נוסף מופיע במאמר בנושא מדיניות XML to JSON. (APIRT-1144)

שימוש בכמה תווים כלליים בנתיבי משאבים של מוצרי API‏ (Cloud 16.08.17)

כשמגדירים נתיבי משאבים ב-API Product, אפשר לכלול תווים כלליים בכמה מקומות בנתיב משאב. לדוגמה, /team/*/invoices/** מאפשר שליחת קריאות ל-API עם כל ערך אחרי /team ועם כל נתיב משאב אחרי invoices/. דוגמה ל-URI מותר בקריאה ל-API:‏ proxyBasePath/team/finance/invoices/company/a.

אם אחרי הפרסום הזה נתיבי המשאבים הקיימים של מוצר ה-API מפסיקים לפעול כצפוי, צריך להגדיר את המאפיין הבא בארגון כדי לחזור להתנהגות הקודמת: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

פונקציות קריפטוגרפיות ב-JavaScript‏ (Cloud 16.08.17)

זמין סט חדש של פונקציות JavaScript crypto עם ביצועים גבוהים ליצירה, לקבלת ולעדכון של האובייקטים הבאים של הגיבוב: MD5,‏ SHA-1,‏ SHA256,‏ SHA512. אובייקט crypto מאפשר גם לקבל את התאריך בפורמטים שונים. מידע נוסף זמין במאמר בנושא מודל אובייקטים של JavaScript. (APIRT-2886)

בדיקת גרסת JAR של Java Callout (Cloud 16.08.17)

כשמעלים משאב Java JAR ל-proxy ל-API, מוחזר קוד סטטוס HTTP 400 (במקום 500) אם הגרסה של משאב Java לא תואמת לגרסה של Java שנתמכת ב-Edge, שמפורטת במאמר תוכנות נתמכות וגרסאות נתמכות. (MGMT-3420)

אימות משאבים של proxy ל-API‏ (Cloud 16.08.17)

אם יש לכם קבצים של משאבי proxy ל-API (כמו JavaScript או Java JAR) שמאוחסנים בהיקף הסביבה או הארגון, לא תצטרכו יותר לכלול את המשאבים האלה גם ברמת ה-proxy ל-API בחבילת proxy כדי שהייבוא יעבור את האימות. אימות המשאבים מתבצע עכשיו בזמן הפריסה, ולא בזמן הייבוא. (MGMT-1430)

הגדרת פסק זמן לשרתי proxy ספציפיים של API‏ (Cloud 16.08.17)

אפשר להגדיר שפרוקסי של API יפסיק לפעול אחרי פרק זמן מסוים (עם סטטוס של gateway timeout‏ 504). תרחיש השימוש העיקרי הוא ללקוחות Private Cloud שיש להם שרתי proxy של API שלוקח להם יותר זמן לפעול. לדוגמה, נניח שאתם צריכים שפרוקסי ספציפיים יפסיקו לפעול אחרי 3 דקות. אפשר להשתמש במאפיין api.timeout חדש בהגדרה של proxy ל-API. כך עושים זאת בדוגמה של 3 דקות:

  1. קודם כול, חשוב להגדיר את איזון העומסים, הנתב ומעבד ההודעות כך שיופעל פסק זמן אחרי 3 דקות.
  2. לאחר מכן, מגדירים את שרתי ה-proxy הרלוונטיים כך שזמן הקצוב לתפוגה שלהם יהיה 3 דקות. מציינים את הערך באלפיות שנייה. לדוגמה:
    <ProxyEndpoint name="default">
      <HTTPProxyConnection>
        <BasePath>/v1/weather</BasePath>
        <Properties>
          <!-- api.timeout is in milliseconeds -->
          <Property name="api.timeout">180000</Property>
        </Properties>
        ...
  3. עם זאת, חשוב לזכור שהגדלת ערכי הזמן הקצוב לתפוגה של המערכת עלולה לגרום לבעיות בביצועים, כי כל שרתי ה-proxy ללא הגדרה של api.timeout משתמשים בערכי הזמן הקצוב לתפוגה החדשים והגבוהים יותר של מאזן העומסים, הנתב ומעבד ההודעות. לכן, כדאי להגדיר ששרתי proxy אחרים של API שלא דורשים פסק זמן ארוך יותר ישתמשו בפסק זמן קצר יותר. לדוגמה, הקוד הבא מגדיר ש-proxy ל-API יפסיק לפעול אחרי דקה:
    <Property name="api.timeout">60000</Property>

לקוחות Cloud שלא יכולים לשנות את הזמן הקצוב לתפוגה של Edge יכולים גם להגדיר זמן קצוב לתפוגה של proxy ל-API, בתנאי שהזמן הקצוב לתפוגה קצר יותר מהזמן הקצוב לתפוגה הרגיל של מעבד ההודעות של Edge, שהוא 57 שניות.

אי אפשר לאכלס את הערך באמצעות משתנה. המאפיין הזה מוסבר במאמר מאפייני נקודת הקצה לעיון. (APIRT-1778)

התנהגות של שרת proxy של SOAP כשמשתמשים באשף ה-proxy (ממשק משתמש של Cloud 16.07.27)

כשיוצרים שרת proxy מבוסס-SOAP מ-WSDL באמצעות אשף ה-proxy, יש שתי אפשרויות ליצירת ה-proxy:

  • Pass-Through SOAP, שבו ה-proxy פשוט מעביר מטען ייעודי (payload) של בקשת SOAP כמו שהוא.
  • REST to SOAP to REST, שבו ה-Proxy ממיר מטען ייעודי (payload) נכנס כמו JSON למטען ייעודי (payload) של SOAP, ואז ממיר את התגובה של SOAP בחזרה לפורמט שהמתקשר מצפה לו.

הגרסה הזו כוללת את העדכונים הבאים לגבי אופן הפעולה של האפשרויות האלה. ההבדלים בין ההתנהגות הישנה לחדשה נמצאים במדיניות ובהגדרות שנוצרות באופן אוטומטי על ידי אשף ה-Proxy.

Pass-Through SOAP

  • כל פעולות ה-WSDL נשלחות עכשיו לנתיב הבסיס של ה-proxy ‏'/' ולא למשאבי ה-proxy (כמו '/cityforecastbyzip'). שמות הפעולות מועברים לשירות היעד של SOAP. ההתנהגות הזו תואמת למפרט SOAP.

  • ה-proxy שנוצר כבר לא תומך ב-JSON בבקשה. הוא תומך רק ב-XML. שרת ה-proxy מוודא שבקשות SOAP כוללות Envelope,‏ Body ומרחב שמות.

REST ל-SOAP ל-REST

  • אין תמיכה ב-WSDL 2.0.
  • ההתנהגות החדשה לא נבדקה עם WS-Policy.
  • הפרוקסי מאפשר לכם להשתמש בנתוני JSON במקום ב-FormParams.
  • כשמוסיפים תמיכה ב-CORS (שיתוף משאבים בין מקורות) לשרת ה-proxy באמצעות הכלי ליצירת שרת proxy, יופיעו השיפורים הבאים:
    • הכותרת Access-Control-Allow-Headers: בנוסף לכותרות Origin,‏ x-requested-with ו-Accept, הכותרת Access-Control-Allow-Headers כוללת גם את הכותרות Content-Type,‏ Accept-Encoding,‏ Accept-Language,‏ Host,‏ Pragma,‏ Referrer,‏ User-Agent ו-Cache-Control.
    • הכותרת Access-Control-Allow-Methods: בנוסף ל-GET, PUT, ‏ POST, ‏ DELETE, הכותרת הזו כוללת גם את הפעלים PATCH ו-OPTIONS.
  • כשיוצרים proxy ל-API עבור WSDL, ‏ Edge קורא את כל ה-ComplexTypes שמוגדרים כ-abstract ב-WSDL ומזהה בצורה נכונה את כל סוגי המופעים שמבוססים על הסוגים ה-abstract.

כלי שורת הפקודה בקוד פתוח wsdl2apigee

בנוסף, Apigee מספק כלי שורת פקודה בקוד פתוח ליצירת שרתי proxy של API מסוג passthrough או rest-to-soap מ-WSDL. מידע נוסף זמין בכתובת https://github.com/apigee/wsdl2apigee.

(EDGEUI-614)

ברירת מחדל של תפוגה/רענון במדיניות Key Value Map Operations (ממשק משתמש של Cloud 16.06.15)

המדיניות Key Value Map Operations (פעולות של מיפוי ערכי מפתח) מאפשרת לכם לקבוע כמה זמן הערכים נשמרים לפני שהם מתעדכנים. מרווח הרענון מוגדר באמצעות הרכיב <ExpiryTimeInSecs>. אם מתבצעת פעולת GET והמרווח עד לתפוגה חלף, הערך מתעדכן והמדיניות מקבלת את הערך המעודכן. כשמוסיפים את המדיניות הזו ל-proxy ל-API, מועד התפוגה שמוגדר כברירת מחדל הוא עכשיו 300 שניות. (ערך ברירת המחדל הקודם היה ‎-1, כלומר הערכים אף פעם לא מתעדכנים). (EDGEUI-579)


מונטיזציה

תוכנית עם שיעור התראות שניתן להתאמה (ממשק משתמש של Cloud מ-16.04.20, מונטיזציה של Cloud מ-16.04.13)

במונטיזציה של Edge, תוכנית חדשה של שיעור התראות שניתן להתאמה מאפשרת לספק API להתאים את מספר העסקאות הממוקד לכל מפתח אפליקציות. אתם יכולים להגדיר אם ומתי יישלחו התראות, על סמך אחוז ההתקדמות לעבר מספר היעד, למשל 90%, 100% או 150%. התכונה הזו זמינה דרך ממשק המשתמש לניהול, בנוסף ל-API לניהול (שהיה זמין בגרסה קודמת). מידע נוסף מופיע במאמר בנושא הגדרת פרטים של תוכנית התראות שניתנים לשינוי. (DEVRT-2375, DEVRT-2370)

התראות webhook לתוכניות עם קצב התראות שניתן להתאמה (מונטיזציה ב-Cloud 16.04.27 )

בתוכניות עם תעריפים משתנים להתראות, אפשר ליצור וווב-הוקים ששולחים התראות לכתובת ה-URL שאתם מציינים. אפשר גם לשלוט בהתראות כך שיופיעו במרווחי זמן ספציפיים (באחוזים) עד שמגיעים לתקרת התשלומים. התראות Webhook הן חלופה גמישה לשימוש בתבניות ההתראות הקיימות. מידע נוסף מופיע במאמר בנושא הגדרת התראות באמצעות webhooks. (DEVRT-2393, DEVRT-2394)

התראה שניתנת להתאמה אישית עם תוכנית תמחור של מאפיין מותאם אישית (ממשק משתמש של Cloud מ-16.05.18)

במונטיזציה של Edge, תוכנית תמחור חדשה בשם 'התראה שניתנת להתאמה אישית עם מאפיין מותאם אישית' מאפשרת לכם להוסיף לספירת העסקאות של מפתח באמצעות הערך של מאפיין מותאם אישית. בתוכנית התמחור הרגילה של שיעור ההתראות שניתן להתאמה, כל קריאה ל-API מוצלחת מוסיפה 1 לספירת העסקאות של המפתח. אבל בתוכנית התמחור 'התראה על שינוי עם מאפיין מותאם אישית', הערך של המאפיין המותאם אישית מתווסף לספירת העסקאות של המפתח. לדוגמה, אם למאפיין מותאם אישית small יש ערך של 0.1 בתגובה, מספר העסקאות גדל ב-0.1. או אם למאפיין מותאם אישית addressTotal יש ערך של 50, המספר גדל ב-50. מידע נוסף זמין במאמר בנושא ציון תוכנית תמחור עם פרטים של מאפיינים בהתאמה אישית. (DEVRT-2504)

הגדרת התראות על סכומים משולבים של עסקאות בחברה ובקרב המפתחים שלה (Cloud 16.06.22 monetization)

בדרך כלל, סכומי העסקאות נמדדים באופן אוטומטי עבור כל המפתחים בחברה, כשהמפתחים משתמשים באפליקציה של החברה כדי לגשת לממשקי API. מה קורה אם יש לכם מפתחים שמשתמשים באופן פעיל באפליקציות הפיתוח שלהם כדי לגשת לממשקי API, ואתם צריכים לעקוב אחרי סכומי העסקאות המשולבים שלהם בלי שיבושים בתנועה? אפשר להוסיף את המפתחים לחברה ולהגדיר שליחת התראות כשמגיעים לספים שמבוססים על סכומי העסקאות המשולבים של החברה והמפתחים שלה. מידע נוסף זמין במאמר בנושא הגדרת התראות על סמך סכומי עסקאות משולבים של חברה והמפתחים שלה. (DEVRT-2643)

הצגה ועיבוד מחדש של התראות (מונטיזציה ב-Cloud מ-16.06.08)

במסגרת חבילת מקרים לבדיקה למונטיזציה, אפשר להציג ולעבד מחדש התראות שנשלחו בעבר באמצעות API הניהול. מידע נוסף זמין במאמר הצגה ועיבוד מחדש של התראות. (DEVRT-2643)

בדיקת מונטיזציה (מונטיזציה ב-Cloud מ-25 במאי 2016)

המוצר 'מונטיזציה' מספק קבוצה של ממשקי API שבהם אפשר להשתמש כדי לבדוק את ההפעלה של וווב-הוקים, כדי לוודא שההתראות נשלחות. פרטים נוספים מופיעים במאמר בנושא בדיקה של הגדרת ההתראות. (DEVRT-2625)

העברת מפתחים למונטיזציה (מונטיזציה ב-Cloud 16.05.11)

אנחנו משיקים API חדש כדי לעזור למפתחים לעבור למונטיזציה. אתם יכולים להעביר את השימוש בעסקאות ולחייב עמלות מותאמות אישית על הגדרה ועל חיובים חוזרים. בנוסף, כשמאשרים תוכנית מחירים שפורסמה, אפשר לוותר על דמי ההגדרה אם הם כבר חויבו. מידע נוסף זמין במאמר בנושא העברת מפתחים למונטיזציה. (DEVRT-2446)

תוכניות תמחור ציבוריות ופרטיות לפורטל למפתחים (מונטיזציה ב-Cloud 16.04.27)

אפשר להגדיר את תוכניות התמחור כ'גלויות לכולם' או כ'פרטיות'. תוכניות תמחור ציבוריות מופיעות בפורטל למפתחים, אבל תוכניות תמחור פרטיות לא מופיעות בו. ברירת המחדל של תוכנית תמחור היא 'גלוי לכולם'. מידע נוסף זמין בכתובת http://docs.apigee.com/monetization/content/create-rate-plans#public-versus-private-rate-plans. (DEVRT-2445)

ביטול ההשעיה של מפתחים (מונטיזציה ב-Cloud 16.06.08)

המוצר 'מונטיזציה' מספק קבוצה של ממשקי API שבהם אפשר להשתמש כדי לבטל השעיה של מפתח שהושעה בעבר. יכול להיות שהמפתח יושעה אם תגיעו למגבלה שהוגדרה. לדוגמה, מספר העסקאות הגיע למגבלה המקסימלית או שהיתרה בחשבון בתשלום מראש התרוקנה. מידע נוסף זמין במאמר בנושא ביטול השעיה של מפתחים. (DEVRT-2641)

הצגת הסטטוס של עסקאות (מונטיזציה ב-Cloud מ-16.06.08)

כחלק מחבילת הבדיקות למונטיזציה, אפשר לראות את הסטטוס של עסקאות שהתרחשו במהלך טווח זמן מסוים באמצעות Management API. מידע נוסף מופיע במאמר בנושא צפייה בסטטוס של עסקאות. (DEVRT-2640)

הכללת מאפיינים מותאמים אישית של מפתחים בדוחות הכנסות (מונטיזציה ב-Cloud מ-16.05.25)

בדוחות הכנסות בלבד, אפשר לכלול בדוח מאפיינים מותאמים אישית, אם המאפיין המותאם אישית מוגדר למפתח. מידע נוסף זמין במאמר הוספת מאפיינים מותאמים אישית למפתחים לדוחות הכנסות באמצעות API. (DEVRT-2447)

מדיניות תיעוד העסקאות ועקביות של משאבי מוצרי API (ממשק משתמש של Cloud 16.05.18)

אם נתיבי המשאבים במדיניות של תיעוד עסקאות לצורך מונטיזציה לא תואמים לנתיבי המשאבים שמוגדרים במוצר ה-API שלה (לדוגמה, אם משנים את נתיבי המשאבים של מוצר ה-API), סמל המדיניות של תיעוד עסקאות בדף Products (מוצרים) יציג סמל אזהרה. כשלוחצים על הסמל כדי לראות את מדיניות תיעוד העסקאות, מופיעה אזהרה בחלק העליון של הדף. אחרי שתתקנו את נתיבי המשאבים במדיניות של הקלטת העסקאות, סימני האזהרה ייעלמו. (DEVRT-2240)

באגים שתוקנו

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

‫Edge for Private Cloud

מזהה הבעיה תיאור
TBD-138 בעיה שקשורה לזמן הקצוב לתפוגה של סשן בממשק המשתמש של Play
APIRT-2978 הנתב לא מצליח להפעיל את Nginx או שהנתב לא מצליח להתחיל
AXAPP-2447 השגיאה InvalidTimeRange כשבוחרים נתוני ניתוח לפי שעה
EDGEUI-592 עכשיו אפשר להסיר את הקישור 'שכחתי את הסיסמה' מממשק המשתמש של Edge כשמשתמשים בספק אימות חיצוני
MGMT-3330 ניסיונות כושלים להזנת סיסמה ב-Private Cloud external auth נועלים את המשתמשים
MGMT-2930 אנונימיזציה של נתונים לא פועלת בסשן ניפוי באגים
PRC-840 קישור סמלי שבור לרכיבי Edge
PRC-1004 נוספה האפשרות '‎-p zk' למתקין כדי להתקין את ZooKeeper עצמאי בצומת.
PRC-1013 החשבון הראשוני של האדמין לא מקושר למדיניות הסיסמאות הנכונה של LDAP
PRC-1019 הפקודה 'apigee-all stop' לא מפסיקה את Message Processors
PRC-1066 Encrypted Cassandra password not working in usergrid.properties for BaaS Stack

16.08.17

מזהה הבעיה תיאור
SECENG-609 קריאות בזמן ריצה לא נכשלות במהלך מחיקה של מאגר האישורים המשויך או כשאישור תקין במאגר האישורים נמחק
MGMT-3404 הצגה או אחזור של יומנים של Node.js ופריסה של שרתי proxy מאוד איטיים
MGMT-3400 קריאה ל-API לניהול /userroles נכשלת אם המשתמש שמבצע את הקריאה כולל סימן '+' בשם
MGMT-3368 java.lang.ArrayIndexOutOfBoundsException: 1, when importing an API Proxy bundle that contains resources/node/resources directory
MGMT-3364 OAuthV2: redirect_uri check
MGMT-3319 אי אפשר לרשום רשומות בכספת שיש בה ערך null באחת מהרשומות בארגונים (CPS ולא CPS)
MGMT-3226 שאילתות ברמת הארגון או הסביבה לא אמורות לשלוף את כל הנתונים ולגרום לכשל ב-API
בגרסה Release_160302 היה באג שגרם לכך שרשימת המשאבים ברמת הארגון או הסביבה נכשלה אם הגודל המצטבר של המשאבים היה מעל 16MB. התיקון הזה מטפל בבעיה.
AXAPP-2429 Analytics API using response_status_code returns data access error
AXAPP-2386 תיקון תוכן ריק בדוחות יומיים באימייל של Analytics
AXAPP-2347 לא מקבלים אימיילים עם סיכום יומי של נתוני Analytics
APIRT-3141 הפעלת Java Callouts נכשלת כשמפעילים את ExecutionResult()‎ חדש, כי ה-constructor הוגדר כפרטי
APIRT-3140 המדיניות ServiceCallout לא פועלת בקריאות ל-API של HEAD
APIRT-3131 הערך שמוצג ב-createdBy עבור API Proxy שגוי כשמשתמשים במונטיזציה עם ספק אימות חיצוני
APIRT-3121 שינוי שבוצע בקובץ משאבים של הארגון לא משפיע ב-100%
APIRT-3117 ה-MP הגיע לניצול של 100% מה-CPU והפסיק להציג תנועה
APIRT-3016 שגיאות בנתב 'השיחה הסתיימה בגלל חוסר פעילות' בפריסות
APIRT-2975 העלאת חבילת אישורים נכשלה
APIRT-2955 לא ניתן להסתיר מאפיינים מסוימים של נתוני תגובת JSON עבור כותרת Content-Type תואמת FHIR ‏ 'application/json+fhir'
APIRT-2946 מדיניות OAuthV2-RefreshToken לא מסתירה מאפיינים גם אם ההגדרה display מוגדרת כ-false
APIRT-2908 נדרשת אכיפה של TLS1.2 לקריאה פנימית ל-API אחרי עדכון TLS1.2 ב-virtualhost
APIRT-2901 תשובות שדחוסות ב-gzip ומוחזרות מהמטמון נדחסות פעמיים
APIRT-2873 מודולי ה-MP מעלים NullPointerException שקשור ל-VerifyAPIKey אחרי מחיקה של products/developers/proxies
APIRT-2871 מדיניות IOIntensive מופיעה פעמיים ב-Trace
APIRT-2825 שגיאת דקדוק בתגובה לשגיאה של accesstoken
APIRT-2750 שיעור גבוה של כשלים בתנועה בארגון מסוים
APIRT-2685 התנועה לא יכולה לזרום בגלל שגיאה לא ידועה
APIRT-2647 השגיאה"Underlying input stream returned zero bytes" עם nonprod/dev
APIRT-2630 בעיות לסירוגין כשמנסים לקרוא ערך מהמטמון
APIRT-2620 מאגר שרשורים נפרד לכמה שלבים חוסמים
APIRT-2610 java.lang.ClassCastException with Response Cache policy
APIRT-2608 שגיאה בניתוח של כותרות Last-Modified במדיניות של מטמון תגובות
APIRT-2605 אסור לאפשר החלפה של משתני 'ארגון' ו'סביבה' באמצעות מדיניות
APIRT-2566 מדיניות OAuthV2 מחזירה כותרת WWW-Authenticate פגומה
APIRT-2491 העדכון של TargetServer נכשל בגלל שהזמן הקצוב לתפוגת RPC בין הניהול לבין mps הסתיים
APIRT-2386 נוצר היקף מחרוזת ריקה במוצר API עם היקפי OAuth מותרים ריקים
APIRT-2383 נראה שמדיניות XSL Transformation לא מתעדת נתונים בשגיאה
APIRT-2364 משתני תהליך שגיאה של OAuth לא מתעדכנים בשגיאה
APIRT-2216 אירועים שנשלחו מהשרת – יש בעיות בזרם האירועים בסביבת הייצור
APIRT-2079 קריאת DEBUG cURL לא מפסיקה אחרי שפג הזמן הקצוב לתפוגה של הסשן שנוצר
APIRT-1495 הגנה מפני איומים ב-XML לא מזהה את סוג התוכן fhir
APIRT-1404 התנהגות לא עקבית כשמשווים ערך במירכאות יחידות לעומת מירכאות כפולות בתנאי
APIRT-347 מדיניות ה-XSL לא מאומתת כמו שצריך במהלך הייבוא (התוצאות לא מוקצות למשתני הפלט כמו שמתואר במסמכים)

‫16.07.27 (ממשק משתמש)

מזהה הבעיה תיאור
EDGEUI-621 האפשרות 'שמירה כ-API Proxy חדש' משתמשת בשם ברירת המחדל שכולל סימון מדעי, כמו new-1.234568901234568e+53
EDGEUI-572 בממשק המשתמש מוצגת השגיאה "שגיאה: שגיאה לא ידועה" במקום "שגיאה: פסק זמן של סשן"

16.07.20.01 (מונטיזציה)

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

‫16.07.13 (ממשק משתמש)

מזהה הבעיה תיאור
EDGEUI-609 הלחצן 'שרת יעד חדש' לא מופעל בתפקיד מותאם אישית שיש לו הרשאה ליצור שרתי יעד
EDGEUI-584 באגים קלים בתצוגה של מפתח או סוד באפליקציה למפתחים שיש לה כמה פרטי כניסה
EDGEUI-571 המגבלה על שם ה-proxy מוגדרת בצורה שגויה ל-50 תווים בממשק המשתמש

‫16.07.06.02 (מונטיזציה)

מזהה הבעיה תיאור
DEVSOL-2817 יצירת מסמכי חיוב באמצעות API לא פועלת
תוקנו בעיות ביצירת מסמכי חיוב באמצעות API. מסמכי החיוב נוצרים בהצלחה אם כתובת המפתח מופיעה.
DEVSOL-2797 שיפור העיבוד של מאפייני מפתח
ערכים של מאפיינים מותאמים אישית בוליאניים הם כבר לא תלויי-רישיות. בנוסף, כשמסנכרנים מאפיינים מותאמים אישית עם Apigee Edge, המאפיינים הקיימים מתעדכנים במקום ליצור מאפיינים כפולים.

‫16.07.06 (מונטיזציה)

מזהה הבעיה תיאור
DEVRT-2795 שדה חותמת הזמן של בקשת ה-Webhook לא עקבי
בבקשת ה-JSON שנשלחת ל-callback handler של ה-Webhook, הערך של developerQuotaResetDate מבוטא עכשיו בפורמט של חותמת זמן של epoch, כדי לשמור על עקביות עם הפורמטים האחרים של חותמות הזמן. מידע נוסף זמין במאמר בנושא הגדרת handler של קריאה חוזרת.

‫16.06.29 (ממשק משתמש)

מזהה הבעיה תיאור
EDGEUI-600 אין אפשרות להציג או לערוך תפקידים בדוחות בהתאמה אישית
EDGEUI-593 הוסרו מהממשק של Analytics מרווחי זמן של 5 ו-10 דקות
נתוני Analytics בממשק הניהול לא מופיעים למשך 10 דקות לפחות אחרי ביצוע קריאות לפרוקסי של API. לכן, הגדרת הטווח של 10 דקות הוסרה מדוחות בהתאמה אישית, והגדרת הטווח של 5 ו-10 דקות הוסרה מתצוגת הביצועים של שרתי proxy של API.

‫16.06.22 (מונטיזציה)

ללא

‫16.06.15 (ממשק משתמש)

מזהה הבעיה תיאור
EDGEUI-566 דף ריק אחרי התחברות לממשק המשתמש לניהול
EDGEUI-564 המשתמשים מקבלים שגיאות הרשאות בכניסה לממשק הניהול, ואז הם יוצאים מהחשבון באופן אוטומטי
EDGEUI-549 שגיאה בהצגת נתונים בתצוגה 'ביצועים של שרת proxy של API'
EDGEUI-544 בדף 'תפקידים בהתאמה אישית' מוצג ערך שגוי להרשאה 'מחיקת דוחות'
EDGEUI-504 סטטוס מבלבל באפליקציות, במפתחות ובמוצרים למפתחים
EDGEUI-120 כתובת האימייל בקישור בדף השגיאה הפנימית לא תקינה
DEVRT-2301 מונטיזציה: התאמה בין ממשק המשתמש לבין ה-API בתוכניות תמחור שפורסמו
בנוגע לתאריך התפוגה בתוכניות תמחור שפורסמו, ממשק המשתמש לניהול תואם עכשיו להתנהגות של ה-API לניהול. אם בתוכנית התמחור צוין תאריך סיום, אי אפשר לשנות את תאריך התפוגה שלה. מידע נוסף זמין במאמר בנושא הגדרת תאריך תפוגה לתוכנית מחירים שפורסמה.

‫16.06.08 (מונטיזציה)

ללא

‫16.05.25 (מונטיזציה)

מזהה הבעיה תיאור
DEVRT-2617 לא מקבלים התראה כשלקוח רוכש תוכנית תחזוקה
DEVRT-1483 NullPointerException כשמפתח עובר מתשלום מראש לתשלום לאחר השימוש

‫16.05.18 (ממשק משתמש)

מזהה הבעיה תיאור
EDGEUI-551 הסשן בממשק המשתמש יפוג אם לא תהיה פעילות במשך שעה בערך

‫16.05.11 (מונטיזציה)

מזהה הבעיה תיאור
DEVRT-2497 Qpids stopped receiving data
DEVRT-2490 המחיקה של מפתח האפליקציה נכשלת

‫16.05.11 (ממשק משתמש)

מזהה הבעיה תיאור
EDGEUI-541 הכלי Trace מציג כתובת IP במקום מארח כשיש שרת יעד
EDGEUI-505 ייבוא משאבי נקודות קצה גורם לכשל בהרשאה של כל נקודות הקצה

‫16.05.04 (ממשק משתמש)

מזהה הבעיה תיאור
EDGEUI-532 אשף הפרוקסי החדש נתקע בשלב 'יצירת מוצר...' כשיוצרים פרוקסי בשביל שירות SOAP
EDGEUI-506 אם אין נתונים זמינים, בביצועי המטמון מוצגת ההודעה 'טעינת נתונים…'

‫16.04.27 (ממשק משתמש)

מזהה הבעיה תיאור
EDGEUI-531 אי אפשר לייבא קובץ JAR באמצעות כלי העריכה החדש של שרת ה-proxy
EDGEUI-524 בעיה ביצירת proxy ל-API מ-WSDL
EDGEUI-38 אם קובץ WSDL לא תקין מועבר לאשף הפרוקסי, האשף נתקע בדף האחרון

‫16.04.27 (מונטיזציה)

ללא

‫16.04.20 (ממשק משתמש)

מזהה הבעיה תיאור
EDGEUI-502 כלי העריכה של ה-Proxy לא מציג את הפועל כשמשתמשים ב-StartsWith כאופרטור
EDGEUI-496 "שגיאה לא ידועה" כשמנסים להפסיק הפעלה של כלי המעקב בממשק המשתמש של הניהול
EDGEUI-141 הודעת השגיאה ב-Proxy Editor כוללת מספר גרסה שמוגדר בהארדקוד

‫16.04.13 (מונטיזציה)

ללא

‫16.04.13 (ממשק משתמש)

מזהה הבעיה תיאור
EDGEUI-495 Trace תמיד מציג .execution.success = false
EDGEUI-494 מדיניות Javascript תמיד יוצרת סקריפט עם שם ברירת המחדל גם אם אני מציין שם אחר
EDGEUI-432 יצירת שרת proxy מונחה במרכז הבקרה של ממשק המשתמש לניהול Edge
EDGEUI-90 כלי חדש לעריכת פרוקסי של API מוסיף רווחים לא מתאימים סביב רכיבי CDATA

בעיות מוכרות

בגרסה הזו יש את הבעיות הידועות הבאות:

מזהה הבעיה תיאור
APIRT-3364

מעבד הבקשות מבצע חיפוש DNS ב-IPv4 וב-IPv6

אם התקנתם והפעלתם את NSCD (Name Service Cache Daemon), יכול להיות שתבחינו בכך שמעבדי ההודעות מבצעים שתי בדיקות DNS: אחת ל-IPv4 ואחת ל-IPv6.

כדי להשבית את חיפוש ה-DNS ב-IPv6:

  1. בכל צומת של מעבד ההודעות, עורכים את הקובץ /etc/nscd.conf.
  2. מגדירים את המאפיין הבא:

    enable-cache hosts no
DOC-1687 בגלל קונפליקט ידוע של תלות בחבילה, סוכן Katello שמשמש ב-Satellite Server 6 לא יותקן בצורה תקינה במארחי Apigee Edge שמריצים את Qpid daemon.