כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של
Apigee X. מידע
ביום שלישי, 2 ביוני 2015, השקנו גרסה חדשה של Apigee Edge בענן.
יש לך שאלות? אפשר להיעזר בתמיכת הלקוחות של Apigee.
בנתוני הגרסה של Apigee תוכלו למצוא רשימה של כל נתוני הגרסה של Apigee Edge.
תכונות חדשות ושיפורים
בהמשך מפורטים התכונות והשיפורים החדשים שבגרסה הזו.
זמינות כללית של SmartDocs
השירות SmartDocs עבר מגרסת בטא לזמינות כללית. העדכונים והתכונות החדשות כוללים:
- תמיכה ב-Swagger 2.0, כולל ייבוא לפי קובץ או כתובת URL, כולל תמיכה באובייקטים של אבטחה עם שם מותאם אישית.
- שיפורים בעיצוב החזותי בתבניות שיוצרות מסמכים חכמים ב-SmartDocs.
- נוחות השימוש ושיפורים בתהליך העבודה בפורטל למפתחים, שזמינים דרך התפריט > תפריט SmartDocs ב-Drupal.
- האימות שנקרא "אסימון מותאם אישית" נקרא עכשיו "מפתח API".
- אובייקטים של "אבטחה" לאימות שמוגדרים ברמת הגרסה הקודמת.
- הגדרת אימות לקוח ברמת התבנית. גרסאות קודמות לא מאפסות יותר פרטי כניסה של לקוח ב-SmartDocs שהוגדרו מראש.
לתיאורי תכונות נוספים אפשר לקרוא את הפוסט הזה בבלוג.
למסמכי SmartDocs, ראו שימוש ב-SmartDocs לתיעוד ממשקי API.
עורך API חדש בגרסת בטא
יש גרסת בטא חדשה של עורך ה-API של שרת proxy. כדי לגשת לגרסת הבטא, לחץ על הקישור 'גישה לגרסת הבטא' במהלך עריכה של שרת proxy קיים של API. ניתן לעבור בין העורכים ה"קלאסיים" ל "בטא".
מדיניות OAuthV2 חדשה
המדיניות החדשה בנושא DeleteOAuthV2Info מאפשרת למחוק קודי הרשאה ואסימוני גישה. למידע נוסף, ראו מחיקת מדיניות המידע של OAuthV2.
ישויות חדשות במדיניות לישות גישה
המדיניות בנושא ישויות גישה נותנת גישה לישויות החדשות הבאות: היקפים של מפתחות צרכנים, קוד הרשאה, אסימון בקשה ומאמת. מידע נוסף מופיע במדיניות הגישה לישות.
מוצגים אישורי SSL שהתוקף שלהם עומד לפוג
הדף של אישורי ה-SSL בממשק המשתמש לניהול (ניהול > אישורי SSL) מציין מתי התוקף של אישורי SSL יפוג בתוך 10, 15, 30 או 90 ימים, בהתאם לבחירה שלך בשדה הנפתח החדש 'תפוגה'.
השם של האפליקציה למפתחים מוצג בממשק המשתמש של הניהול
לאפליקציות למפתחים ב-Edge יש שם פנימי שלא משתנה וגם שם תצוגה שאפשר לשנות. בדף האפליקציה למפתחים בממשק המשתמש של הניהול (פרסום > אפליקציות למפתחים > שם האפליקציה), ה "שם" הפנימי של האפליקציה מוצג יחד עם ה "שם המוצג". כך קל יותר לזהות אפליקציות לפי השם הפנימי שלהן לצורך פתרון בעיות וניהול API.
אנחנו מסירים את הגרסה הקלאסית של דוחות בהתאמה אישית מממשק הניהול של הניהול
הגרסה הקלאסית האופציונלית של דוחות ניתוח נתונים בהתאמה אישית כבר לא זמינה בממשק המשתמש של הניהול.
תהליך השדרוג של SmartDocs
אם השתמשת כבר ב-SmartDocs בתקופת הבטא, כדי להשתמש בתכונות וביכולות החדשות בגרסת הזמינות הכללית צריך לשדרג את SmartDocs בפורטל המפתחים.
כל הדפים של SmartDocs שכבר פורסמו בפורטל המפתחים ימשיכו לפעול, אבל יש לפעול לפי תהליך העדכון לפני עריכת או פרסום שינויים בדפים קיימים או חדשים.
חשוב לזכור שלמרות שאפשר לעבד ולפרסם SmartDocs בפורטל המפתחים, SmartDocs נוצרים ממודל ה-API שנכלל בשירותי ניהול ממשקי ה-API של Apigee's Edge. השינויים שיבוצעו במודל API ב-Edge יהיו זהים בכל סביבות ה-Pantheon (בדומה לאופן שבו המפתחים קיימים בסביבות של Pantheon).
כדי לשדרג מגרסת הבטא של SmartDocs לזמינות כללית
- מעדכנים ובודקים את הגרסה של 15.05.27 בסביבות dev או test ב-Pantheon.
- יצירת מודל חדש שיחליף את כל מודל ה-API הקיים שבו השתמשת.
- אם ייבאת מסמכי Swagger או WADL, עליך לייבא אותם שוב לגרסה קודמת חדשה.
- אם עדכנת את מודל ה-API באמצעות המודול SmartDocs, עליך לייצא אותו כקובץ SmartDocs JSON ולייבא אותו למודל החדש באמצעות קובץ מצורף.
- הגדרת מאפייני האבטחה של הגרסה הקודמת של המודל. בדף תוכן > SmartDocs > מודל, בוחרים באפשרות הגדרות אבטחה.
- כדי לבדוק אימות שהוגדר מראש בדף הגדרות המודל (תוכן > SmartDocs), לוחצים על הגדרות בעמודה 'פעולות'.
- צריך לעדכן את התבניות המותאמות אישית כדי להשתמש בגרסה 6 של נכסי ה-CSS וה-JS, ולבצע שינויים כך שישקפו שמות של אובייקטים חדשים, כמו authSchemes ו-apiSchema. למידע על עדכון תבניות SmartDocs, אפשר לקרוא את המאמר שימוש ב-SmartDocs לממשקי API למסמכים.
- עבד מחדש ופרסם את גרסת המודל שלך.
- אחרי אימות המסמכים החדשים, צריך לעדכן את פורטל production לגרסה 15.05.27.
לקוחות ארגוניים של Edge ויש להם שאלות או חששות לגבי תהליך השדרוג, יכולים לשלוח אימייל לכתובת marsh@apigee.com או cnovak@apigee.com. אם לא, השתמשו בקהילת Apigee כדי לקבל את התשובה הטובה ביותר.
הבאגים תוקנו
הבאגים הבאים תוקנו בגרסה הזו.
| מזהה הבעיה | התיאור |
|---|---|
| TBD-72 | בעיה במדיניות של רישום הודעות ביומן |
| MGMT-2124 | ההרשאות של תפקיד הלקוח מתאפסות בעת שמירת ההרשאות בממשק המשתמש |
| MGMT-2048 | משתמש עם תפקיד בהתאמה אישית שמגביל את הרשאות הפריסה לסביבת עבודה אחת יכול לפרוס את בסביבות אחרות |
| MGMT-2041 | הסרת רכיב Fault Rules מתבנית ברירת המחדל לצירוף קבצים הרכיב FaultRules, שלא נמצא בשימוש בכללי מדיניות או בשלבים של שרת proxy ל-API, לא נוסף באופן אוטומטי כשיוצרים שרתי proxy של API או מוסיפים כללי מדיניות. |
| MGMT-2034 | אחזור של שגיאת WSDL נכשל: "אחזור שגיאת WSDL: שגיאה בעיבוד WSDL". |
| MGMT-1812 | הוספה של אימות TargetEndpoint במהלך הייבוא בדומה ל-ProxyEndpoint, יתבצע אימות של TargetEndpoint עבור הסכימה והביטויים הנכונים שנעשה בהם שימוש בתנאים במהלך ייבוא ה-API של שרת ה-proxy. |
| MGMT-1345 | ייבוא של WSDL עם כמה מרחבי שמות מוביל ליצירת שלב שגוי ב-build SOAP |
| MGMT-800 | יצירת משאב עם השם 'default' גורמת לממשק משתמש פגום |
| MGMT-602 | תצוגת API Proxy Develop: הוספת מדיניות של מטמון תגובה כאשר נקודת הקצה לא כוללת PreFlow/PostFlow גורמת לשגיאה |
| MGMT-460 | שינוי השם של המדיניות גורם להתנהגות משובשת, מדיניות כפולה שלא ניתן להסיר |
| DEVRT-1565 | מרווחי זמן של 15 דקות לחיובים |
| AXAPP-1728 | התעלמות ממשתני מונטיזציה ב-Analytics |
| AXAPP-1690 | "שגיאת API לא חוקית" בדוחות מותאמים אישית |
| AXAPP-1533 | המפה הגיאוגרפית של Analytics גורמת לשגיאה בקריאה לא חוקית ל-API |
| APIRT-52 | דוחות בהתאמה אישית: קוד סטטוס התגובה של הרבה ממשקי API הוא null |