Azure Blueprints'i kullanırken karşılaşılan 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 Belirtimleri 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. 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.
Sol bölmede Tüm hizmetler'i seçin. Şemalar’ı arayıp seçin.
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.
Başarısız durumuna sahip şemayı seçin veya sağ tıklayıp Atama ayrıntılarını görüntüle'yi seçin.
Ş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.
Nedeni
İlke aşağıdaki nedenlerle dağıtımla çakışabilir:
- Oluşturulan kaynak ilke (genellikle SKU veya konum kısıtlamaları) ile kısıtlanmıştır
- Dağıtım, ilke tarafından yapılandırılan alanları ayarlar (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, şemanın artık ilkeyle çakışmaması için ilke atamasının kapsamının değiştirilmesi alternatif bir seçenektir.
Senaryo: Şema parametresi bir işlevdir
Sorun
İşlev olan şema parametreleri yapıtlara geçirilmeden önce işlenir.
Nedeni
gibi [resourceGroup().tags.myTag]bir işlevi kullanan bir şema parametresinin bir yapıta geçirilmesi, dinamik işlev yerine yapıt üzerinde ayarlanan işlevin işlenmiş sonucunun elde edilmesine 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. Ardından Blueprints hizmeti 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 tamamlanamadı.
Nedeni
Şema ataması silindiğinde terminal dışı bir durumda takılabilir. Şema ataması tarafından oluşturulan kaynaklar hala silinmeyi bekliyorsa veya Azure Blueprints'e bir 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 yanıtlar, destek ve uzmanlar gibi doğru kaynaklara bağlanmasını sağlayarak müşteri deneyimini geliştirmeye yönelik resmi Microsoft Azure hesabı.
- Daha fazla yardıma ihtiyacınız varsa bir Azure desteği olayı kaydedebilirsiniz. Azure desteği sitesine gidin ve Destek Al'ı seçin.