Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Dieser Artikel bietet eine Übersicht über die Versionsverwaltungs- und Änderungsrichtlinien für die verschiedenen Programmierbarkeitstools.
Informationen zu Support und veralteten Funktionen
Da eine neue Version der REST-API veröffentlicht wird, werden frühere Versionen eingestellt. Microsoft deklariert eine Version, die mindestens 12 Monate vor dem Zurückziehen eines API-Endpunkts veraltet ist. Wenn eine Version veraltet ist, wird sie as-isunterstützt. Wenn Sie ein Problem mit dieser Version haben, fordern wir, dass Sie zur aktuell stabilen Version wechseln. Wenn eine Version eingestellt wird, wird sie nicht unterstützt und wird bald beendet.
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.
Die verschiedenen Tools und SDKs, die über die Power Platform-API wie Power Platform CLI, den Admin V2-Connector und PowerShell generiert werden, werden auf neuere API-Versionen pro Aktion aktualisiert und sind für Endbenutzer transparent.
Kompatible und Breaking Changes
Microsoft enthält Details zu Programmierbarkeitsänderungen in den Veröffentlichungsplänen. Wenn die Änderungen in der Natur nicht geschützt sind, bleibt die API-Version gleich, und die PowerShell-Version erhält eine Nebenversion inkrementiert. Wenn die Änderungen in der Natur fehlschlagen, erhöht Microsoft die API-Version und die PowerShell-Hauptversion.
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 sind Beispiele für geschützte Änderungen:
- 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 |
|---|---|---|---|---|
| 2024-10-01 | stabil | Referenz | NICHT ZUTREFFEND | NICHT ZUTREFFEND |
| 2022-03-01-preview | Öffentliche Vorschauversion | 2022-03-01-preview Referenz | 2025-03-01 | 2026-03-01 |
| 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 Features 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.