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

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

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

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

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

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

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

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

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

הוצא משימוש

שירותי API

הוסר Classic Proxy Editor (ממשק משתמש של Cloud 16.04.20)

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

מונטיזציה

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

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

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

(DEVRT-2742)

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

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

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

ענן פרטי

שדרוג של Postres לגרסה 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 נתונים סטטיסטיים על תנועת הנתונים של שרתי proxy של API. ‫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> במסמכי העזר בנושא Assign Message policy ו-Raise Fault policy. (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 עם ביצועים גבוהים זמינה ליצירה, לאחזור ולעדכון של אובייקטים מסוג hash הבאים: MD5,‏ SHA-1,‏ SHA256,‏ SHA512. אובייקט crypto מאפשר גם לקבל את התאריך בפורמטים שונים. מידע נוסף זמין במאמר בנושא מודל אובייקטים של JavaScript. (APIRT-2886)

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

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

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

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

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

אפשר להגדיר שפרוקסי של API יפסיק לפעול אחרי פרק זמן מוגדר (עם סטטוס של 504 gateway timeout). תרחיש השימוש העיקרי הוא ללקוחות Private Cloud שיש להם פרוקסי 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 שלא דורשים פסק זמן ארוך יותר ישתמשו בפסק זמן קצר יותר. לדוגמה, הקוד הבא מגדיר שפרוקסי API יפסיק לפעול אחרי דקה אחת:
    <Property name="api.timeout">60000</Property>

לקוחות Cloud שלא יכולים לשנות את הזמן הקצוב לתפוגה ב-Edge יכולים גם להגדיר זמן קצוב לתפוגה של פרוקסי 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.
  • הפרוקסי מאפשר לכם להשתמש בשיטת POST כדי לשלוח נתוני 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 וחלף פרק הזמן לתפוגה, הערך מתעדכן והמדיניות מקבלת את הערך המעודכן. כשמוסיפים את המדיניות הזו ל-API proxy, זמן התפוגה שמוגדר כברירת מחדל הוא עכשיו 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, תוכנית תמחור חדשה בשם Adjustable Notification with Custom Attribute (התראה שניתנת להתאמה עם מאפיין מותאם אישית) מאפשרת להוסיף לספירת העסקאות של מפתח באמצעות הערך של מאפיין מותאם אישית. בתוכנית התמחור הרגילה עם שיעור ההתראות שניתן להתאמה, כל קריאת API מוצלחת מוסיפה 1 לספירת העסקאות של המפתח. אבל בתוכנית התמחור Adjustable Notification with Custom Attribute, הערך של המאפיין המותאם אישית מתווסף לספירת העסקאות של המפתח. לדוגמה, אם למאפיין מותאם אישית small יש ערך של 0.1 בתגובה, מספר העסקאות גדל ב-0.1. אם למאפיין מותאם אישית addressTotal יש ערך של 50, המספר גדל ב-50. מידע נוסף זמין במאמר ציון תוכנית תמחור עם פרטים של מאפיינים בהתאמה אישית. (DEVRT-2504)

הגדרת התראות על סמך סכומים משולבים של עסקאות בחברה ובקרב המפתחים שלה (מונטיזציה ב-Cloud‏ 16.06.22)

בדרך כלל, סכומי העסקאות נמדדים באופן אוטומטי עבור כל המפתחים בחברה, כשהמפתחים משתמשים באפליקציה של החברה כדי לגשת לממשקי 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 באמצעות response_status_code מחזיר שגיאה של גישה לנתונים
AXAPP-2386 תיקון תוכן ריק בדוחות יומיים באימייל של Analytics
AXAPP-2347 לא מקבלים סיכום יומי של נתוני Analytics באימייל
APIRT-3141 קריאות ל-Java Callouts נכשלות כשקוראים ל-new ExecutionResult()‎, כי הוגדר שהבונה הוא פרטי
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 עם מדיניות Response Cache
APIRT-2608 שגיאה בניתוח של כותרות Last-Modified במדיניות של מטמון תגובות
APIRT-2605 אסור לאפשר למדיניות לדרוס את המשתנים organization ו-environment
APIRT-2566 מדיניות OAuthV2 מחזירה כותרת WWW-Authenticate פגומה
APIRT-2491 העדכון של TargetServer נכשל בגלל פסק זמן של RPC בין הניהול לבין mps
APIRT-2386 נוצר היקף מחרוזת ריקה במוצר API עם היקפי OAuth מותרים ריקים
APIRT-2383 נראה שמדיניות XSL Transformation לא מתעדת נתונים במקרה של שגיאה
APIRT-2364 משתני תהליך שגיאה של OAuth לא מתעדכנים בשגיאה
APIRT-2216 Server sent events - event stream having issues in prod
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 timestamp) כדי לשמור על עקביות עם פורמטים אחרים של חותמות זמן. מידע נוסף זמין במאמר בנושא הגדרת callback 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
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 always shows .execution.success = false
EDGEUI-494 מדיניות Javascript תמיד יוצרת סקריפט עם שם ברירת המחדל גם אם אני מציין שם אחר
EDGEUI-432 יצירת שרת proxy מונחה במרכז הבקרה של ממשק המשתמש לניהול Edge
EDGEUI-90 הכלי החדש לעריכת API Proxy מוסיף רווחים לא מתאימים סביב רכיבי 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.