Azure kaynak dağıtımı Azure Resource Manager şablonları (ARM şablonları) veya Bicep dosyaları kullanılarak başarısız olduğunda bir hata kodu alınır. Bu makalede, sorunu giderebilmeniz için hata kodlarının nasıl bulunabileceği açıklanır. Hata kodları hakkında daha fazla bilgi için bkz. yaygın dağıtım hataları.
Hata türleri
Bir dağıtımla ilgili üçi tür hata vardır:
Doğrulama hataları dağıtım başlamadan önce oluşur ve dosyanızdaki söz dizimi hatalarının neden olduğu durumlardır. Visual Studio Code gibi bir kod düzenleyicisi bu hataları belirleyebilir.
Dağıtım komutu çalıştırıldığında ancak kaynaklar dağıtılmadığında denetim öncesi doğrulama hataları oluşur. Bu hatalar dağıtım başlatılmadan bulunur. Örneğin, bir parametre değeri yanlışsa, hata denetim öncesi doğrulamada bulunur.
Dağıtım hataları dağıtım işlemi sırasında oluşur ve yalnızca Azure ortamınızdaki dağıtımın ilerleme durumu değerlendirilerek bulunabilir.
Tüm hata türleri dağıtım sorunlarını gidermek için kullanabileceğiniz bir hata kodu döndürür. Doğrulama ve denetim öncesi hataları etkinlik günlüğünde gösterilir ancak dağıtım geçmişinizde görünmez. Söz dizimi hataları içeren bir Bicep dosyası JSON'da derlenemez ve etkinlik günlüğünde gösterilmez.
Şablonlar dağıtım işlemi sırasında doğrulanır ve hata kodları görüntülenir. Dağıtımı çalıştırmadan önce doğrulama testlerini Azure PowerShell veya Azure CLI ile çalıştırarak doğrulama ve denetim öncesi hatalarını belirleyebilirsiniz.
ARM şablonu portaldan dağıtılabilir. Şablonda söz dizimi hataları varsa, dağıtımı çalıştırmayı denediğinizde bir doğrulama hatası görürsünüz. Portal dağıtımları hakkında daha fazla bilgi için bkz. Kaynakları özel şablondan dağıtma.
Aşağıdaki örnek bir depolama hesabı dağıtmayı dener ve doğrulama hatası oluşur.
Ayrıntıları görmek için hatayı seçin. Şablonda hata koduyla InvalidTemplatebir söz dizimi hatası var. Özet, bir ifadede kapatma parantezinin eksik olduğunu gösterir.
Çıkışta, şablonun sorunlarını gidermek ve düzeltmek için kullanabileceğiniz veya AccountNameInvalid gibi InvalidTemplateDeployment hata kodları görüntülenir.
Bicep dosyası için söz dizimi doğrulama sorununun çıktısı parametre hatası gösterir.
Test-AzResourceGroupDeployment: Cannot retrieve the dynamic parameters for the cmdlet.
Cannot find path '/tmp/11111111-1111-1111-1111-111111111111/main.json' because it does not exist.
Daha fazla sorun giderme bilgisi almak için Bicep derleme komutunu kullanın. Çıkışta her hatanın satır ve sütun numarası parantez içinde ve hata iletisi gösterilir.
bicep build main.bicep
/azuredeploy.bicep(22,51) : Error BCP064: Found unexpected tokens in interpolated expression.
/azuredeploy.bicep(22,51) : Error BCP004: The string at this location is not terminated due to an
unexpected new line character.
Diğer kapsamlar
Abonelik, yönetim grubu ve kiracı kapsamları için dağıtım şablonlarını doğrulamak için Azure PowerShell cmdlet'ler vardır.
az deployment group validate \
--resource-group examplegroup \
--template-file azuredeploy.json
Çıkışta, şablonun sorunlarını gidermek ve düzeltmek için kullanabileceğiniz veya AccountNameInvalid gibi InvalidTemplateDeployment hata kodları görüntülenir.
Bir Bicep dosyası için çıkış, her hatanın satır ve sütun numarasını parantez içinde ve hata iletisini gösterir.
az deployment group validate \
--resource-group examplegroup \
--template-file main.bicep
/azuredeploy.bicep(22,51) : Error BCP064: Found unexpected tokens in interpolated expression.
/azuredeploy.bicep(22,51) : Error BCP004: The string at this location is not terminated due to an
unexpected new line character.
Diğer kapsamlar
Abonelik, yönetim grubu ve kiracı kapsamları için dağıtım şablonlarını doğrulamaya yönelik Azure CLI komutları vardır.
Bir Azure kaynağını dağıtmak için çeşitli işlemler işlenir. Bir işlem doğrulamayı geçtiğinde ancak dağıtım sırasında başarısız olduğunda dağıtım hataları oluşur. Bir kaynak grubu için her dağıtım işlemi ve her dağıtım hakkındaki iletileri görüntüleyebilirsiniz.
