Ambil perhatian
Akses ke halaman ini memerlukan kebenaran. Anda boleh cuba log masuk atau menukar direktori.
Akses ke halaman ini memerlukan kebenaran. Anda boleh cuba menukar direktori.
Artikel ini memberikan gambaran keseluruhan tentang dasar perubahan pemversian dan pemisah untuk pelbagai alatan kebolehaturcaraan.
Maklumat sokongan dan penamatan
Apabila versi baharu API REST dikeluarkan, versi terdahulu akan ditamatkan. Microsoft mengisytiharkan versi ditamatkan sekurang-kurangnya 12 bulan sebelum ia bersara titik akhir API. Apabila versi ditamatkan, ia disokong as-is. Jika anda menghadapi masalah dengan versi tersebut, kami meminta anda beralih kepada versi yang stabil pada masa ini. Apabila versi ditamatkan, ia tidak disokong dan tidak lama lagi akan dimatikan.
Dengan menaikkan nombor versi API (contohnya, daripada 2021-10-01 kepada 2022-04-01), Microsoft mengumumkan bahawa versi yang tersedia secara umum sebelumnya (dalam contoh ini, 2021-10-01) ditamatkan serta-merta dan akan ditamatkan 12 bulan selepas pengumuman. Layanan sama adalah untuk versi pratonton awam. Microsoft mungkin membuat pengecualian kepada dasar ini untuk isu kesihatan dan keselamatan perkhidmatan.
Pelbagai alatan dan SDK yang dijana di atas API Power Platform seperti CLI Power Platform, penyambung Pentadbir V2 dan PowerShell, dikemas kini kepada versi API yang lebih baharu berdasarkan setiap tindakan dan telus kepada pengguna akhir.
Perubahan yang serasi dan pemisah
Microsoft menyediakan butiran perubahan kebolehaturcaraan dalam pelan keluaran. Jika perubahan tidak bersifat pecah, versi API kekal sama dan versi PowerShell menerima kenaikan versi kecil. Jika perubahan bersifat pecah, Microsoft menambah versi API dan versi utama PowerShell.
Berikut ialah contoh perubahan pemisah:
- URL atau permintaan/respons asas ditukar.
- Sifat yang diisytiharkan telah dialih keluar atau dinamakan semula atau jenisnya ditukar.
- API atau parameter API telah dialih keluar atau dinamakan semula.
- Parameter permintaan yang diperlukan ditambahkan.
Berikut ialah contoh perubahan yang tidak berputus:
- Sifat ditambah yang boleh nol atau mempunyai nilai lalai.
- Ahli ditambahkan pada penyenaraian.
- Penghalaman diperkenalkan untuk koleksi sedia ada.
- Kod ralat ditukar.
- Susunan untuk sifat dalam permintaan atau respons ditukar.
Versi tersedia
| Versi | Jenis | Rujukan | Tarikh penamatan | Tarikh Penutupan |
|---|---|---|---|---|
| 2024-10-01 | Stabil | Rujukan | T/B | T/B |
| 2022-03-01-pratonton | Pratonton awam | 2022-03-01-pratonton rujukan | 2025-03-01 | 2026-03-01 |
| 01-10-2020 | Tersedia secara umum | 2020-10-01 Rujukan | T/B | T/B |
Nota
Versi API Power Platform tersedia secara am 01-10-2020 adalah khusus untuk pengurusan persekitaran dan juga biasanya dirujuk sebagai API Platform Aplikasi Perniagaam (BAP). Kefungsian set titik akhir ini disediakan dalam versi API Power Platform yang lebih baharu bersama-sama dengan banyak ciri tambahan selepas pratonton versi 2022-03-01.
Langkah-langkah berikutnya
Sekarang, anda memahami strategi pemversian dan sokongan, mari lihat cara pengesahan dengan API Microsoft Power Platform.