Versionskontrolle und Support
Dieser Artikel bietet eine Übersicht über die Versionsverwaltungs- und Änderungsrichtlinien für die verschiedenen Programmierbarkeitstools.
Informationen zu Support und veralteten Funktionen
Die Power Platform-API ist das erste Programmierbarkeitstool, das neue Versionen und Funktionen vor anderen SDKs, wie PowerShell, Verwaltungsconnectors und Power Platform CLI, verwendet. Wenn eine neue Version der REST-API veröffentlicht wird, werden frühere Versionen eingestellt. Microsoft wird eine Version mindestens 12 Monate vor der Außerdienststellung einer API für veraltet erklären Endpunkt. Wenn eine Version veraltet ist, wird sie weiterhin unverändert unterstützt. Wenn Sie ein Problem mit dieser Version haben, bitten wir Sie auf die derzeit allgemein verfügbare Version umzusteigen. Wenn eine Version zurückgezogen wird, wird sie nicht mehr unterstützt und demnächst abgeschaltet.
Durch Erhöhen der Versionsnummer der API (beispielsweise von 2021-10-01 auf 2022-04-01) Microsoft wird angekündigt, dass die vorherige allgemein verfügbare Version (in diesem Beispiel 2021-10-01) sofort veraltet ist und 12 Monate nach der Ankündigung außer Dienst gestellt wird. Bei öffentlichen Vorschauversionen wird genauso vorgegangen. Microsoft Aus Gründen der Serviceintegrität und -Sicherheit können Ausnahmen von dieser Richtlinie gemacht werden.
Für PowerShell-Cmdlets werden inkrementelle Versionen zur Verfügung gestellt, um kleinere Fehlerkorrekturen zu beheben. Hauptversionen werden inkrementiert, sodass sie zu den neu auftretenden API-Versionen passen.
Kompatible und Breaking Changes
Microsoft wird Einzelheiten zu Änderungen der Programmierbarkeit in den Versionsplänen bereitstellen. Wenn die Änderungen als nicht Fehler verursachend angesehen werden, bleibt die API-Version unverändert und die PowerShell-Version erhält ein Nebenversionsinkrement. Wenn die Änderungen grundlegender Natur sind, Microsoft werden die API-Version und die Hauptversion von PowerShell erhöht.
Hier finden Sie Beispiele für Fehler Breaking Changes:
- Die URL oder grundlegende Anfrage/Antwort wird geändert.
- Eine deklarierte Eigenschaft wird entfernt oder umbenannt oder ihr Typ wird geändert.
- Die API oder API-Parameter werden entfernt oder umbenannt.
- Es wird ein erforderlicher Anforderungsparameter hinzugefügt.
Hier finden Sie Beispiele für Nonbreaking Changes:
- Es werden Eigenschaften hinzugefügt, die auf NULL festlegbar sind oder einen Standardwert haben.
- Ein Mitglied wird einer Enumeration hinzugefügt.
- Paging wird in vorhandene Sammlungen eingeführt.
- Fehlercodes werden geändert.
- Die Reihenfolge der Eigenschaften in Anforderungen oder Antworten wird geändert.
Verfügbare Versionen
| Version | Typ | Verweis | Datum der Einstellung | Datum der Einstellung der Nutzung |
|---|---|---|---|---|
| 2022-03-01-preview | Öffentliche Vorschauversion | 2022-03-01-preview Referenz | NICHT ZUTREFFEND | NICHT ZUTREFFEND |
| 2020-10-01 | Allgemein verfügbar | 2020-10-01 Artikel-Nr. | NICHT ZUTREFFEND | NICHT ZUTREFFEND |
Notiz
Die allgemein verfügbare 2020-10-01-Version der Power Platform-API ist spezifisch für die Umgebungsverwaltung und wird häufig auch als Business Application Platform (BAP) API bezeichnet. Die Funktionalität dieser Gruppe von Endpunkten wird in den neueren Versionen der Power Platform API zusammen mit vielen zusätzlichen Funktionen nach Version 2022-03-01-preview zur Verfügung gestellt.
Nächste Schritte
Nachdem Sie jetzt die Versionsverwaltungs- und Supportstrategie verstanden haben, kommen wir jetzt zur Authentifizierung mit der Microsoft Power Platform API.