16.08.17 – נתוני הגרסה של Apigee Edge ל-Public Cloud

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

ביום שלישי, 30 באוגוסט 2016, השקנו גרסה חדשה של Apigee Edge לענן ציבורי.

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

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

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

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

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

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

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

שיפורי מדיניות בפורמט XML ל-JSON

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

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

למידע נוסף, ראו XML למדיניות JSON. (APIRT-1144)

יש כמה תווים כלליים לחיפוש ב- נתיבי המשאבים של מוצרי API

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

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

(שעון גריניץ'-3273)

פונקציות קריפטו ב-JavaScript

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

הגרסה של Java Callout JAR עובר ושב

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

אימות של משאבי proxy ל-API

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

הגדרת הזמן הקצוב לתפוגה לשרתי proxy ל-API ספציפיים

ניתן להגדיר שרתי 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 אחרי 1 דקה:
   <Property name="api.timeout">60000</Property>

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

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

TLS/SSL לרישום הודעות ביומן מדיניות

אפשר להגדיר את <KeyStore> ואת <TrustStore> בטווח ההגדרות של SSLInfo במדיניות של רישום הודעות, הפעלת TLS/SSL חד-כיווני ודו-כיווני באמצעות שירות רישום ביומן. מגדירים את SSLInfo במדיניות של יומן ההודעות באותו אופן שבו מגדירים על שרת proxy יעד Endpoint. עם זאת, TLS/SSL ביומן הודעות תומך רק בפרוטוקול TCP. (APIRT-1858)

הבאגים תוקנו

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