Δημιουργία εκδόσεων και υποστήριξη
Αυτό το άρθρο παρέχει μια επισκόπηση των πολιτικών δημιουργίας εκδόσεων και διακοπής αλλαγών για τα διάφορα εργαλεία δυνατότητας προγραμματισμού.
Υποστήριξη και απόσυρση πληροφοριών
Το Power Platform API είναι το πρώτο εργαλείο προγραμματισμού που λαμβάνει νέες εκδόσεις και δυνατότητες πριν από άλλες εκδόσεις SDShell, όπως τα PowerShell, Management Connectors και Power Platform CLI. Καθώς θα κυκλοφορήσει μια νέα έκδοση του REST API, παλαιότερες εκδόσεις θα αποσυρθούν. Microsoft θα δηλώσει μια έκδοση υπό απόσυρση τουλάχιστον 12 μήνες πριν αποσύρει μια τελικό σημείο API. Όταν μια έκδοση δεν χρησιμοποιείται, υποστηρίζεται ακόμα ως έχει. Εάν αντιμετωπίσετε κάποιο πρόβλημα με τη συγκεκριμένη έκδοση, θα σας ζητάμε να μετακινηθείτε στη γενικά διαθέσιμη έκδοση αυτήν τη στιγμή. Όταν μια έκδοση αποσυρθεί, δεν υποστηρίζεται και σύντομα θα κλείσει.
Αυξάνοντας τον αριθμό έκδοσης του API (για παράδειγμα, από 2021-10-01 σε 2022-04-01), Microsoft ανακοινώνει ότι η προηγούμενη γενικά διαθέσιμη έκδοση (σε αυτό το παράδειγμα, 2021-10-01) αποσύρεται αμέσως και θα αποσυρθεί 12 μήνες μετά την ανακοίνωση. Το ίδιο πρόβλημα υπήρχε και για τις δημόσιες εκδόσεις προεπισκόπησης. Microsoft ενδέχεται να κάνει εξαιρέσεις σε αυτήν την πολιτική για θέματα εύρυθμης λειτουργίας και ασφάλειας υπηρεσιών.
Για cmdlet PowerShell, θα είναι διαθέσιμες σταδιακές εκδόσεις για την επίλυση ελασσόνων επιδιορθώσεων σφαλμάτων. Θα προσαυξάνονται οι κυριότερες εκδόσεις ώστε να ταιριάζουν με τις νέες εκδόσεις API που προκύπτουν.
Συμβατές και τελευταίες αλλαγές
Microsoft θα παρέχει λεπτομέρειες σχετικά με τις αλλαγές στη δυνατότητα προγραμματισμού στα σχέδια έκδοσης. Εάν οι αλλαγές δεν είναι τελευταίες στη φύση τους, η έκδοση του API θα παραμείνει ίδια και η έκδοση PowerShell θα λάβει μια μικρή προσαύξηση έκδοσης. Εάν οι αλλαγές είναι σπάσιμο στη φύση, Microsoft θα αυξήσει την έκδοση API και PowerShell κύρια έκδοση.
Ακολουθούν παραδείγματα τελευταίων αλλαγών:
- Η διεύθυνση URL ή η θεμελιώδης αίτηση/απόκριση αλλάζει.
- Μια δηλωμένη ιδιότητα καταργείται ή μετονομάζεται ή ο τύπος της αλλάζει.
- Το API ή οι παράμετροι API καταργούνται ή μετονομάζεται.
- Προστίθεται μια απαιτούμενη παράμετρος αίτησης.
Ακολουθούν παραδείγματα μη τελευταίων αλλαγών:
- Προστίθενται ιδιότητες με δυνατότητα null ή προεπιλεγμένη τιμή.
- Ένα μέλος προστίθεται σε μια απαρίθμηση.
- Στις υπάρχουσες συλλογές χρησιμοποιείται η σελιδοποίηση.
- Οι κωδικοί σφάλματος αλλάζουν.
- Η σειρά των ιδιοτήτων στις αιτήσεις ή τις αποκρίσεις αλλάζει.
Διαθέσιμες εκδόσεις
| Έκδοση | Τύπος | Αναφορά | Ημερομηνία απόσυρσης | Ημερομηνία διακοπής χρήσης |
|---|---|---|---|---|
| 2022-03-01-preview | Δημόσια έκδοση προεπισκόπησης | 2022-03-01-προεπισκόπηση Ref | ΔΙ | ΔΙ |
| 01-10-2020 | Γενικά διαθέσιμο | 2020-10-01 Ref | ΔΙ | ΔΙ |
Σημείωμα
Η 2020-10-01 γενικά διαθέσιμη έκδοση του Power Platform API αφορά ειδικά τη διαχείριση περιβάλλοντος και συχνά αναφέρεται ως API πλατφόρμας επιχειρηματικών εφαρμογών (BAP). Η λειτουργικότητα αυτού του συνόλου τελικών σημείων θα είναι διαθέσιμη σε νεότερες εκδόσεις του Power Platform API μαζί με πολλές επιπλέον δυνατότητες μετά την έκδοση 2022-03-01-preview.
Επόμενα βήματα
Τώρα που έχετε κατανοήσει τη στρατηγική για τη δημιουργία εκδόσεων και την υποστήριξη, δείτε τον τρόπο ελέγχου ταυτότητας με το Microsoft Power Platform API.