הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
מאמר זה מספק סקירה של מדיניות גירסאות ושינויים שוברים של כלי תכנות שונים.
מידע תמיכה והוצאה משימוש
עם ההפצה של גירסה חדשה של ממשק ה- REST API, גירסאות קודמות יוצאות משימוש. Microsoft מצהירה שגירסה הוצאה משימוש לפחות 12 חודשים לפני הוצאה משימוש של נקודת קצה של API. כאשר גירסה אינה נמצאת עוד בשימוש, היא נתמכת as-is. אם אתה נתקל בבעיה בגירסה זו, אנו מבקשים שתעבור לגירסה היציבה כעת. כאשר גירסה הוצאה משימוש, היא אינה נתמכת ובקרוב תכבה אותה.
על ידי הגדלת מספר הגרסה של ה-API (לדוגמה, מ-2021-10-01 ל-2022-04-01), Microsoft מודיע שהגרסה הקודמת הזמינה באופן כללי (בדוגמה זו, 2021-10-01) הוצאה משימוש מיידית ותצא משימוש 12 חודשים לאחר ההודעה. Microsoft עשוי לעשות חריגים למדיניות זו עבור בעיות בריאות ואבטחה של השירות.
הכלים וקובצי ה- SDK השונים שנוצרים על-גבי ה- API של Power Platform, כגון Power Platform CLI, המחבר Admin V2 ו- PowerShell, מתעדכנים לגירסאות API חדשות יותר על בסיס כל פעולה, ושקופים למשתמשי קצה.
שינויים תואמים ושוברים
Microsoft מספקת פרטים על שינויים באפשרויות תיכנות בתוכניות ההפצה. אם השינויים מתרחשים באופן בלתי קשיח, גירסת ה- API נשארת זהה וגירסת PowerShell מקבלת הגדלה של גירסה משנית. אם השינויים מתפצים בטבע, Microsoft מגדלה בגירסה הראשית של ה- API ובגירסה הראשית של PowerShell.
להלן דוגמאות לשינויים שוברים:
- כתובת האתר או הבקשה / התגובה הבסיסית משתנים.
- מאפיין מוכרז הוסר, או שהשם או הסוג שלו השתנה.
- פרמטרי ה- API או ה- API הוסרו או ששמם השתנה.
- הוסף פרמטר בקשה נדרש.
להלן דוגמאות לשינויים קשיחים:
- הוספו מאפיינים ניתנים לביטול או בעלי ערך ברירת מחדל.
- חבר נוסף לספירה.
- החלפה מתאפשרת באוספים קיימים.
- קודי השגיאה השתנו.
- הסדר של המאפיינים בבקשות או בתגובות השתנה.
Available versions
| Version | Type | Reference | Deprecation date | Decommission date |
|---|---|---|---|---|
| 2024-10-01 | Stable | Reference | N/A | N/A |
| 2020-10-01 | Generally available | 2020-10-01 Ref | N/A | N/A |
Note
הגרסה הזמינה ל-2020-10-01 של Power Platform API ייחודית לניהול סביבה ומכונה גם API פלטפורמת יישומים עסקית (BAP). הפונקציונליות של מערך נקודות קצה זה זמינה בגרסאות החדשות של Power Platform API.
Next steps
כעת, לאחר שהבנת את אסטרטגיית הגירסאות והתמיכה, בוא נגלה כיצד לאמת עם API של Microsoft Power Platform.