Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Artikel ini menyediakan gambaran umum tentang kebijakan perubahan penerapan versi dan pelanggaran untuk berbagai alat programabilitas.
Informasi dukungan deprekasi
Saat versi baru REST API dirilis, versi sebelumnya dihentikan. Microsoft menyatakan versi tidak digunakan lagi setidaknya 12 bulan sebelum menghentikan titik akhir API. Saat versi tidak digunakan lagi, versi didukung as-is. Jika Anda menghadapi masalah dengan versi tersebut, kami meminta Anda pindah ke versi yang saat ini stabil. Ketika versi dihentikan, versi tidak didukung dan akan segera dimatikan.
Dengan meningkatkan 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) segera tidak digunakan lagi dan akan dihentikan 12 bulan setelah pengumuman. Perawatan yang sama dilakukan untuk versi pratinjau umum. Microsoft mungkin membuat pengecualian untuk kebijakan ini untuk masalah kesehatan dan keamanan layanan.
Berbagai alat dan SDK yang dihasilkan di atas Power Platform API seperti Power Platform CLI, konektor Admin V2, dan PowerShell, diperbarui ke versi API yang lebih baru berdasarkan per tindakan dan transparan bagi pengguna akhir.
Perubahan yang kompatibel dan melanggar
Microsoft menyediakan detail perubahan keterprograman dalam rencana rilis. Jika perubahan bersifat tidak pecah, versi API tetap sama, dan versi PowerShell menerima kenaikan versi minor. Jika perubahan bersifat melanggar, Microsoft meningkatkan 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 pecah:
- 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 |
|---|---|---|---|---|
| 2024-10-01 | Stabil | Referensi | Tidak Tersedia | Tidak Tersedia |
| 2022-03-01-pratinjau | Pratinjau umum | 2022-03-01-pratinjau ref | 2025-03-01 | 2026-03-01 |
| 2020-10-01 | Tersedia secara umum | 2020-10-01 Referensi | 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). Fungsionalitas set titik akhir ini tersedia di versi API Power Platform yang lebih baru bersama dengan banyak fitur tambahan setelah pratinjau versi 2022-03-01.
Langkah berikutnya
Setelah Anda memahami strategi penerapan versi dan dukungan, mari kita telusuri cara mengautentikasi dengan API Microsoft Power Platform.