Sürüm oluşturma ve destek

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. 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.

Available versions

Version Type Reference Deprecation date Decommission date
2024-10-01 Stable Reference N/A N/A
2020-10-01 Generally available 2020-10-01 Ref N/A N/A

Note

2020-10-01 tarihli genel erişilebilir Power Platform API sürümü, çevre yönetimine özgüdür ve genellikle İş Uygulama Platformu (BAP) API'si olarak da adlandırılır. Bu uç nokta setinin işlevselliği, Power Platform API'nin yeni sürümlerinde sunulmaktadır.

Next steps

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.

  • Last updated on