Aracılığıyla paylaş


Azure Blueprints kullanarak hataları giderme

Önemli

11 Temmuz 2026'da Blueprints (Önizleme) kullanım dışı bırakılacaktır. Mevcut şema tanımlarınızı ve atamalarınızı Şablon Özellikleri ve Dağıtım Yığınları'na geçirin. Şema yapıtları ARM JSON şablonlarına veya dağıtım yığınlarını tanımlamak için kullanılan Bicep dosyalarına dönüştürülecek. Bir yapıtı ARM kaynağı olarak yazmayı öğrenmek için bkz:

Şema oluştururken, atarken veya kaldırırken hatalarla karşılaşabilirsiniz. Bu makalede oluşabilecek çeşitli hatalar ve bunların nasıl çözülebileceği açıklanmaktadır.

Hata ayrıntılarını bulma

Birçok hata, bir kapsama şema atamanın sonucunda ortaya çıkar. Bir atama başarısız olduğunda şema, başarısız dağıtımla ilgili ayrıntıları sağlar. Bu bilgiler sorunu gösterir ve sorunlar düzeltildiğinde bir sonraki dağıtım başarılı olur.

  1. Sol bölmede Tüm hizmetler'i seçin. Şemalar’ı arayıp seçin.

  2. Soldaki sayfadan Atanan şemalar’ı seçin ve başarısız atamayı bulmak için şema atamalarını filtrelemek üzere arama kutusunu kullanın. Tüm başarısız atamaları birlikte gruplandırmak için atama tablosunu Sağlama Durumu sütununa göre de sıralayabilirsiniz.

  3. Başarısız durumu olan şemayı seçin veya sağ tıklayın ve Atama ayrıntılarını görüntüle'yi seçin.

  4. Şema atama sayfasının üst kısmında atamanın başarısız olduğuna ilişkin kırmızı renkli uyarı yer alır. Daha fazla ayrıntı almak için başlıkta herhangi bir yeri seçin.

Hatalar genellikle şemanın kendisinden değil içindeki bir yapıttan kaynaklanır. Yapıt bir anahtar kasası oluşturuyorsa ve Azure İlkesi anahtar kasası oluşturulmasını engelliyorsa atamanın tamamı başarısız olur.

Genel hatalar

Senaryo: İlke İhlali

Sorun

İlke ihlali nedeniyle şablon dağıtımı başarısız oldu.

Neden

İlke aşağıdaki nedenlerle dağıtımla çakışabilir:

  • Oluşturulan kaynak ilkeyle kısıtlandı (genellikle SKU veya konum kısıtlamaları)
  • Dağıtım, ilke tarafından yapılandırılan alanlar ayarlanıyor (etiketlerle ortaktır)

Çözüm

Şemayı, hata ayrıntılarındaki ilkelerle çakışmaması için değiştirin. Bu değişiklik mümkün değilse alternatif bir seçenek, ilke atamasının kapsamının değiştirilerek şemanın ilkeyle çakışmamasıdır.

Senaryo: Şema parametresi bir işlevdir

Sorun

İşlev olan şema parametreleri yapıtlara geçirilmeden önce işlenir.

Neden

gibi [resourceGroup().tags.myTag]bir işlevi kullanan bir şema parametresinin yapıta geçirilmesi, dinamik işlev yerine yapıt üzerinde ayarlanan işlevin işlenmiş sonucuna neden olur.

Çözüm

bir işlevi parametre olarak geçirmek için, şema parametresi gibi [[resourceGroup().tags.myTag]görünecek şekilde dizenin [ tamamından kaçış yapın. Kaçış karakteri Blueprints'in şemayı işlerken değeri dize olarak işlemesine neden olur. Blueprints hizmeti daha sonra işlevi yapıta yerleştirerek beklendiği gibi dinamik olmasını sağlar. Daha fazla bilgi için bkz . Azure Resource Manager şablonlarında söz dizimi ve ifadeler.

Silme hataları

Senaryo: Atama silme zaman aşımı

Sorun

Şema atamasının silinmesi tamamlanmadı.

Neden

Şema ataması silindiğinde terminal dışı bir durumda takılabilir. Şema ataması tarafından oluşturulan kaynaklar hala silinmeyi bekliyorsa veya Azure Blueprints'e durum kodu döndürmediğinde bu durum oluşur.

Çözüm

Terminal dışı durumdaki şema atamaları, altı saatlik zaman aşımının ardından otomatik olarak Başarısız olarak işaretlenir. Zaman aşımı şema atamasının durumunu ayarladıktan sonra silme işlemi yeniden denenebilir.

Sonraki adımlar

Sorununuzu görmediyseniz veya sorununuzu çözemiyorsanız daha fazla destek için aşağıdaki kanallardan birini ziyaret edin:

  • Azure Forumları aracılığıyla Azure uzmanlarından yanıt alın.
  • @AzureSupport ile bağlantı kurun: Azure topluluğunun doğru kaynaklara bağlanmasını sağlayarak müşteri deneyimini geliştirmeye yönelik resmi Microsoft Azure hesabı: yanıtlar, destek ve uzmanlar.
  • Daha fazla yardıma ihtiyacınız varsa bir Azure desteği olayı oluşturabilirsiniz. Azure desteği sitesine gidin ve Destek Al'ı seçin.