Podeli preko


Kreiranje verzija i podrška

Ovaj članak pruža pregled verzija i kršenja smernica promena za različite alate za programiranje.

Podrška i informacije o zastarelosti

Kada se objavi nova verzija REST API-ja, starije verzije se povlače. Microsoft objavljuje da verzija nije odobrena najmanje 12 meseci pre nego što povuče API krajnje tačke. Kada verzija nije odobrena, podržana je u as-is. Ako se suočite sa problemom sa tom verzijom, zahtevamo da pređete na trenutno pouzdanu verziju. Kada se verzija povuče, ona nije podržana i uskoro će biti isključena.

Povećanjem broja verzije API-ja (na primer, od 2021-10-01 do 2022-04-01), Microsoft objavljuje da je prethodna opšte dostupna verzija (u ovom primeru, 2021-10-01) odmah zastarela i da će biti povučena 12 meseci nakon objave. Isti tretman se odvija i za verzije javnog pregleda. Microsoft može napraviti izuzetke od ove politike za zdravstvena i bezbednosna pitanja.

Različite alatke i SDK-ove koji se generišu na osnovu Power Platform API-ja, kao što su Power Platform CLI, Admin V2 konektor i PowerShell, ažuriraju se na novije API verzije na osnovu radnje i transparentne su krajnjim korisnicima.

Kompatibilne i prelomne promene

Microsoft pruža detalje o promenama programiranje u planovima izdanja. Ako se promene u prirodi ne prelamaju, API verzija ostaje ista, a PowerShell verzija prima inkrement međuverzija. Ako se promene u prirodi lome, Microsoft povećara API verziju i glavnu verziju programa PowerShell.

Evo primera prelomnih promena:

  • URL ili osnovni zahtev / odgovor se menjaju.
  • Deklarisano svojstvo se uklanja ili preimenuje ili se menja njegov tip.
  • API ili API parametri se uklanjaju ili preimenuju.
  • Dodaje se obavezni parametar zahteva.

Evo primera promena koje se ne mogu prelomiti:

  • Dodaju se svojstva koja se mogu poništiti ili imaju podrazumevanu vrednost.
  • Član se dodaje nabrajanju.
  • Paginacija se uvodi u postojeće kolekcije.
  • Šifre grešaka se menjaju.
  • Redosled svojstava u zahtevima ili odgovorima se menja.

Dostupne verzije

Verzija Tip Referenca Datum zastarevanja Datum prekida upotrebe
2024-10-01 Stabilan Referenca Nije primenjivo Nije primenjivo
1.03.2022-03-verzija za pregled Verzija za javni pregled 2022-03-01-pregled Ref 2025-03-01 2026-03-01
01.10.2020. Opšte dostupno 2020-10-01 Ref Nije primenjivo Nije primenjivo

Belešku

Opšte dostupna verzija 2020-10-01 Power Platform API-ja je specifična za upravljanje okruženjem i obično se naziva API platforme za poslovne aplikacije (BAP). Funkcionalnost ovog skupa krajnjih tačaka dostupna je u novijim verzijama Power Platform API-ja zajedno sa mnogim dodatnim funkcijama posle verzije 2022-03-01-preview.

Sledeći koraci

Sada kada razumete strategiju izrade verzija i podrške, prođimo kroz postupak potvrde identiteta pomoću Microsoft Power Platform API-ja.