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

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

ביום שלישי, 8 בספטמבר 2015, השקנו השקה של תכונה חשובה במיוחד של Apigee Edge למשתמשים פרטיים ב-Google Cloud.

מאז ההשקה הרבעונית של Edge for Private Cloud (4.15.04.00) – קיימות גרסאות ונכללות בגרסה הרבעונית הזו:

• Cloud: 15.04.15, 15.04.29, 15.05.27, 15.06.10 ו-15.06.24
• ענן פרטי: 4.15.04.01

לאילו גרסאות של Edge אפשר לשדרג 4.15.07.00

בהתאם לגרסה הנוכחית של Edge, תוכלו:

• שדרוג ישיר לגרסה 4.15.07.00
• שדרוג הדרגתי, כלומר עליך לשדרג מהגרסה הנוכחית לגרסה אחרת של Edge ולאחר מכן לשדרג ל-4.15.07.00.

אפשר לקרוא מידע נוסף במאמר לאילו גרסאות של Edge אפשר לשדרג ל-Cloud פרטי? 4.15.07.00.

לפני שדרוג מגרסה 4.15.01.x או מגרסה קודמת

1. צריך לבדוק את הגרסה של Cassandra SSTable:
   1. משנים את הספרייה ל-/<install-root>/apigee4/data/cassandra/data.
   2. מריצים פקודת חיפוש,
      > חיפוש . -name *-ic-*
      אם מפעילים את Cassandra 1.2 SSTable, התוצאות אמורות להחזיר קבוצה של קובצי .db
   3. מריצים את פקודת החיפוש הזו:
      > חיפוש . -name *-hf-*
      התוצאות צריכות להיות ריקות, כלומר אין קובצי db בפורמט hf. אם לא מופיעים קבצים בתרחיש לדוגמה hf, ניתן לשדרג ל-4.15.07.00.
      
      הפורמט hf מיועד Cassandra 1.0 SSTables. אם יש לכם קובצי *.db בפורמט hf, עליכם לשדרג את SSTable כמו שמתואר בהמשך התהליך.
2. אם מוצאים קובצי *.db בפורמט hf, צריך לשדרג את SSTable על ידי הרצת הפקודה הבאה בכל צומת של Cassandra עד לשדרוג כל הקמפיינים של Cassandra צמתים:
   > /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -hlocalhost לבחוןsstables -a
3. חוזרים על שלב 1 כדי לוודא שכל קובצי *.db הם בפורמט ic עבור Cassandra 1.2 .
4. חוזרים על שלבים 1 עד 3 בכל צומת של Cassandra בהתקנת Edge.
5. צריך לשדרג ל-Edge 4.15.07.00.
6. לאחר השדרוג 4.15.07.00, בודקים את קובצי *.db כדי לוודא שכולם שודרגו ל-Stable בסגנון C* 2.0:
   &gt; cd /&lt;install-root&gt;/apigee4/data/cassandra/data
   &gt; חיפוש . -שם *-jb-*
   פקודה זו אמורה להחזיר קבוצה של קובצי .db אם מפעילים את Cassandra 2.0.

תכונות ושיפורים חדשים

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

התקנה ושדרוג

שדרוג והסרה של רכיבים סלקטיביים

עכשיו הסקריפטים apigee-upgrade.sh ו-apigee-Uninstall.sh מאפשרים לבחור את רכיבי Edge כדי לשדרג או להסיר את ההתקנה. בעבר, הוא שדרג או הסיר את כל הרכיבים בצומת. (OPDK-1377, OPDK-1175)

חזרה למצב קודם של השדרוג

אם ה-apigee-upgrade.sh נכשל במהלך השדרוג, אפשר עכשיו להשתמש ב-apigee-rollback.sh כדי להחזיר את השדרוג לגרסה קודמת. אחרי שתפתרו את הבעיות בשדרוג, תוכלו לנסות לבצע שוב את השדרוג. (OPDK-1275)

אפשרויות מקוצרות לסקריפט של מנהל ההתקנה

הסקריפטים להתקנה כבר לא מוצגים במגוון אפשרויות, כמו -help. רק עכשיו שהוא כולל אפשרויות של אות אחת, כמו h-. (OPDK-1356)

