Shranjevanje različic in podpora

Ta članek ponuja pregled pravilnikov za shranjevanje različic in predirajoče spremembe za različna orodja za programirljivost.

Informacije o podpori in zastaranju

Ko je izdana nova različica VMESNIKA API za REST, so starejše različice ukinjene. Microsoft napoveda, da je različica zastarela vsaj 12 mesecev, preden ukinja končno točko API. Ko je različica zastarela, je podprta v as-is. Če pride do težave s to različico, vas od vas zahtevamo, da se premaknete na trenutno stabilno različico. Ko je različica ukinjena, ni podprta in bo kmalu izklopljena.

S povečanjem številke različice API-ja (na primer iz 2021-10-01 v 2022-04-01) Microsoft naznani, da je prejšnja splošno razpoložljiva različica (v tem primeru 2021-10-01) takoj opuščena in bo ukinjena 12 mesecev po objavi. Microsoft lahko naredi izjeme od tega pravilnika za težave z zdravjem in varnostjo storitve.

Različna orodja in SDK-ji, ki so ustvarjeni na podlagi api-ja platforme Power Platform, kot so Power Platform CLI, priključek Admin V2 in PowerShell, so posodobljeni v novejše različice API-ja na osnovi dejanja in so pregledni za končne uporabnike.

Združljive in predirajoče spremembe

Microsoft ponuja podrobnosti o spremembah programljivosti v paketih izdaj. Če se spremembe po naravi ne prelomijo, različica API-ja ostane enaka in različica ogrodja PowerShell prejme korak podrazličice. Če so spremembe v naravi prelomne, Microsoft poveča različico API-ja in glavno različico ogrodja PowerShell.

Tukaj so primeri predirajočih sprememb:

  • URL ali osnovna zahteva/odziv se spremeni.
  • Deklarirana lastnost je odstranjena ali preimenovana ali je njena vrsta spremenjena.
  • API ali parametri API-ja so odstranjeni ali preimenovani.
  • Dodan je obvezen parameter zahteve.

Tukaj so primeri nedeljivih sprememb:

  • Dodane so lastnosti, ki so ničelne ali imajo privzeto vrednost.
  • V oštevilčenje je dodan član.
  • V obstoječe zbirke je uvedeno ostranjevanje.
  • Kode napak so spremenjene.
  • Vrstni red lastnosti v zahtevah ali odgovorih je spremenjen.

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

Splošno dostopna različica Power Platform API-ja 2020-10-01 je specifična za upravljanje okolja in se pogosto imenuje tudi API Business Application Platform (BAP). Funkcionalnost tega nabora končnih točk je na voljo v novejših različicah Power Platform API-ja.

Next steps

Zdaj ko razumete strategijo shranjevanja različic in podpore si oglejmo, kako izvesti preverjanje pristnosti z API-jem Microsoft Power Platform.

  • Last updated on