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 ל-SOAP באשף של proxy ל-API, ואובייקט Crypto ל-JavaScript עם ביצועים גבוהים.

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

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

הוצא משימוש

שירותי API

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

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

מונטיזציה

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

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

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

(DEVRT-2742)

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

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

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

ענן פרטי

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

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

תמיכה במפה גיאוגרפית בממשק המשתמש של 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 ל-JSON. (APIRT-1144)

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

כשמגדירים נתיבי משאבים במוצר API, אפשר לכלול תווים כלליים בכמה מקומות בנתיב משאב. לדוגמה, /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 ל-proxy ל-API, מוחזר קוד סטטוס 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 שיש להם שרתי 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. עם זאת, חשוב לזכור שהגדלת ערכי הזמן הקצוב לתפוגה של המערכת עלולה לגרום לבעיות בביצועים, כי כל השרתים הפרוקסי ללא הגדרה של 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)

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

  • ‫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 ומזהה בצורה נכונה את כל סוגי המופעים שמבוססים על הסוגים האלה.

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

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

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

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

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

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

המוצר 'מונטיזציה' מספק קבוצה של ממשקי API שבהם אפשר להשתמש כדי לבדוק את ההפעלה של webhook, כדי לוודא שההתראות נשלחות. פרטים נוספים מופיעים במאמר בנושא בדיקה של הגדרת ההתראות. (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)

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

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

בדוחות הכנסות בלבד, אפשר לכלול בדוח מאפיינים מותאמים אישית, אם המאפיין המותאם אישית מוגדר למפתח. מידע נוסף זמין במאמר הוספת מאפיינים מותאמים אישית למפתחים לדוחות הכנסות באמצעות 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 נועלים את המשתמשים
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 עם מדיניות של מטמון תגובות
APIRT-2608 שגיאה בניתוח של כותרות Last-Modified במדיניות של מטמון תגובות
APIRT-2605 אסור לאפשר החלפה של משתני 'ארגון' ו'סביבה' באמצעות מדיניות
APIRT-2566 מדיניות OAuthV2 מחזירה כותרת WWW-Authenticate פגומה
APIRT-2491 העדכון של TargetServer נכשל בגלל פסק זמן של RPC בין הניהול לבין mps
APIRT-2386 נוצר היקף הרשאות של מחרוזת ריקה במוצר API עם רשימה ריקה של Allowed OAuth scopes
APIRT-2383 נראה שמדיניות XSL Transformation לא מתעדת נתונים בשגיאה
APIRT-2364 משתני זרימת תקלות של OAuth לא מתעדכנים בשגיאה
APIRT-2216 Server sent events - event stream having issues in prod
APIRT-2079 DEBUG cURL call not stopping after the timeout expires for the created session
APIRT-1495 הגנה מפני איומים ב-XML לא מזהה סוג תוכן fhir
APIRT-1404 התנהגות לא עקבית כשמשווים ערך במירכאות יחידות לעומת מירכאות כפולות בתנאי
APIRT-347 מדיניות ה-XSL לא מאומתת כמו שצריך בזמן הייבוא (התוצאות לא מוקצות למשתני הפלט כמו שמתואר במסמכים)

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

מזהה הבעיה תיאור
EDGEUI-621 האפשרות 'שמירה כפרוקסי חדש של API' משתמשת בשם ברירת המחדל שכולל סימון מדעי, כמו 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 שנשלחת לגורם המטפל בקריאה חוזרת של ה-Webhook, השדה developerQuotaResetDate מוצג עכשיו בפורמט של חותמת זמן של תקופה של זמן מערכת, כדי לשמור על עקביות עם הפורמטים האחרים של חותמות הזמן. מידע נוסף זמין במאמר בנושא הגדרת ה-callback handler.

‫16.06.29 (UI)

מזהה הבעיה תיאור
EDGEUI-600 אין אפשרות לראות או לערוך תפקידים בדוחות בהתאמה אישית
EDGEUI-593 הוסרו מהממשק של Analytics מרווחי זמן של 5 ו-10 דקות
נתוני Analytics בממשק הניהול לא מופיעים למשך 10 דקות לפחות אחרי ביצוע קריאות לפרוקסי של API. לכן, הגדרת טווח הזמן של 10 דקות הוסרה מדוחות בהתאמה אישית, והגדרות טווח הזמן של 5 ו-10 דקות הוסרו מתצוגת הביצועים של פרוקסי 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 מזהי Qpid הפסיקו לקבל נתונים
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 לא תקין מועבר לאשף של ה-Proxy, האשף נתקע בדף האחרון

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

ללא

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

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

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

ללא

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

מזהה הבעיה תיאור
EDGEUI-495 Trace always shows .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.