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ț. 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ă.
Available versions
| Version | Type | Reference | Deprecation date | Decommission date |
|---|---|---|---|---|
| 2024-10-01 | Stable | Reference | N/A | N/A |
| 2020-10-01 | Generally available | 2020-10-01 Ref | N/A | N/A |
Note
Versiunea disponibilă în general a API-ului Power Platform din 2020-10-01 este specifică managementului mediului și este denumită în mod obișnuit și API-ul Business Application Platform (BAP). Funcționalitatea acestui set de endpoint-uri este disponibilă în versiunile mai noi ale Power Platform API.
Next steps
Acum că ați înțeles strategia de versiuni și de suport, să parcurgem procedura de autentificare cu Microsoft Power Platform API.