התקנת SmartDocs

כשמתקינים את SmartDocs עם הסקריפט setup-smartdocs.sh, תתבקשו להזין את של הארגון, סביבה ומארח וירטואלי, שמבטיח ש-SmartDocs מותקן המיקום הצפוי. בעבר, הערכים האלה היו כתובים בתוך הקוד בסקריפט. (OPDK-1310)

הרצה של update-cass-pwd-in-config.sh ללא הנחיות

הסקריפט update-cass-pwd-in-config.sh יכול לרוץ ללא הנחיות אם מגדירים משתני הסביבה ENABLE_CASS_AUTH , CASS_USERNAME ו-CASS_password. (OPDK-1309)

פלטפורמת קצה

אלו הן התכונות החדשות של פלטפורמת Edge שכלולות בגרסה הזו.

תמיכה ב-OpenJDK 1.7 על ידי 'ענן פרטי של Edge'

הגרסה הזו של Edge תומכת ב-Oracle JDK 1.7 וב-OpenJDK 7, והתמיכה ב-JDK 1.6 הוסרה. (OPDK-1187)

תמיכה במערכת ההפעלה

התמיכה של מערכת ההפעלה ב-Apigee Edge ל-Private Cloud התרחבה, והיא כוללת את Red Hat Enterprise Linux 6.6 ו-Enterprise Linux 6.6 7.0 (64 ביט), CentOS 6.5, 6.6 ו- 7.0 (64 סיביות) ו-Oracle Linux 6.5.

Cassandra 2.0.15 כלולה ב-OPDK 15.07

בגרסה הזו מתקינה את Cassandra 2.0.15. אם בחרת לשדרג לגרסה קודמת, יעודכן הגרסה של Cassandra. (OPDK-1197)

תמיכה ב-SHA2 לגיבוב של אסימון OAuth

כדי להגן טוב יותר על אסימוני OAuth במקרה של פרצה באבטחה של מסד הנתונים, Edge תומך ב-SHA2 אלגוריתמים לגיבוב (hashing) של אסימוני OAuth (בנוסף ל-SHA1). עם רמת ארגון חדשה אפשר להפעיל ולהגדיר גיבוב (hashing) לאסימונים חדשים, וגם לשמור גיבוב מדור קודם באסימונים שהיו קיימים לפני התכונה החדשה הזו. בעבר, ב-Edge for Private Cloud, שנקרא hash.oauth.tokens.enabled בקובץ keymanagement.properties (בקובץ שרת ניהול ומעבדי הודעות) הפעיל גיבוב SHA1 אוטומטי של אסימוני OAuth. הזה הוצא משימוש את הנכס.

אם השתמשתם בעבר בנכס hash.oauth.tokens.enabled כדי להפעיל גיבוב SHA1, סקריפט השדרוג של הגרסה הזו יוצר עבורך באופן אוטומטי את הנכסים החדשים ברמת הארגון. שפת תרגום לבצע אימות לאחר השדרוג, לבצע GET כאדמין מערכת באמצעות ה-API הזה: https://{host}:{port}/v1/o/{your_org}.

• למידע על הפעלת גיבוב (hashing) של אסימונים בארגון עם הנכסים החדשים, אפשר לעיין במאמר 'גיבוב אסימונים במסד הנתונים' בקטע בקשת אסימוני גישה נושא.
• למידע על גיבוב (hashing) בכמות גדולה של אסימונים קיימים, אפשר לעיין במדריך לענן פרטי מדריך התפעול. (APIRT-1389)

מבנה ספרייה שטוחה לקובצי יומן

אפשר להגדיר את Edge לאחסון קובצי יומן במבנה של ספרייה שטוחה על ידי הגדרת המאפיין enable.flat.directory.structure צריך להיות True ב-message-logging.properties חדש. מידע נוסף זמין במאמר בנושא המדיניות בנושא רישום הודעות. (APIRT-1394)

ביצועי המטמון של הסביבה

