Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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
W miarę wydawania nowej wersji interfejsu API REST starsze wersje są wycofywanych. Firma Microsoft deklaruje wersję przestarzałą co najmniej 12 miesięcy przed wycofaniem punktu końcowego interfejsu API. Jeśli wersja jest przestarzała, jest obsługiwana as-is. Jeśli wystąpi problem z tą wersją, prosimy o przejście do obecnie stabilnej wersji. Po wycofaniu wersji nie jest obsługiwana 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.
Różne narzędzia i zestawy SDK generowane na podstawie interfejsu API platformy Power Platform, takie jak interfejs wiersza polecenia platformy Power Platform, łącznik Admin V2 i program PowerShell, są aktualizowane do nowszych wersji interfejsu API na podstawie akcji i są niewidoczne dla użytkowników końcowych.
Zmiana powodująca niezgodność i kompatybilność
Firma Microsoft udostępnia szczegółowe informacje o zmianach programowych w planach wydania. Jeśli zmiany nie są przełomowe, wersja interfejsu API pozostaje taka sama, a wersja programu PowerShell otrzymuje przyrost wersji pomocniczej. Jeśli zmiany mają charakter powodujący niezgodność, firma Microsoft zwiększa 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 przełomowych zmian:
- 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 |
|---|---|---|---|---|
| 2024-10-01 | Stabilny | Referencja | Brak | Brak |
| 2022-03-01-preview | Publiczna wersja zapoznawcza | 2022-03-01-podgląd Ref | 2025-03-01 | 2026-03-01 |
| 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. Funkcje tego zestawu punktów końcowych są udostępniane w nowszych wersjach interfejsu API platformy 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.