Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Bu makalede, çeşitli programlanabilirlik araçları için sürüm oluşturma ve hataya neden olan değişiklik ilkelerine genel bakış sağlanmaktadır.
Destek ve kullanım dışı bırakma bilgileri
REST API'nin yeni bir sürümü yayımlandıkçe, önceki sürümler kullanımdan kaldırılır. Microsoft, BIR API uç noktasını kullanımdan kaldırmadan en az 12 ay önce kullanımdan kaldırılan bir sürüm bildirir. Bir sürüm kullanım dışı bırakıldığında as-isdesteklenir. Bu sürümle ilgili bir sorunla karşılaşırsanız, şu anda kararlı olan sürüme geçmenizi istiyoruz. Sürüm kullanımdan kaldırıldığında desteklenmez ve yakında kapatılır.
API'nin sürüm numarasını artırarak (örneğin, 2021-10-01'dan 2022-04-01'ye), Microsoft genel olarak kullanılabilen önceki sürümün (bu örnekte 2021-10-01) hemen kullanımdan kaldırıldığını ve duyurudan 12 ay sonra kullanımdan kaldırılacağını duyurur. Aynı işlem, genel önizleme sürümleri için de geçerlidir. Microsoft hizmet durumu ve güvenlik sorunları için bu ilkede istisnalar yapabilir.
Power Platform CLI, Yönetici V2 bağlayıcısı ve PowerShell gibi Power Platform API'sinin üzerinde oluşturulan çeşitli araçlar ve SDK'lar, eylem temelinde daha yeni API sürümlerine güncelleştirilir ve son kullanıcılar için saydamdır.
Uyumlu ve hataya neden olan değişiklikler
Microsoft , yayın planlarındaki programlanabilirlik değişikliklerinin ayrıntılarını sağlar. Değişiklikler doğası gereği bölünemez durumdaysa API sürümü aynı kalır ve PowerShell sürümü küçük bir sürüm artışı alır. Değişiklikler doğası gereği bozuluyorsa, Microsoft API sürümünü ve PowerShell ana sürümünü artırır.
Hataya neden olan değişikliklerin örneklerini aşağıda görebilirsiniz:
- URL veya temel istek/yanıt değiştirildi.
- Bildirilmiş bir özellik kaldırılır veya yeniden adlandırılır veya türü değiştirilir.
- API veya API parametreleri kaldırılır veya yeniden adlandırılır.
- Gerekli istek parametresi eklenir.
Aşağıda, bölünemez değişikliklere örnekler verilmiştir:
- Null değeri alabilen veya varsayılan değeri olan özellikler eklenmiştir.
- Numaralandırmaya bir üye eklenmiştir.
- Mevcut koleksiyonlara sayfalandırma getirilmiştir.
- Hata kodları değiştirilmiştir.
- İsteklerdeki veya yanıtlardaki özelliklerin sırası değişmiştir.
Kullanılabilir sürümler
| Sürüm | Tür | Referans | Kullanım dışı bırakma tarihi | Hizmetten alma tarihi |
|---|---|---|---|---|
| 2024-10-01 | İstikrarlı | Referans | Geçersiz | Geçersiz |
| 2022-03-01-önizleme | Genel önizleme | 2022-03-01-önizleme Ref | 2025-03-01 | 2026-03-01 |
| 01.10.2020 | Genel kullanıma sunuldu | 2020-10-01 Referans | Geçersiz | Geçersiz |
Not
Power Platform'un 2020-10-01 genel olarak kullanılabilen API sürümü, ortam yönetimine özeldir ve genellikle Business Application Platform (BAP) API'si olarak da adlandırılır. Bu uç nokta kümesinin işlevselliği, Power Platform API'sinin daha yeni sürümlerinde ve 2022-03-01-preview sürümünden sonraki birçok ek özellikte kullanıma sunulmuştur.
Sonraki adımlar
Artık sürüm oluşturma ve destek stratejisini anladığınıza göre Microsoft Power Platform API'si ile kimlik doğrulaması yapmayı adım adım inceleyelim.