לניהול ולניצול טובים יותר של המטמון בזיכרון, אפשר ללחוץ על 'מקסימום רכיבים בזיכרון' הוצאו משימוש את ההגדרות של משאבי המטמון בסביבה. סך כל הרכיבים שקיימים כל משאבי המטמון (כולל מטמון ברירת המחדל) תלויים בנפח הזיכרון הכולל שהוקצה של Google. כברירת מחדל, הזיכרון הכולל שהוקצה לשמירה במטמון בזיכרון במעבד הודעות נתון הוא 40% מסך הזיכרון הזמין, שנקבע לפי ההגדרות של מאפיין המטמון בהודעה של המעבד (cache.properties). רכיבים יוסרו מהמטמון בזיכרון רק אם יש מחסור בזיכרון מטמון או שתוקף הרכיבים יפוג.

כדי לחזור להתנהגות הקודמת של שימוש ב-" max Elements in Memory" (רכיבים מקסימליים בזיכרון) נכס עבור ניהול המטמון, צריך להגדיר את הנכס overrideMaxElementsInCacheResource=false file.properties. (APIRT-1140)

שירותי API

בהמשך מפורטות התכונות החדשות של שירותי ה-API שכלולות בגרסה הזו.

עורך Proxy חדש כברירת מחדל

