Σημείωμα
Η πρόσβαση σε αυτήν τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να εισέλθετε ή να αλλάξετε καταλόγους.
Η πρόσβαση σε αυτήν τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να αλλάξετε καταλόγους.
Αυτό το άρθρο παρέχει μια επισκόπηση των πολιτικών δημιουργίας εκδόσεων και διακοπής αλλαγών για τα διάφορα εργαλεία δυνατότητας προγραμματισμού.
Υποστήριξη και απόσυρση πληροφοριών
Καθώς κυκλοφορεί μια νέα έκδοση του 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 ή προεπιλεγμένη τιμή.
- Ένα μέλος προστίθεται σε μια απαρίθμηση.
- Στις υπάρχουσες συλλογές χρησιμοποιείται η σελιδοποίηση.
- Οι κωδικοί σφάλματος αλλάζουν.
- Η σειρά των ιδιοτήτων στις αιτήσεις ή τις αποκρίσεις αλλάζει.
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
Τώρα που έχετε κατανοήσει τη στρατηγική για τη δημιουργία εκδόσεων και την υποστήριξη, δείτε τον τρόπο ελέγχου ταυτότητας με το Microsoft Power Platform API.