Gestionarea versiunilor și asistență
Acest articol oferă o prezentare generală a politicilor de versiune și de modificare a diferitelor instrumente de programabilitate.
Informații despre asistență și perimare
API-ul Power Platform este primul instrument de programabilitate care primește versiuni și funcții noi înaintea altor SDK-uri precum PowerShell, Management Connectors și Power Platform CLI. Odată cu lansarea unei noi versiuni a API-ului REST, versiunile anterioare vor fi retrase. Microsoft va declara o versiune perimată cu cel puțin 12 luni înainte de a retrage un punct final API. Atunci când o versiune este perimată, este în continuare acceptată. Dacă întâmpinați o problemă cu versiunea respectivă, vă vom solicita să treceți la versiunea disponibilă în prezent. Când o versiune este retrasă, nu mai este acceptată și va fi oprită în curând.
Prin incrementarea numărului de versiune al API-ului (de exemplu, de la 2021-10-01 la 2022-04-01), Microsoft anunță că versiunea anterioară disponibilă la nivel general (în acest exemplu, 2021-10-01) este perimată imediat și va fi retrasă la 12 luni după anunț. Același tratament este aplicat și pentru versiunile preliminare publice. Microsoft poate face excepții de la această politică pentru probleme legate de starea și securitatea serviciilor.
Pentru cmdleturile PowerShell, versiunile incrementale vor fi puse la dispoziție pentru a rezolva remedierile minore ale erorilor. Versiunile majore vor fi incrementate pentru a se potrivi cu noile versiuni API care apar.
Modificări compatibile și de rupere
Microsoft va furniza detalii despre modificările programabilității în planuri de lansare. Dacă modificările sunt de natură nerespectabilă, versiunea API va rămâne aceeași, iar versiunea PowerShell va primi un increment de versiune minoră. Dacă modificările au o natură de rupere, Microsoft va incrementa 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ă câteva exemple de modificări nerespectabile:
- 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 |
|---|---|---|---|---|
| 2022-01-03-versiune preliminară | Versiune preliminară publică | 2022-03-01-preview Ref | Nedisponibil | Nedisponibil |
| 2020-10-01 | General disponibil | 2020-10-01 Ref | 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 va fi disponibilă în versiunile mai noi ale Power Platform API, împreună cu multe funcții 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.