Azure Blueprints kullanarak hataları giderme

Önemli

Azure Blueprints (Önizleme) 31 Ocak 2027'de kullanımdan kaldırılacak ve 31 Temmuz 2026'da aşamalı kullanımdan kaldırılacaktır. Mevcut şema tanımlarınızı ve atamalarınızı Dağıtım Yığınlarına (önerilen) ve Şablon Belirtimlerine geçirin. Şema yapıtları, dağıtım yığınlarını tanımlamak için kullanılan ARM JSON şablonlarına veya Bicep dosyalarına dönüştürülür. Aşamalı zaman çizelgesinin tamamı, etkiler ve SSS için Azure Blueprints'in kullanımdan kaldırılması sayfasına veya https://aka.ms/AzureBlueprintsRetirement bakın. Bir yapıtı ARM kaynağı olarak yazmayı öğrenmek için bkz:

• İlke
• RBAC
• Dağıtımlar

Ş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 taslağın bir kapsama atanmasından kaynaklanır. 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. Blueprints’i 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.

Hatanın, taslağın bütününden değil bir artefakttan kaynaklanması yaygındı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ılmış alanları ayarlıyor (etiketlerde yaygın olduğu gibi)

Çö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, blueprint parametresinin [[resourceGroup().tags.myTag] gibi görünmesi amacıyla dizenin tamamını [ ile kaçışlayı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.

Hataları sil

Senaryo: Atama silme zaman aşımı

Sorun

Şema atamasının silinmesi tamamlanmadı.

Neden

Blueprint ataması silindiğinde sonlanmamış bir durumda takılı kalabilir. Ş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, Azure destek talebi oluşturabilirsiniz. Azure destek sitesine gidin ve Destek Al seçeneğini belirleyin.