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

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

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

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

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

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

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

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

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

הוצא משימוש

שירותי API

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

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

מונטיזציה

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

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

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

(DEVRT-2742)

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

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

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

ענן פרטי

שדרוג פוסטים לגרסה 9.4

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

תמיכה במפות גיאוגרפיות בממשק המשתמש של Edge

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

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

ממשקי BaaS של API

נוסף תיעוד ב:

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

מהדורת בטא של כלי המעקב ושל מרכז הבקרה

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

התיעוד, כולל הוראות ההתקנה, כלול במסמך Edge 4.16.09 בגרסה 4.18.01.

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

גרסת בטא של הכלי 'איסוף נתונים' של Analytics

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

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

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


שירותי API

מטענים ייעודיים (payloads) של JSON ב-הקצאת הודעה והגדלת Fault (Cloud 16.08.17)

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

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

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

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

אפשר לראות את הרכיב <Set><Payload> במסמכי העזר הקצאת מדיניות הודעות והגדלת מדיניות Fault. (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)

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

בדיקת הגרסה של Java Callout JAR (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)

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

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

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

SOAP להעברת SOAP

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

  • שרת ה-proxy שנוצר כבר לא תומך ב-JSON בבקשה. הוא תומך ב-XML בלבד. שרת ה-proxy מבטיח שבקשות SOAP יכללו מעטפה, גוף ומרחב שמות.

מ-REST ל-SOAP ל-REST

  • WSDL 2.0 לא נתמך.
  • ההתנהגות החדשה לא נבדקה באמצעות WS-Policy.
  • שרת ה-proxy מאפשר לך לבצע 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 קורא את כל סוגי ה-ComlexType שמוגדרים כמופשטים ב-WSDL, ומזהה כראוי כל סוגי המכונות שמבוססים על הסוגים המופשטים.

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

Apigee מספקת גם כלי שורת פקודה של קוד פתוח כדי ליצור שרתי proxy של ממשק API מסוג passthrough או שרת proxy ל-Soap API מ-WSDL. פרטים נוספים זמינים בכתובת https://github.com/apigee/wsdl2apigee.

(EDGEUI-614)

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

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

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

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

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

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

מונטיזציה בבדיקת (מונטיזציה בגרסה 16.05.25 של Cloud)

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

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

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

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

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

הבאגים תוקנו

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

Edge לענן פרטי

מזהה הבעיה תיאור
TBD-138 בעיה בזמן הקצוב לתפוגה של סשן בממשק המשתמש של Play
APIRT-2978 הנתב לא מצליח להפעיל את Nginx או שהנתב לא פועל
AXAPP-2447 שגיאת InvalidTimeRange בעת בחירה בנתוני Analytics שעתיים
EDGEUI-592 עכשיו אפשר להסיר את הקישור 'שכחתי את הסיסמה' מממשק המשתמש של Edge כשמשתמשים בספק אימות חיצוני
MGMT-3330 ניסיונות סיסמה כושלים לאימות חיצוני של ענן פרטי נועלים את המשתמשים
MGMT-2930 אנונימיזציה של נתונים לא פועלת בסשן של ניפוי באגים
PRC-840 קישור סמלי לא תקין לרכיבי Edge
PRC-1004 נוספה אפשרות "-p zk" למנהל ההתקנה כדי להתקין אתzoKeeper באופן עצמאי בצומת.
PRC-1013 חשבון ה-sysadmin הראשוני לא מקושר למדיניות הנכונה בנושא סיסמאות של LDAP
PRC-1019 התכונה 'apigee-all stop' לא עוצרת את מעבדי ההודעות
PRC-1066 הסיסמה המוצפנת של Cassandra לא פועלת ב-usergrid.properties ב-BaaS Stack

16.08.17

