Controllo delle versioni e supporto
Questo articolo fornisce una panoramica del controllo delle versioni e dei criteri delle modifiche che causano un'interruzione per i vari strumenti di programmazione.
Informazioni sul supporto e sulla deprecazione
L'API di Power Platform è il primo strumento di programmazione a ricevere nuove versioni e funzionalità prima di altri SDK come PowerShell, connettori di gestione e interfaccia della riga di comando di Power Platform. Quando viene rilasciata una nuova versione di API REST, le versioni precedenti verranno ritirate. Microsoft dichiarerà una versione obsoleta almeno 12 mesi prima di ritirare un'API endpoint. Quando una versione viene deprecata, è ancora supportata così com'è. Se riscontri un problema con quella versione, ti chiederemo di passare alla versione attualmente generalmente disponibile. Quando una versione viene ritirata, non è supportata e verrà presto disattivata.
Incrementando il numero di versione dell'API (ad esempio, da 2021-10-01 a 2022-04-01), Microsoft si annuncia che la precedente versione generalmente disponibile (in questo esempio, 2021-10-01) è immediatamente deprecata e verrà ritirata 12 mesi dopo l'annuncio. Lo stesso trattamento è riservato alle versioni in anteprima pubblica. Microsoft potrebbe prevedere eccezioni a questa politica per problemi di integrità e sicurezza del servizio.
Per i cmdlet di PowerShell, saranno rese disponibili versioni incrementali per risolvere correzioni di bug minori. Le versioni principali verranno incrementate per corrispondere alle nuove versioni dell'API che si verificano.
Compatibilità e modifiche che causano un'interruzione
Microsoft fornirà dettagli sulle modifiche alla programmabilità nei piani di rilascio . Se le modifiche non causano un'interruzione, la versione dell'API rimarrà la stessa e la versione di PowerShell riceverà un incremento minore della versione. Se le modifiche sono di natura disruptiva, Microsoft incrementerà la versione API e la versione principale di PowerShell.
Ecco alcuni esempi di modifiche che causano un'interruzione:
- L'URL o la richiesta/risposta fondamentale viene modificata.
- Una proprietà dichiarata viene rimossa o rinominata oppure il relativo tipo viene modificato.
- L'API o i parametri dell'API vengono rimossi o rinominati.
- Viene aggiunto un parametro di richiesta obbligatorio.
Ecco alcuni esempi di modifiche che non causano un'interruzione:
- Vengono aggiunte proprietà che ammettono valori null o hanno un valore predefinito.
- Un membro viene aggiunto a un'enumerazione.
- Viene introdotto il paging nelle raccolte esistenti.
- I codici di errore vengono modificati.
- L'ordine delle proprietà nelle richieste o nelle risposte viene modificato.
Versioni disponibili
| Versione | Tipo | Riferimento | Data di deprecazione | Data di ritiro |
|---|---|---|---|---|
| Anteprima 2022-03-01 | Anteprima pubblica | 2022-03-01-anteprima Rif. | N/D | N/A |
| 2020-10-01 | Generalmente disponibile | 2020-10-01 Rif. | N/A | N/A |
Nota
La versione 2020-10-01 generalmente disponibile dell'API di Power Platform è specifica per la gestione dell'ambiente ed è anche comunemente denominata API BAP (Business Application Platform). La funzionalità di questo set di endpoint sarà resa disponibile nelle versioni più recenti dell'API di Power Platform insieme a molte funzionalità aggiuntive dopo la versione di anteprima 2022-03-01.
Passaggi successivi
Ora che hai compreso la strategia per il controllo delle versioni e il supporto, esaminiamo come eseguire l'autenticazione con l'API di Microsoft Power Platform.