Versioiden hallinta ja tuki
Tässä artikkelissa on yleiskatsaus eri ohjelmoitavuustyökalujen versioiden hallinnasta ja uusien muutosten käytännöistä.
Tuen ja vanhentumisen tiedot
Power Platform -ohjelmointirajapinta on ensimmäinen ohjelmoitavuustyökalu, jolla voi vastaanottaa uusia versioita ja ominaisuuksia ennen muita SDK-paketteja, kuten PowerShelliä, Management Connectoria ja Power Platform CLI:tä. Kun uusi REST API -versio julkaistaan, aiemmat versiot vanhentuvat. Microsoft ilmoittaa version vanhentuneeksi vähintään 12 kuukautta ennen kuin se poistaa API-päätepiste käytöstä. Kun versio on vanhentunut, sitä tuetaan edelleen sellaisenaan. Jos kyseisessä versiossa on ongelmia, pyydämme, että siirryt yleisesti saatavilla olevaan versioon. Kun versio on poistettu, sitä ei tueta, ja se suljetaan pian.
Kasvattamalla ohjelmointirajapinnan versionumeron (esimerkiksi 2021-10-01:stä 2022-04-01:een) ilmoitetaan, Microsoft että aiempi yleisesti saatavilla oleva versio (tässä esimerkissä 2021-10-01) vanhenee välittömästi ja poistetaan käytöstä 12 kuukauden kuluttua ilmoituksesta. Sama koskee julkisia esiversioita. Microsoft saattaa tehdä poikkeuksia tähän käytäntöön palvelun kuntoon ja turvallisuuteen liittyvissä asioissa.
PowerShellin cmdlet-komentojen lisäävät versiot ovat käytettävissä pieniä ohjelmavirheiden korjauksia varten. Pääversiot kasvatetaan uusien API-versioiden mukaan.
Yhteensopivuus ja version muutokset
Microsoft antaa yksityiskohtaiset tiedot ohjelmoitavuuden muutoksista julkaisusuunnitelmissa. Jos muutokset eivät muuta versiota, ohjelmointirajapinnan versio säilyy samana ja PowerShellin versiota suurennetaan vähän. Jos muutokset ovat luonteeltaan rikkovia, Microsoft ne lisäävät API-versiota ja PowerShell-pääversiota.
Seuraavassa on esimerkkejä versioon vaikuttavista muutoksista:
- URL-osoitetta tai peruspyyntöä tai -vastausta muutetaan.
- Uusi ilmoitettu ominaisuus poistetaan, nimetään uudelleen tai sen tyyppiä muutetaan.
- Ohjelmointirajapinta tai ohjelmointirajapinnan parametrit poistetaan tai nimetään uudelleen.
- Pakollinen pyynnön parametri lisätään.
Seuraavassa on esimerkkejä muista versioon vaikuttavista muutoksista:
- Lisättävissä ominaisuuksissa on tyhjä arvo tai oletusarvo.
- Jäsen lisätään luettelointiin.
- Aiemmin luotujen kokoelmien sivutus on otettu käyttöön.
- Virhekoodeja muutetaan.
- Pyyntöjen tai vastausten ominaisuuksien järjestystä muutetaan.
Käytettävissä olevat versiot
| Versio | Type | Viittaus | Vanhentumispäivämäärä | Käytön lopettamisen päivämäärä |
|---|---|---|---|---|
| 2022-03-01-preview | Julkinen esiversio | 2022-03-01-esikatselu Viite | – | – |
| 1.10.2020 | Yleensä käytettävissä | 2020-10-01 Viite | – | – |
Muistiinpano
Power Platform -ohjelmointirajapinnan yleisesti saatavilla oleva 2020-10-01-versio liittyy ympäristön hallintaan ja sitä kutsutaan myös BAP (Business Application Platform) -ohjelmointirajapinnaksi. Tämän päätepistejoukon toiminnot ovat käytettävissä uusissa Power Platform API -versioissa sekä monia lisäominaisuuksia 2022-03-01-preview-version jälkeen.
Seuraavat vaiheet
Nyt, kun versioinnin hallinta ja tukistrategia on tuttu, käydään läpi Microsoft Power Platform API:n todentaminen.