מזהה הבעיה תיאור
SECENG-609 קריאות בזמן הריצה לא נכשלות במהלך המחיקה של ה-Truststore המשויך או כשהאישור החוקי ב-Truststore נמחק
MGMT-3404 הצפייה/אחזור יומני Node.js ופריסת שרתי proxy איטיים מאוד
MGMT-3400 קריאה לממשק ה-API לניהול /userroles נכשל אם בשם המשתמש שמבצע את השיחה יש סימן "+"
MGMT-3368 java.lang.ArrayIndexOutOfBoundsחריגים: 1, כשמייבאים חבילת API Proxy שמכילה משאבים/צומת/ספריית משאבים
MGMT-3364 OAuthV2: בדיקת הפניה אוטומטית (redirect_uri)
MGMT-3319 רשימה של רשומות ב-Vault שיש להן ערך null באחת מהרשומות לא פועלות בארגונים (CPS ולא ב-CPS)
MGMT-3226 שאילתות ברמת הארגון/הסביבה לא אמורות למשוך את כל הנתונים שגורמים ל-API להיכשל
ב-Release_160302 היה באג שבו רישום המשאבים ברמת הארגון/הסביבה נכשל אם הגודל המצטבר של המשאבים גדול מ-16MB, התיקון הזה יטפל בזה.
AXAPP-2429 ה-API של Analytics שמשתמש ב-Reply_status_code מחזיר שגיאת גישה לנתונים
AXAPP-2386 תיקון תוכן של דוחות ריקים בדוחות יומיים של Analytics באימייל
AXAPP-2347 לא מתקבלות הודעות אימייל עם סיכום יומי של ניתוח הנתונים
APIRT-3141 נכסי יתרונות מרכזיים ב-Java נכשלים בקריאה החדשה ExecutionResult() , מכיוון שהבנאי הפך לפרטי
APIRT-3140 המדיניות של ServiceCallout לא פועלת בקריאות לממשק API של HEAD
APIRT-3131 נוצר על ידי הגדרה שגויה של שרת proxy ל-API כשמשתמשים במונטיזציה עם ספק אימות חיצוני
APIRT-3121 השינוי שבוצע בקובץ המשאב הארגוני לא היה יעיל ב-100%
APIRT-3117 הניצול של המעבד (CPU) ב-MP הגיע ל-100% והפסיקה להציג את התנועה
APIRT-3016 שגיאות "תם הזמן הקצוב לתפוגה של שיחה" בנתב בפריסות
APIRT-2975 ההעלאה של חבילת האישור נכשלה
APIRT-2955 לא ניתן לבצע אנונימיזציה של מאפיינים מסוימים בנתוני תגובות של JSON לגבי FHIR-complaint כותרת Content-Type 'application/json+fhir'
APIRT-2946 המדיניות של OAuthV2-רענן Token לא מסתירה מאפיינים למרות שהתצוגה מוגדרת כ-False
APIRT-2908 נדרשת אכיפה של TLS1.2 לקריאה פנימית ל-API אחרי עדכון TLS1.2 ב-Virtualhost
APIRT-2901 תגובות עם קובץ Gzip שחזרו מהמטמון דחוסות פעמיים
APIRT-2873 חברי ה-MP מתריעים על NullPointer להתקין חריג שקשור ל-VerifyAPIKey אחרי מחיקה של products/developers/proxies
APIRT-2871 מדיניות IOIntensive מוצגת פעמיים ב-Trace
APIRT-2825 שגיאה דקדוקית בתגובה לשגיאה של אסימון גישה
APIRT-2750 יש כשלים גבוהים בארגון ספציפי
APIRT-2685 התנועה לא יכולה לזרום בגלל שגיאה לא ידועה
APIRT-2647 "השגיאה "זרם קלט בסיסי החזיר אפס בייטים" עם nonprod/dev
APIRT-2630 בעיות שמופיעות לסירוגין במהלך הניסיון לקרוא ערך מהמטמון
APIRT-2620 מאגר שרשורים נפרד לחלק משלבי החסימה
APIRT-2610 המדיניות של java.lang.ClassCastהחרגה עם מטמון התגובה
APIRT-2608 שגיאה בניתוח כותרות שעודכנו לאחרונה במדיניות בנושא מטמון התגובה
APIRT-2605 אסור להחליף את המשתנים 'ארגון' ו'סביבה' באמצעות כללי מדיניות
APIRT-2566 מדיניות OAuthV2 מחזירה כותרת לא תקינה של WWW-Authenticate
APIRT-2491 עדכון שרת היעד נכשל בגלל הזמן הקצוב לתפוגה של RPC בין הניהול ל-mps
APIRT-2386 ההיקף של מחרוזת ריקה נוצר במוצר של ה-API עם היקפי הרשאות ריקים של OAuth
APIRT-2383 נראה שמדיניות XSL Transformation לא מתעדת נתונים עקב שגיאה
APIRT-2364 משתני זרימה של שגיאות OAuth לא מתעדכנים במקרה של שגיאה
APIRT-2216 אירועים שנשלחים על ידי השרת – בעיות בסטרימינג של אירועים בייצור
APIRT-2079 הקריאה ל-cURL לניפוי באגים לא מפסיקה לאחר תפוגת הזמן הקצוב לתפוגה של הסשן שנוצר
APIRT-1495 הגנה מפני איומים של XML לא מזהה את סוג התוכן fhir
APIRT-1404 התנהגות לא עקבית כשתנאי משווה ערך במירכאות בודדות לעומת במירכאות כפולות
APIRT-347 מדיניות XSL לא מאומתת כראוי במהלך הייבוא (לא מקצה תוצאות למשתני פלט כפי שתועד)

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

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

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

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

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

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

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

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

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

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

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

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

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

ללא

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

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

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

ללא

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

מזהה הבעיה תיאור
DEVRT-2617 לא מתקבלת התראה כשלקוח רוכש חבילת שירות
DEVRT-1483 NullPointerExceed כשמפתח עובר מתשלום מראש לתשלום לאחר השימוש (postpay)

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

מזהה הבעיה תיאור
EDGEUI-551 אם לא הייתה פעילות במשך שעה, או אם לא הייתה פעילות במשך שעה,

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

מזהה הבעיה תיאור
DEVRT-2497 רכיבי ה-Qpid הפסיקו לקבל נתונים
DEVRT-2490 המחיקה של מפתח האפליקציה נכשלה

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

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

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

מזהה הבעיה תיאור
EDGEUI-532 אשף שרת Proxy חדש נתקע בשלב 'יצירת מוצר...' כשיוצרים שרת proxy לשירות 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 'שגיאה לא ידועה' כשמפסיקים סשן מעקב בממשק המשתמש לניהול
EDGEUI-141 הודעת השגיאה של 'עורך ה-proxy' מכילה גרסה כתובה בתוך הקוד

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

ללא

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

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

בעיות ידועות

במהדורה הזו קיימות הבעיות המוכרות הבאות:

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

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

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

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

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

    Enable-cache מארחים לא
DOC-1687 עקב התנגשות ידועה של תלות בחבילות, סוכן Katello שמשמש בשרת לוויין 6 לא יותקן כראוי במארחים של Apigee Edge שמריצים את הדימון (daemon) Qpid.