Sürüm oluşturma ve destek

  • Makale

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

Power Platform API'si; PowerShell, yönetim bağlayıcıları ve Power Platform CLI gibi diğer SDK'lardan önce yeni sürümleri ve özellikleri alacak ilk programlanabilirlik aracıdır. REST API'nin yeni sürümü yayımlandıkça önceki sürümler devre dışı bırakılacaktır. Microsoft, bir API uç noktasını kullanımdan kaldırmadan en az 12 ay önce bir sürümün kullanım dışı bırakılacağını bildirecektir. Bir sürüm kullanım dışı bırakıldığında, olduğu gibi desteklenmeye devam eder. Bu sürümle ilgili bir sorun yaşarsanız o anda genel kullanıma açık olan sürüme geçmeniz istenir. Bir sürüm devre dışı olduğunda desteklenmez ve yakında sonlandırılır.

Microsoft, API'nin sürüm numarasını artırarak (örneğin, 2021-10-01'den 2022-04-01'e) önceki genel kullanıma açık sürümün (bu örnekte, 2021-10-01) hemen kullanım dışı bırakılacağını ve duyurudan 12 ay sonra devre dışı bırakılacağını bildirir. Aynı işlem, genel önizleme sürümleri için de geçerlidir. Microsoft, hizmet durumu ve güvenlik sorunları için bu ilkede istisnalara yer verebilir.

PowerShell cmdlet'leri için, önemsiz hata düzeltmelerini çözmek için artımlı sürümler kullanıma sunulacaktır. Ana sürümler, oluşan yeni API sürümleriyle eşleşecek şekilde artırılır.

Uyumlu ve hataya neden olan değişiklikler

Microsoft, sürüm planlarında programlanabilirlik değişiklikleriyle ilgili ayrıntıları sunacaktır. Değişiklikler yapısı gereği hataya neden olmuyorsa API sürümü, aynı kalacaktır ve PowerShell sürümünde küçük bir sürüm artımı gerçekleşecektir. Değişiklikler yapısı gereği hataya neden oluyorsa Microsoft, API sürümünü ve PowerShell ana sürümünü artıracaktı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.

Hataya neden olmayan değişikliklerin örneklerini aşağıda görebilirsiniz:

  • 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
2022-03-01-önizleme Genel önizleme 2022-03-01-önizleme Ref Geçersiz Geçersiz
01.10.2020 Genel kullanıma sunuldu 01.10.2020 Ref 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, sürüm 2022-03-01 önizlemesinin ardından birçok ek özellikle birlikte Power Platform API'sinin daha yeni sürümlerinde kullanıma sunulacaktır.

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.