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