Przechowywanie wersji i obsługa
W tym artykule przedstawiono omówienie zasad tworzenia wersji i zmian powodujących niezgodność z różnymi narzędziami do programowania.
Pomoc techniczna i wycofywanie — informacje
API Power Platform jest pierwszym narzędziem programistycznym, które otrzymuje nowe wersje i funkcje przed innymi SDK, takimi jak PowerShell, Management Connectors i Power Platform CLI. Gdy pojawi się nowa wersja REST API, wcześniejsze wersje zostaną wycofane. Microsoft zadeklaruje wersję jako przestarzałą co najmniej 12 miesięcy przed wycofaniem punktu końcowego interfejsu API. Gdy wersja jest przestarzała, jest nadal wspierana w obecnej formie. Jeśli napotkasz problem z tą wersją, poprosimy cię o przejście na aktualnie ogólnie dostępną wersję. Kiedy dana wersja zostaje wycofana, oznacza to, że nie jest wspierana i wkrótce zostanie wyłączona.
Zwiększając numer wersji interfejsu API (na przykład z 2021-10-01 do 2022-04-01), Microsoft ogłasza, że poprzednia ogólnie dostępna wersja (w tym przykładzie 2021-10-01) jest natychmiast przestarzała i zostanie wycofana 12 miesięcy po ogłoszeniu. W ten sam sposób traktowane są publiczne wersje zapoznawcze. Microsoft może tworzyć wyjątki od tej zasady w przypadku problemów z kondycją i zabezpieczeniami usługi.
W przypadku PowerShell cmdlets, w celu rozwiązania niewielkich usterek zostaną udostępnione wersje do usunięcia niewielkich usterek. Główne wersje będą zwiększane tak, by odpowiadały nowym wersjom API, które się pojawią.
Zmiana powodująca niezgodność i kompatybilność
Microsoft dostarczy szczegółowe informacje na temat zmian programowalności w planach wydawniczych. Jeśli zmiany nie będą powodowały niezgodności, wersja interfejsu API pozostanie taka sama, a wersja programu PowerShell będzie otrzymywać niewielki przyrost wersji. Jeśli zmiany mają charakter nieprawidłowy, Microsoft zwiększy wersję interfejsu API i wersję główną programu PowerShell.
Oto przykłady zmian powodujących niezgodność:
- Adres URL lub podstawowe żądanie/odpowiedź zostaną zmienione.
- Właściwość, która uległa zmianie, zostanie usunięta lub zmieniona bądź też zostanie zmieniony jej typ.
- Parametry interfejsu API lub API są usuwane i zmieniane są ich nazwy.
- Dodawany jest wymagany parametr.
Oto przykłady zmian nie powodujących niezgodności:
- Dodawane są właściwości z wartością null lub mają wartość domyślną.
- Element jest dodawany do wyliczenia.
- Stronicowanie jest wprowadzane do istniejących zbiorów.
- Kody błędów zmienione.
- Kolejność właściwości w żądaniach i odpowiedziach jest zmieniana.
Dostępne wersje
Wersja | Typ | Referencje | Data wycofywania | Data wycofania z użycia |
---|---|---|---|---|
2022-03-01-preview | Publiczna wersja zapoznawcza | 2022-03-01-podgląd Ref | Brak | Brak |
2020-10-01 | Ogólna dostępność | 2020-10-01 Nr ref. | Brak | Brak |
Uwaga
2020-10-01 Ogólnie dostępna wersja API Power Platform jest specyficzna dla zarządzania środowiskiem i jest również powszechnie nazywana Business Application Platform (BAP) API. Funkcjonalność tego zestawu punktów końcowych zostanie udostępniona w nowszych wersjach API Power Platform wraz z wieloma dodatkowymi funkcjami po wersji 2022-03-01-preview.
Następne kroki
Po zrozumieniu strategii obsługi i obsługi wersji przejdźmy przez proces uwierzytelniania w programie API Microsoft Power Platform.