Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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
Quando viene rilasciata una nuova versione dell'API REST, le versioni precedenti vengono ritirate. Microsoft dichiara una versione deprecata almeno 12 mesi prima del ritiro di un endpoint API. Quando una versione è deprecata, è supportata as-is. Se si verifica un problema con tale versione, viene richiesto di passare alla versione attualmente stabile. Quando una versione viene ritirata, non è supportata e verrà presto arrestata.
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.
I vari strumenti e SDK generati con l'API Power Platform, come l'interfaccia della riga di comando di Power Platform, il connettore Admin V2 e PowerShell, vengono aggiornati alle versioni api più recenti in base all'azione e sono trasparenti per gli utenti finali.
Compatibilità e modifiche che causano un'interruzione
Microsoft fornisce informazioni dettagliate sulle modifiche alla programmabilità nei piani di rilascio. Se le modifiche non causano interruzioni, la versione dell'API rimane invariata e la versione di PowerShell riceve un incremento della versione secondaria. Se le modifiche causano interruzioni, Microsoft incrementa la versione dell'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 interruzioni:
- 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 |
|---|---|---|---|---|
| 2024-10-01 | Stabile | Riferimento | N/D | N/D |
| Anteprima 2022-03-01 | Anteprima pubblica | 2022-03-01-anteprima Rif. | 2025-03-01 | 2026-03-01 |
| 2020-10-01 | Generalmente disponibile | 2020-10-01 Rif. | N/D | N/D |
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 viene resa disponibile nelle versioni più recenti dell'API power platform, insieme a molte funzionalità aggiuntive dopo la versione 2022-03-01-preview.
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.