עורך ה-Proxy החדש של API מופעל כברירת מחדל בממשק המשתמש של הניהול. העורך החדש כולל שיפורים רבים בנוחות השימוש, כולל תצוגות מקיפות יותר של תהליכים מותנים נקודות הקצה בדף 'סקירה כללית', כל ההגדרות בדף 'פיתוח', הוספה אינטואיטיבית יותר של תהליכים מותנים, נקודות קצה וכללי מדיניות, תצוגות XML מלאות יותר במקום קטעי טקסט קטנים שסורק שמות קבצים וטקסט ועוד. (שעון גריניץ'-2279)

מדיניות חדשה בנושא מחיקת מידע על OAuth גרסה 2.0

גרסה חדשה של 'מחיקת מידע OAuth v2.0' המדיניות מאפשרת למחוק אסימוני גישה ואסימוני גישה מסוג OAuth v2 קודים. המדיניות הזו מחליפה את הפונקציונליות שסופקה בעבר על ידי ה-Management API. לקבלת מידע נוסף מידע נוסף, ראו מחיקה מדיניות בנושא פרטי OAuthV2. (שעון גריניץ'-2257)

מדיניות חדשה בנושא מחיקת מידע על OAuth גרסה 1.0

גרסה חדשה של 'מחיקת מידע OAuth v1.0' המדיניות מאפשרת למחוק אסימוני בקשה מסוג OAuth v1.0, גישה אסימונים וקודים מאמתים. המדיניות מחליפה את הפונקציונליות שסופקה בעבר על ידי Management API. מידע נוסף זמין במאמר מחיקת המדיניות בנושא מידע על OAuth V1. (APIRT-1351)

מדיניות בקרת גישה

מדיניות בקרת הגישה שופרה כדי לאפשר הערכה פרטנית יותר של כתובות IP להוספה לרשימת ההיתרים ולהוספה לרשימת ההיתרים כשכתובות IP נכללות כותרת HTTP X-FORWARDED-FOR.

כשמסמנים כמה כתובות IP בכותרת (יש לפנות לתמיכה כדי להגדיר את feature.enableMultipleXForwardCheckForACL), רכיב <ValidateBasedOn> חדש במדיניות מאפשר לבדוק מול כתובת ה-IP הראשונה, כתובת ה-IP האחרונה או כל כתובות ה-IP שבכותרת. מידע נוסף זמין במדיניות בקרת הגישה.

ישויות חדשות במדיניות של ישות גישה

המדיניות לישות הגישה מאפשרת גישה לישויות החדשות הבאות: היקפי מפתח לצרכנים, 'קוד הרשאה', 'אסימון בקשה', ו'מאמת'. למידע נוסף ראו מדיניות לישות גישה.

המדיניות בנושא אוסף הנתונים הסטטיסטיים: המרה אוטומטית של שם הנתונים הסטטיסטיים לאותיות קטנות

כשיוצרים אוסף מותאם אישית של ניתוח נתונים בעורך ה-proxy ל-API (פיתוח דף > כלים) &gt; אוסף Analytics מותאם אישית), משתנה אספן (סטטיסטי) "שם" חייב להיות באותיות קטנות. אם מזינים את השם באותיות רישיות, הכלי ממיר באופן אוטומטי את השם הסטטיסטי לאותיות קטנות במדיניות של אוסף הנתונים הסטטיסטיים. (שעון גריניץ'-740)

הסרת הקטע Classic Trace בעורך ה-proxy ל-API

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

גישה לקהילת Apigee מתפריט העזרה בממשק המשתמש של הניהול

אפשר לגשת לקהילת Apigee מתפריט העזרה בממשק המשתמש של הניהול.

הודעות שגיאה בממשק המשתמש של הניהול

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

• ממשק המשתמש לניהול המשמש לקיבוץ ולהצגה של כל הודעות השגיאה בממשק המשתמש עבור כל סשן התחברות, אלא אם סגרתם אותם. בעקבות העדכון הזה, הודעות השגיאה יימחקו אוטומטית כשיוצאים מהדף שבו הן התרחשו. (שעון גריניץ'-2254)
• ממשק המשתמש לניהול כבר לא מסתיר יותר הודעות שגיאה כפולות. (MGMT-2242)

ביצועים של ממשק המשתמש ושיפורי שגיאות

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

היפר-קישורים לתפקיד בדף 'משתמשים בארגון' בממשק המשתמש לניהול

בדף 'משתמשים בארגון' בממשק המשתמש של הניהול ('אדמין > משתמשים בארגון'), התפקיד השמות מופיעים עכשיו בהיפר-קישורים, ומאפשרים לכם לנווט במהירות לדפי התפקידים. (שעון גריניץ'-1055)

משתני יעד חדשים בתהליך שליחת ההודעות

משתנים חדשים בתהליכי ההודעות מספקים מידע מלא יותר על כתובות URL של נקודות הקצה של היעד שרתי יעד:

• נקודת הקצה ביעד: request.url מחליפה את target.basepath.with.query.
• שרת היעד: loadbalancing.targetserver מחליף את targetserver.name. בנוסף, השדה target.basepath מאוכלס רק כאשר נעשה שימוש ברכיב <Path> רכיב <LoadBalancer> של HTTPTargetConnection.

תמיכה ב-Server Name Indication (SNI)

Edge תומך בשימוש ב'אינדיקטור שם השרת' לכיוון דרום (ממעבד הודעות ליעד) נקודות קצה). אם אתם רוצים להשתמש ב-SNI, פנו לתמיכה של Apigee.

נדרש Java 1.7.

עם SNI, שהוא הרחבה של TLS/SSL, ניתן להציג מספר יעדי HTTPS באותו אופן. כתובת ה-IP והיציאה בלי לחייב את כל היעדים האלה להשתמש באותו אישור.

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

Edge מחלץ באופן אוטומטי את שם המארח מכתובת האתר של הבקשה. מוסיף אותו לבקשת לחיצת היד של SSL. לדוגמה, אם מארח היעד הוא https://example.com/request/path, Edge מוסיף את התוסף server_name כמו שמוצג למטה:

מידע נוסף על SNI זמין בכתובת http://en.wikipedia.org/wiki/Server_Name_Indication.

'אלגוריתם חתימה' בפרטים של אישורי ה-SSL

'אלגוריתם חתימה' חדש התווסף לפרטי אישור ה-SSL, שניתן לראותו ממשק משתמש לניהול (מנהל מערכת > אישורי SSL) וממשק ה-API לניהול (קבל פרטי האישור מ-Keystore או מ-Truststore בשדה מוצג 'sha1WithRSAEncryption' או 'sha256WithRSAEncryption', בהתאם לסוג האלגוריתם הגיבוב שמשמש ליצירת הקוד אישור.

מוצגים אישורי SSL שתוקפם עומד לפוג

הדף 'אישורי SSL' בממשק המשתמש של הניהול (מנהל מערכת > אישורי SSL) מציין מתי התוקף של אישורי SSL יפוג בתוך 10, 15, 30 או 90 יום, בהתאם לבחירה שלך השדה הנפתח החדש 'פקיעת תוקף'.

הגדרה של שגיאות הגנה מאיומים

כברירת מחדל, Edge יקפיץ קוד סטטוס HTTP 500 'שגיאת שרת פנימית' וקובץ הפעלה שנכשל. שגיאה אם ההודעה לא מגיעה ממדיניות של הגנה מפני איומים של JSON או של XML. אפשר לשנות את התנהגות השגיאה הזו בנכס חדש ברמת הארגון. בעת הגדרת הארגון המאפיין features.isPolicyHttpStatusEnabled מוגדר ל-TRUE, הפונקציה הבאה מה קורה:

• בקשה: לכל תהליך בקשה מצורפת מדיניות הגנה מפני איומים, הודעות לא חוקיות יחזיר קוד סטטוס 400, יחד עם הודעת שגיאה תואמת מדיניות.
• תגובה: לכל תהליך תגובה שמצורפת מדיניות הגנה מפני איומים, יש הודעות לא תקינות עדיין יחזיר קוד סטטוס 500, ואחת מהודעות השגיאה הקשורות למדיניות תושמע (ולא רק הביצוע נכשל).

לקוחות Cloud חייבים לפנות לתמיכה של Apigee כדי להגדיר את מאפיין הארגון. התכונה הזו תהיה זמינה ללקוחות Edge Private Cloud בשלב הבא הפצה רבעונית של Private Cloud.

סכימות מעודכנות של נקודות קצה, שרתי proxy וישויות אחרות

הסכימות של ההפניות עודכנו בישויות שלא קשורות למדיניות, כמו TargetEndpoint, ProxyEndpoint , APIProxy ועוד רבים אחרים. פרטים נוספים זמינים בכתובת https://github.com/apigee/api-platform-samples/tree/master/schemas. (APIRT-1249)

שירותים למפתחים

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

זמינות כללית של SmartDocs

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

• תמיכה ב-Swagger 2.0, כולל ייבוא לפי קובץ או כתובת אתר, כולל תמיכה לאובייקטים של אבטחה בעלי שם בהתאמה אישית.
• שיפורים בעיצוב החזותי בתבניות שיוצרות SmartDocs.
• שיפורים בנוחות השימוש ובתהליך העבודה בפורטל המפתחים, שזמין דרך התוכן &gt; תפריט SmartDocs ב-Drupal.
• מה שמכונה 'אסימון מותאם אישית' האימות נקרא עכשיו 'מפתח API'.
• 'אבטחת' האימות אובייקטים שהוגדרו ברמת הגרסה הקודמת.
• הגדרה של אימות הלקוח ברמת התבנית. גרסאות קודמות חדשות לא אופסו יותר כל פרטי כניסה של לקוח SmartDocs שהוגדרו מראש.

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

למסמכי תיעוד של SmartDocs, ראו שימוש ב-SmartDocs למסמך ממשקי API.

השם של האפליקציה למפתחים מוצג בממשק המשתמש של הניהול

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

שירותי ניתוח נתונים

בהמשך מפורטות התכונות החדשות של Analytics Services שכלולות בגרסה הזו.

מגבלת זמן שימוש בנתונים שנשמרה

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

הגרסה הקלאסית של דוחות בהתאמה אישית תוסר מממשק הניהול

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

ביצועי הווידג'ט של מעורבות המפתחים

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

מונטיזציה

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

התראות באימייל לגבי תוכנית תעריפים

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

סנכרון של תקופות של עמלות חוזרות ובסיסי צבירה

בתוכנית תמחור ותשלומים, יכול להיות שהיו שתי תקופות זמן שונות שהיו בתוקף:

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

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

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

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

מאפיינים מותאמים אישית בדוחות סיכום הכנסות

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

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

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

שימו לב שמערך המאפיינים המותאמים אישית בקריאה ל-API מקודד בכתובות URL.

תהליך השדרוג של SmartDocs

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

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

חשוב לזכור שבזמן שאתם יכולים לעבד ולפרסם SmartDocs בפורטל המפתחים, מסמכים חכמים נוצרים ממודל ה-API שנמצא בניהול API של Apigee שירותים. כל השינויים שתבצעו במודל API ב-Edge יחולו בכל הפנתיאון. (בדומה לאופן שבו מפתחים קיימים בסביבות של Pantheon).

כדי לשדרג מגרסת הבטא של SmartDocs לזמינות לכלל המשתמשים

1. עדכון ובדיקה של גרסת 15.05.27 בסביבות dev או test הפנתיאון.
2. יוצרים מודל חדש שיחליף את כל מודל ה-API הקיים שבו השתמשתם.
   • אם ייבאתם מסמכי Swagger או WADL, עליכם לייבא אותם שוב לקובץ חדש גרסה קודמת.
   • אם עדכנתם את מודל ה-API באמצעות מודול SmartDocs, ייצאו אותו כקובץ קובץ JSON עם SmartDocs ולייבא אותו למודל החדש באמצעות קובץ מצורף.
3. הגדר את מאפייני האבטחה של גרסת המודל שלך. בקטע תוכן > SmartDocs > דף, בוחרים באפשרות הגדרות אבטחה.
   
4. בדוק אם יש אימות מוגדר מראש בדף הגדרות המודל (תוכן > SmartDocs) על ידי לחיצה על הגדרות בדף הפעולות. עמודה.
   
5. מעדכנים את כל התבניות בהתאמה אישית כך שישתמשו בגרסה 6 של נכסי ה-CSS ו-JS, ומבצעים שינויים בהתאם. שמות חדשים של אובייקטים, כמו authSchemes ו-apiSchema. למידע על עדכון SmartDocs בתבניות, ראה SmartDocs לתיעוד ממשקי API.
6. עיבוד מחדש ופרסום של תיקון המודל.
7. אחרי אימות המסמכים החדשים, צריך לעדכן פורטל production לגרסה 15.05.27.

ללקוחות של Edge Enterprise ויש לך שאלות או חששות לגבי השדרוג יש לשלוח אימייל לכתובת marsh@apigee.com וגם לכתובת cnovak@apigee.com. אחרת, צריך להשתמש קהילת Apigee תשובה.

שינויים ושיפורים עתידיים בתכונות

קטע זה מציג תצוגה מקדימה של שינויים ושיפורים עתידיים צפויים בתכונות:

שינוי ל- התנהגות המדיניות של מטמון התגובה

בגרסה עתידית (כפי שיקבע), פעולת ברירת המחדל של &lt;ExcludeErrorResponse&gt; של המדיניות 'מטמון תגובה' ישתנה.

התנהגות נוכחית: הרכיב <ExcludeErrorResponse> ב כברירת מחדל, המדיניות של מטמון התשובות מוגדרת כ-False. כלומר, כברירת מחדל, תשובות עם קוד מצב HTTP אפשרי (כולל 3xx) נשמר במטמון לפי המדיניות 'מטמון תגובה'.

התנהגות עתידית: הרכיב <ExcludeErrorResponse> ב כברירת מחדל, המדיניות בנושא מטמון התשובה מוגדרת כ-True. כלומר, כברירת מחדל, רק תשובות עם HTTP קודי סטטוס 200 עד 205 יישמרו במטמון. כדי לשנות את ההתנהגות הזו ולשמור את התשובות במטמון לכל המשתמשים קודי סטטוס, יהיה עליך להגדיר את הרכיב <ExcludeErrorResponse> אל True בצורה מפורשת.

הפתרון הנוכחי: ל-Private Cloud 4.15.07.00 ולגרסאות ישנות יותר, אם אתם רוצים לשמור תגובות במטמון רק עם קודי סטטוס 200 עד 205, עליכם להגדיר במפורש רכיב <ExcludeErrorResponse> עד TRUE.

הבאגים תוקנו

הבאגים הבאים תוקנו בגרסה הזו.

בעיות מוכרות

הגרסה הזו כוללת את הבעיות הידועות הבאות.

> source /{install-dir}/apigee4/bin/apigee-env.sh 

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4` 

> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh 

> rm /install-dir/apigee4/share/monetization 

************************************** 
In order to complete the monetization upgrade please run: 
sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/
365-create-notification-condition.sh 
************************************** 

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

<install_dir>/apigge4/bin/apigee-service message-processor restart