Versiebeheer en ondersteuning
Dit artikel biedt een overzicht van het versiebeheer en het overtreden van wijzigingsbeleid voor de verschillende hulpmiddelen voor programmeerbaarheid.
Informatie over ondersteuning en afschaffing
De Power Platform-API is de eerste programmeertool die nieuwe versies en functies ontvangt vóór andere SDK's zoals PowerShell, Management Connectors en Power Platform-CLI. Wanneer een nieuwe versie van de REST API wordt uitgebracht, worden eerdere versies stopgezet. Microsoft zal een versie als verouderd verklaren ten minste 12 maanden voordat de API wordt stopgezet eindpunt. Wanneer een versie is afgeschaft, wordt deze nog steeds ongewijzigd ondersteund. Als u een probleem ondervindt met die versie, zullen we u verzoeken over te stappen naar de momenteel algemeen beschikbare versie. Wanneer een versie buiten gebruik wordt gesteld, wordt deze niet ondersteund en wordt deze binnenkort uitgeschakeld.
Door het versienummer van de API te verhogen (bijvoorbeeld van 2021-10-01 naar 2022-04-01), Microsoft wordt aangekondigd dat de vorige algemeen beschikbare versie (in dit voorbeeld 2021-10-01) onmiddellijk is verouderd en 12 maanden na de aankondiging wordt ingetrokken. Dezelfde behandeling wordt toegepast voor openbare preview-versies. Microsoft kunnen uitzonderingen op dit beleid maken vanwege problemen met de servicestatus en beveiliging.
Voor PowerShell-cmdlets worden incrementele versies beschikbaar gesteld om kleine bugfixes op te lossen. Belangrijke versies worden opgehoogd om overeen te komen met de nieuwe API-versies die verschijnen.
Compatibele en onderbrekende wijzigingen
Microsoft zal details verstrekken over de programmeerbaarheidswijzigingen in de releaseplannen. Als de wijzigingen niet-onderbrekend van aard zijn, blijft de API-versie hetzelfde en krijgt de PowerShell-versie een kleinere versieverhoging. Als de wijzigingen van ingrijpende aard zijn, worden de API-versie en de hoofdversie van PowerShell verhoogd. Microsoft
Hier zijn voorbeelden van onderbrekende wijzigingen:
- De URL of de fundamentele aanvraag/respons is gewijzigd.
- Een gedeclareerde eigenschap is verwijderd of hernoemd, of het type is gewijzigd.
- De API of API-parameters zijn verwijderd of hernoemd.
- Een vereiste aanvraagparameter is toegevoegd.
Hier zijn voorbeelden van niet-onderbrekende wijzigingen:
- Er worden eigenschappen toegevoegd die nullable zijn of een standaardwaarde hebben.
- Een lid wordt toegevoegd aan een opsomming.
- Paging wordt geïntroduceerd in bestaande verzamelingen.
- Foutcodes zijn gewijzigd.
- De volgorde van eigenschappen in aanvragen of responsen wordt gewijzigd.
Beschikbare versies
| Versie | Type | Naslaginformatie | Datum van afschaffing | Datum van buitengebruikstelling |
|---|---|---|---|---|
| 2022-03-01-preview | Openbare preview | 2022-03-01-voorbeeld Ref | N.v.t. | N.v.t. |
| 01-10-2020 | Algemeen beschikbaar | 2020-10-01 Ref | N.v.t. | N.v.t. |
Notitie
De 2020-10-01 Algemeen beschikbare versie van Power Platform-API is specifiek voor omgevingsbeheer en wordt ook wel Business Application Platform (BAP) API genoemd. De functionaliteit van deze set eindpunten wordt beschikbaar gemaakt in de nieuwere versies van Power Platform-API samen met vele extra functies na versie 2022-03-01-preview.
Volgende stappen
Nu u de versiebeheer- en ondersteuningsstrategie begrijpt, gaan we kijken hoe u authenticatie met Microsoft Power Platform-API kunt uitvoeren.