תמיכה וניהול גירסאות
מאמר זה מספק סקירה של מדיניות גירסאות ושינויים שוברים של כלי תכנות שונים.
מידע תמיכה והוצאה משימוש
ה- API של Power Platform הוא כלי התכנות הראשון שמקבל גירסאות ותכונות חדשות לפני ערכות SDK אחרות כמו PowerShell, Management Connectors ו- CLI Power Platform. לאחר שחרור הגירסה החדשה של REST API, גירסאות קודמות יצאו משימוש. Microsoft יכריז על גרסה שהוצאה משימוש לפחות 12 חודשים לפני שהיא מוציאה משימוש API נקודת קצה. כאשר גרסה אינה בשימוש (deprecated) היא עדיין נתמכת כפי שהיא. אם תיתקל בבעיה עם גירסה זו, נבקש ממך לעבור לגרסה הנוכחית שזמינה באופן כללי. כאשר גרסה יצאה משימוש סופית (retired) היא אינה נתמכת ובקרוב תושבת.
על ידי הגדלת מספר הגרסה של ה-API (לדוגמה, מ-2021-10-01 ל-2022-04-01), Microsoft מודיע שהגרסה הקודמת הזמינה באופן כללי (בדוגמה זו, 2021-10-01) הוצאה משימוש מיידית ותצא משימוש 12 חודשים לאחר ההודעה. אותו הליך קיים בגירסאות public preview. Microsoft עשוי לעשות חריגים למדיניות זו עבור בעיות בריאות ואבטחה של השירות.
עבור cmdlets של PowerShell, גרסאות מצטברות יהיו זמינות לפתרון תיקוני באגים קלים. המספר של גירסאות מאז'וריות (Major) יעלה כדי להתאים לגרסאות ה-API החדשות שמגיעות.
שינויים תואמים ושוברים
Microsoft יספק פרטים על שינויים בתכנות ב תוכניות השחרור. אם השינויים אינם שוברים באופיים, גרסת ה-API תישאר זהה, וגרסת PowerShell תקבל תוספת גרסה מינורית. אם השינויים פורצים בטבעם, Microsoft יגדיל את גרסת ה-API ואת גרסת PowerShell הראשית.
להלן דוגמאות לשינויים שוברים:
- כתובת האתר או הבקשה / התגובה הבסיסית משתנים.
- מאפיין מוכרז הוסר, או שהשם או הסוג שלו השתנה.
- פרמטרי ה- API או ה- API הוסרו או ששמם השתנה.
- הוסף פרמטר בקשה נדרש.
להלן דוגמאות לשינויים שאינם שוברים:
- הוספו מאפיינים ניתנים לביטול או בעלי ערך ברירת מחדל.
- חבר נוסף לספירה.
- החלפה מתאפשרת באוספים קיימים.
- קודי השגיאה השתנו.
- הסדר של המאפיינים בבקשות או בתגובות השתנה.
גירסאות זמינות
| גירסה | סוג | חומר עזר | תאריך הוצאה משימוש | תאריך השבתה |
|---|---|---|---|---|
| 2022-03-01-preview | Public Preview | 2022-03-01-תצוגה מקדימה Ref | לא ישים | לא ישים |
| 2020-10-01 | זמין לכלל המשתמשים | 2020-10-01 Ref | לא ישים | לא ישים |
הערה
הגירסה 2020-10-01 הזמינה באופן כללי ל- API של Power Platform היא ספציפית לניהול סביבה ונקראת בדרך כלל API (BAP) של פלטפורמת Business Application. הפונקציונליות של ערכת נקודות קצה זו תהיה זמינה בגירסאות החדשות יותר ל-API של Power Platform ביחד עם תכונות נוספות רבות אחרי גירסה 2022-03-01-preview.
השלבים הבאים
כעת, לאחר שהבנת את אסטרטגיית הגירסאות והתמיכה, בוא נגלה כיצד לאמת עם API של Microsoft Power Platform.