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