Aracılığıyla paylaş

Çalışma alanı büyük değişiklikler, bölüm 2 (Mart 2025)

ŞUNLARA UYGULANIR: Premium

Önemli

Ağustos 2025'te, bu makalede açıklanan çalışma alanlarıyla ilgili bazı hataya neden olan değişikliklerin yeniden kaldırıldığını duyurduk. Ayrıntılar için duyuruya bakın

Önemli

Bu köklü değişiklikler yalnızca Azure API Management'taki önizleme çalışma alanlarına uygulanır. Ağustos 2024'te genel kullanıma sunulan sürümden sonra çalışma alanları oluşturduysanız ve çalışma alanı ağ geçitleriyle çalışma alanlarını kullanıyorsanız, çalışma alanlarınız bu değişikliklerden etkilenmemelidir.

Azure API Management çalışma alanları genel kullanıma sunuldu ve bu sürümle birlikte birkaç özellik güncelleştirmesi kullanıma sunuldu. Çalışma alanlarının sürekli geliştirilmesi kapsamında önizleme çalışma alanları desteğini kaldırıyoruz (Ağustos 2024'den önce oluşturuldu). Azure API Management'ta önizleme çalışma alanları oluşturduysanız ve bunları kullanmaya devam etmek istiyorsanız, çalışma alanlarınızı genel kullanıma açık sürüme geçirmeniz gerekir.

31 Mart 2025'den sonra, en son çalışma alanı özelliklerine geçmediyseniz önizleme çalışma alanlarınız ve bunların içinde yönetilen API'ler çalışmayabilir. Çalışma alanları dışında yönetilen API'ler ve kaynaklar bu değişiklikten etkilenmez.

Hizmetim bu değişikliklerden etkilendi mi?

Api Management örneğinizde önizleme çalışma alanları oluşturduysanız, çalışma alanlarının Ağustos 2024'te genel kullanıma sunulmasından önce hizmetiniz bu değişikliklerden etkilenebilir. API çalışma zamanı için çalışma alanı ağ geçitlerini kullanan genel kullanıma sunulan yayın tarihinden sonra oluşturulan çalışma alanları, hataya neden olan değişikliklerden etkilenmez.

Hataya neden olan değişiklikler

Önizleme çalışma alanlarınızı genel kullanıma açık sürüme geçirmek için hareket etmenizi gerektiren önemli değişiklikler aşağıdadır:

  • Çalışma alanı API ağ geçidi gereklidir - Her çalışma alanı, çalışma alanının çalışma zamanı trafiğini yalıtan bir çalışma alanı API ağ geçidiyle ilişkilendirilmelidir. Önizleme modunda, çalışma alanları hizmetle bir ağ geçidi paylaştı.
  • Hizmet düzeyinde yönetilen kimlikler desteklenmez - Çalışma alanlarının güvenliğini geliştirmek için, hizmet düzeyinde etkinleştirilen sistem tarafından atanan ve kullanıcı tarafından atanan yönetilen kimlikler çalışma alanlarında kullanılamaz. Şu anda, yönetilen kimliklere bağımlı olan ilgili API Yönetimi özellikleri, çalışma alanlarında adlandırılmış değerleri ve sertifikaları Azure Key Vault'ta depolamak ile authentication-managed-identity ilkesini kullanmak desteklenmemektedir.

Not

Bu önemli değişiklikler, daha önce duyurulan önizleme çalışma alanları için Haziran 2024'teki önemli değişikliklere ek olarak yapılmıştır.

Değişiklik için son tarih nedir?

Bozucu değişiklikler 31 Mart 2025'ten sonra önizleme çalışma alanlarında uygulanacaktır. Bu tarihten önce önizleme çalışma alanlarınızın yapılandırmasında gerekli tüm değişiklikleri yapmanızı kesinlikle öneririz.

Ne yapmam gerekiyor?

Çalışma alanlarınız bu değişikliklerden etkileniyorsa, genel olarak mevcut olan yeteneklerle uyum sağlamak için çalışma alanlarınızı taşımanız gerekir. Aşağıdaki bölümler, çalışma alanlarınızı taşıma konusunda rehberlik eder.

API Management örneğinin Premium katmanını kullanma

Çalışma alanlarını kullanmaya devam etmek için API Management örneğinizin Premium katmanında çalıştığından emin olun. Daha önce duyurulmuş olduğu gibi, örneğiniz Standart veya Geliştirici katmanındaysa Premium katmanına yükseltmeniz gerekir.

Örneğinizin bölgesini onaylayın

Çalışma alanına çalışma alanı ağ geçidi eklemek için ağ geçidinin örneğiniz ile aynı bölgede olması gerekir. Şu anda çalışma alanı ağ geçitleri, API Management'ın kullanılabildiği bölgelerin bir alt kümesinde desteklenmektedir. Çalışma alanı ağ geçitleri desteğine sahip bölgeler zaman içinde güncelleştirilir.

Önizleme çalışma alanının desteklenen bir bölgede olup olmadığını belirlemek için:

  1. Azure portalında API Management örneğine gidin.
  2. Soldaki menüde, API'ler'in altında Çalışma Alanları'nı seçin ve bir çalışma alanı seçin.
  3. Çalışma alanınız çalışma alanı ağ geçitlerini desteklemeyen bir bölgedeyse portalda "Api Management hizmetinizin bölgesinde çalışma alanları şu anda kullanılamıyor" gibi bir ileti görürsünüz.
    • Bu iletiyi görürseniz API Management örneğinizi desteklenen bir bölgeye taşıyabilirsiniz.
    • Bu iletiyi görmüyorsanız, çalışma alanınız desteklenen bir bölgededir ve çalışma alanı ağ geçidi eklemeye devam edebilirsiniz.

Çalışma alanınıza bir ağ geçidi ekleyin

Aşağıda, çalışma alanına çalışma alanı ağ geçidi eklemeye yönelik kısaltılmış adımlar verilmiştir. Ağ geçidi ağ seçenekleri, önkoşullar ve ayrıntılı yönergeler için Çalışma alanı oluşturma ve yönetme konusuna bakın.

Not

  • Çalışma alanı ağ geçidi ek ücrete tabi olur. Daha fazla bilgi için bkz . API Management fiyatlandırması.
  • Kuruluşların çalışma alanlarıyla API'leri daha düşük maliyetle yönetmesine yardımcı olmak için birden çok çalışma alanını bir çalışma alanı ağ geçidiyle ilişkilendirme özelliği sunuyoruz. Bu özellik Aralık 2024'te kullanıma sunulacaktır ve Ocak ayından önce tüm uygun hizmetler tarafından kullanılamayabilir. Daha fazla bilgi edinin
  1. Azure portalında API Management örneğine gidin.
  2. Soldaki menüde, API'ler'in altında Çalışma Alanları'nı seçin.
  3. Çalışma alanını seçme.
  4. Soldaki menüde, Dağıtım + altyapı altında Ağ Geçitleri
  5. Yeni bir ağ geçidi oluşturmak veya mevcut bir ağ geçidini ilişkilendirmek için sihirbazı tamamlayın. Şu anda yeni bir ağ geçidinin sağlanması birkaç dakika ile 3 saat veya daha uzun sürebilir.
  6. Ağ geçidi ekledikten sonra ağ geçidinin Genel Bakış sayfasına gidin. Çalışma zamanı konak adı değerini not edin. Çalışma alanınızın API'lerini çağıran istemci uygulamalarınızı güncelleştirmek için bu değeri kullanın.
  7. Kalan çalışma alanlarınız için önceki adımları yineleyin.

İstemci uygulamalarını yeni ağ geçidi ana bilgisayar adını kullanacak şekilde güncelleştirme

Çalışma alanınıza bir ağ geçidi ekledikten sonra, çalışma alanının API'lerini çağıran istemci uygulamalarınızı da, API Management örneğinizin ağ geçidi adı yerine, yeni ağ geçidi adını kullanacak şekilde güncelleştirmeniz gerekir.

Not

Çalışma alanlarınızı taşımanıza yardımcı olmak için, çalışma alanlarındaki API'lere Ekim 2024'e kadar, bir çalışma alanı ağ geçidi bir çalışma alanıyla ilişkilendirilmiş olsa bile, API Yönetimi örneğinizin ağ geçidi ana bilgisayar adı kullanılarak çalışma zamanında erişilebilir. Geçişi bu tarihten önce tamamlamanızı kesinlikle öneririz. Çalışma alanı ağ geçitleriniz özel gelen erişim ve özel giden erişimle yapılandırılmışsa, API Management örneğinizin yerleşik ağ geçidine bağlantının da güvenli olduğundan emin olun.

Hizmet düzeyinde yönetilen kimliklere bağımlılıkları güncelleştirme

Çalışma alanı varlıklarının (örneğin, adlandırılmış değerler veya sertifikalar) yapılandırmasında hizmet düzeyinde yönetilen kimlikler kullanıyorsanız yapılandırmaları güncelleştirmeniz gerekir. Önerilen adımlar varlığa bağlı olarak değişir. Örnek: Azure Key Vault'ta depolanan sırlar yerine gizli değerleri kullanmak için adlandırılmış değerleri güncelleştirin.

Yardım ve destek

Sorularınız varsa Microsoft Q&A'daki topluluk uzmanlarından yanıt alın. Destek planınız varsa ve teknik yardım almak istiyorsanız destek isteği oluşturun.

Daha Fazla Bilgi

İlgili içerik

Yaklaşan tüm hataya neden olan değişiklikleri ve özellik kullanımdan kaldırmaları görün.

  • Last updated on