Notă
Accesul la această pagină necesită autorizare. Puteți încerca să vă conectați sau să modificați directoarele.
Accesul la această pagină necesită autorizare. Puteți încerca să modificați directoarele.
Acest articol oferă o prezentare generală a politicilor de versiune și de modificare a diferitelor instrumente de programabilitate.
Informații despre asistență și perimare
Pe măsură ce este lansată o nouă versiune a API-ului REST, versiunile anterioare sunt retrase. Microsoft declară o versiune perimată cel puțin 12 luni înainte ca acesta să retragă un punct final API. Atunci când o versiune este perimat, este acceptată as-is. Dacă vă confruntați cu o problemă cu versiunea respectivă, vă solicităm să treceți la versiunea stabilă în prezent. Atunci când o versiune este retrasă, aceasta nu este acceptată și în curând se va închide.
Prin creșterea numărului de versiune a API-ului (de exemplu, de la 2021-10-01 la 2022-04-01), Microsoft anunță că versiunea anterioară disponibilă în general (în acest exemplu, 2021-10-01) este imediat depreciată și va fi retrasă 12 luni de la anunț. Același tratament este aplicat și pentru versiunile preliminare publice. Microsoft ar putea face excepții de la această politică pentru probleme de sănătate și securitate a serviciului.
Diversele instrumente și SDK-uri generate în partea de sus a API-ului Power Platform, cum ar fi Power Platform CLI, conectorul V2 de administrare și PowerShell, sunt actualizate la versiunile API mai noi pe bază de acțiune și sunt transparente pentru utilizatorii finali.
Modificări compatibile și de rupere
Microsoft oferă detalii despre modificările de programare din planurile de lansare. Dacă modificările nu apar în natură, versiunea API rămâne aceeași, iar versiunea PowerShell primește o incrementare de versiune minoră. Dacă modificările se modifică în natură, Microsoft incrementează versiunea API și versiunea majoră PowerShell.
Iată câteva exemple de modificări de rupere:
- Adresa URL sau solicitarea/răspunsul fundamental sunt modificate.
- O proprietate declarată este eliminată sau redenumită sau tipul acesteia este modificat.
- API-ul sau parametrii API sunt eliminați sau redenumiți.
- Este adăugat un parametru necesar de solicitare.
Iată exemple de modificări neseparatoare:
- Se adaugă proprietăți care sunt anulabile sau au o valoare implicită.
- Un membru este adăugat la o enumerare.
- Paginarea este introdusă în colecțiile existente.
- Codurile de eroare sunt modificate.
- Ordinea proprietăților din solicitări sau răspunsuri este modificată.
Versiuni disponibile
| Versiune | Tipul | Referințe | Dată de perimare | Data dezafectării |
|---|---|---|---|---|
| 2024-10-01 | Grajd | de referință | Nedisponibil | Nedisponibil |
| 2022-01-03-versiune preliminară | Versiune preliminară publică | Ref 2022-03-01-preview | 2025-03-01 | 2026-03-01 |
| 2020-10-01 | General disponibil | Ref 2020-10-01 | Nedisponibil | Nedisponibil |
Notă
Versiunea 2020-10-01 disponibilă la nivel general a Power Platform API este specifică gestionării mediilor și este denumită în mod obișnuit Business Application Platform (BAP) API. Funcționalitatea acestui set de puncte finale este disponibilă în versiunile mai noi de POWER Platform API, împreună cu multe caracteristici suplimentare după versiunea 2022-03-01-preview.
Pașii următori
Acum că ați înțeles strategia de versiuni și de suport, să parcurgem procedura de autentificare cu Microsoft Power Platform API.