Share via


Çalışma alanları - hataya neden olan değişiklikler (Haziran 2024)

ŞUNLAR IÇIN GEÇERLIDIR: Geliştirici | Standart | Premium

14 Haziran 2024'ün ardından Azure API Management'ta çalışma alanları geliştirme (önizleme) kapsamında bazı hataya neden olan değişiklikler sunuyoruz.

14 Haziran 2024'te, çalışma alanlarınız ve bunların içinde yönetilen API'ler, hala değiştirilmeye ayarlanmış özelliklere güveniyorsa çalışmayı durdurabilir. Ç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 çalışma alanlarını (önizleme) yapılandırdıysanız hizmetiniz bu değişikliklerden etkilenebilir. Bu özellik Premium, Standart ve Geliştirici katmanlarında kullanıma sunulmuştur.

Hataya neden olan değişiklikler

Eyleme geçmeniz gerekip gerekmediğini belirlemek için aşağıdaki hataya neden olan değişiklikleri gözden geçirin:

Desteklenen hizmet katmanlarına değiştirme

Aşağıdaki hizmet katmanları artık çalışma alanlarını desteklemeyecektir: Standart ve Geliştirici. Çalışma alanları Premium katmanında kullanılabilir.

v2 katmanlarında kullanılabilirlik için bkz . Azure API Management v2 katmanları.

Çalışma alanlarında hizmet düzeyi varlıkları atama desteğinde yapılan değişiklikler

Çalışma alanı varlıklarının hizmet düzeyi varlıklara aşağıdaki atamaları artık desteklenmeyecektir:

  • Hizmet düzeyi ürünlere çalışma alanı API'leri atama

  • Hizmet düzeyi etiketlerine çalışma alanı API'leri atama

  • Çalışma alanı ürünlerini hizmet düzeyi etiketlerine atama

  • Görünürlük denetimleri için çalışma alanı ürünlerine hizmet düzeyi grupları atama

    Not

    Yerleşik Konuklar ve Geliştirici grupları çalışma alanlarında kullanılabilir olmaya devam edecektir.

Desteklenen bağlam nesnelerde yapılan değişiklikler

Aşağıdaki context nesneler artık çalışma alanı ilkelerinde veya hizmet düzeyindeki tüm API'ler ilkesinde desteklenmeyecektir:

  • context.Api.Workspace
  • context.Product.Workspace

Bunun context.Workspace yerine nesnesi kullanılabilir.

Not

Çalışma alanı düzeyinde ilkelerde nesnedeki hizmet düzeyinden kullanıcılara başvurmaya context devam edebilirsiniz.

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

Hataya neden olan değişiklikler 14 Haziran 2024'e kadar sunulacaktır. Bu tarihten önce çalışma alanlarını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, çalışma alanı yapılandırmalarınızı yeni özelliklerle uyumlu olacak şekilde güncelleştirmeniz gerekir.

Standart katman müşterileri

Standart katmanda çalışma alanları kullanıyorsanız, çalışma alanlarını kullanmaya devam etmek için Premium katmanına yükseltin.

Geliştirici katmanı müşterileri

Geliştirici katmanı, tek kullanıcılı veya tek ekipli kullanım örnekleri için tasarlanmıştır. Sınırlı bilgi işlem kaynakları, SLA eksikliği ve altyapı yedekliliği olmadığından çalışma alanlarıyla çok ekipli işbirliğini kolaylaştıramaz. Geliştirici katmanında çalışma alanları önizlemesini kullanıyorsanız aşağıdaki seçeneklerden birini belirleyebilirsiniz:

  • Premium katman örneğinde toplama

    Her Geliştirici katmanı örneğini Premium katmanına yükseltmek bir seçenek olsa da, tek bir Premium katman örneğinde birden çok üretim dışı ortamı toplamayı göz önünde bulundurun. Farklı ortamları yalıtmak için Premium katmanındaki çalışma alanlarını kullanın.

  • Geliştirme için Geliştirici katmanı örneklerini kullanın, üretim için Premium katmanda çalışma alanlarına geçiş yapın

    Geliştirme ortamları için Geliştirici katmanı örneklerini kullanabilirsiniz. Daha yüksek ortamlar için, ci/CD işlem hatlarını kullanarak her Geliştirici katmanı hizmetinin yapılandırmasını Premium katman hizmetinin çalışma alanına geçirebilirsiniz. Bu yaklaşımla, ortamlar arasında yapılandırmaları yönetirken sorunlarla veya çakışmalarla karşılaşabilirsiniz.

    Şu anda bir Geliştirici katmanı örneğinde çalışma alanları kullanıyorsanız, çalışma alanı yapılandırmalarını çalışma alanları olmayan bir Geliştirici katmanı örneğine geçirebilirsiniz:

    1. API Management örneğinizden bir Resource Manager şablonunu dışarı aktarın. Şablonu Azure portalından veya diğer araçları kullanarak dışarı aktarabilirsiniz.
    2. Kaynak kimliği değerlerinin aşağıdaki alt dizesini kaldırın: /workspaces/[^/]+
    3. Şablonu dağıtma. Daha fazla bilgi için bkz . Hızlı Başlangıç: Azure portalını kullanarak ARM şablonları oluşturma ve dağıtma.

    Kullanım örneğine bağlı olarak, API Management örneğinizde başka yapılandırma değişiklikleri yapmanız gerekebilir.

Çalışma alanı düzeyinde varlıkların atanma

Çalışma alanları önizlemesinde hizmet düzeyi varlıklara çalışma alanı düzeyinde varlıklar atadıysanız, geçiş kılavuzu için aşağıdaki tabloya bakın.

Atama artık desteklenmiyor Önerilen geçiş adımı
Hizmet düzeyi ürünlere çalışma alanı API'leri atama Çalışma alanı düzeyindeki ürünleri kullanma
Çalışma alanı API'lerini veya ürünlerini hizmet düzeyi etiketlerine atama Çalışma alanı düzeyinde etiketleri kullanma

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

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