Penerapan versi dan dukungan
Artikel ini menyediakan gambaran umum tentang kebijakan perubahan penerapan versi dan pelanggaran untuk berbagai alat programabilitas.
Informasi dukungan deprekasi
API Power Platform adalah alat keterprograman pertama yang menerima versi dan fitur baru sebelum SDK lainnya seperti PowerShell, Konektor Manajemen, dan CLI Power Platform. Saat versi baru REST API dirilis, versi sebelumnya akan dihentikan. Microsoft akan mendeklarasikan versi yang tidak digunakan lagi setidaknya 12 bulan sebelum menghentikan titik akhir API. Bila versi tidak digunakan lagi, versi tersebut masih didukung sebagaimana adanya. Jika Anda mengalami masalah dengan versi tersebut, kami akan meminta Anda beralih ke versi yang tersedia secara umum. Bila versi dihentikan, versi tersebut tidak didukung dan akan segera dimatikan.
Dengan menambahkan nomor versi API (misalnya, dari 2021-10-01 ke 2022-04-01), Microsoft mengumumkan bahwa versi yang tersedia secara umum sebelumnya (dalam contoh ini, 2021-10-01) akan segera tidak digunakan lagi dan akan dihentikan 12 bulan setelah pengumuman. Perawatan yang sama dilakukan untuk versi pratinjau umum. Microsoft mungkin membuat pengecualian pada kebijakan ini untuk masalah kondisi dan keamanan layanan.
Untuk cmdlet PowerShell, versi inkremental akan tersedia untuk menyelesaikan perbaikan bug kecil. Versi utama akan ditambahkan agar sesuai dengan versi API baru yang terjadi.
Perubahan yang kompatibel dan melanggar
Microsoft akan memberikan detail perubahan programabilitas dalam paket rilis. Jika perubahan tidak bersifat melanggar, versi API akan tetap sama, dan versi PowerShell akan menerima kenaikan versi minor. Jika perubahan tersebut bersifat melanggar, Microsoft akan membuat versi API dan versi utama PowerShell.
Berikut adalah contoh perubahan yang melanggar:
- URL atau permintaan/respons dasar diubah.
- Properti yang dinyatakan dihapus atau diganti namanya, atau tipenya diubah.
- Parameter API atau API dihapus atau diganti namanya.
- Parameter permintaan yang diperlukan ditambahkan.
Berikut adalah contoh perubahan yang tidak melanggar:
- Properti ditambahkan yang dapat dibatalkan atau memiliki nilai default.
- Anggota ditambahkan ke sebuah enumerasi.
- Paging diperkenalkan dengan koleksi yang ada.
- Kode kesalahan diubah.
- Urutan properti dalam permintaan atau respons diubah.
Versi tersedia
| Versi | Tipe | Referensi | Tanggal deprekasi | Tanggal penghentian |
|---|---|---|---|---|
| 2022-03-01-pratinjau | Pratinjau umum | 2022-03-01-preview Ref | Tidak Tersedia | Tidak Tersedia |
| 2020-10-01 | Tersedia secara umum | 01-10-2020 Ref | Tidak Tersedia | Tidak Tersedia |
Catatan
Versi yang tersedia umum API Power Platform 2020-10-01 spesifik untuk manajemen lingkungan dan juga secara umum dirujuk sebagai API Platform Aplikasi Bisnis (BAP). Fungsi rangkaian titik akhir ini akan tersedia di versi API Power Platform yang lebih baru berserta banyak fitur tambahan setelah versi 2022-03-01-preview.
Langkah berikutnya
Setelah Anda memahami strategi penerapan versi dan dukungan, mari kita telusuri cara mengautentikasi dengan API Microsoft Power Platform.