Hata kodlarını bulma

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ı bir 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ı tanımlayabilir.
• Dağıtım komutu çalıştırıldığında ancak kaynaklar dağıtılmadığında ön kontrol 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.

Söz dizimi hatalarını belirlemek için Visual Studio Code'un en son Bicep uzantısını veya Azure Resource Manager Araçları uzantısını kullanabilirsiniz.

Doğrulama hataları

Şablonlar dağıtım işlemi sırasında doğrulanır ve hata kodları görüntülenir. Bir 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.

Portal

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 ayracı eksik olduğunu gösterir.

PowerShell

Dağıtımdan önce arm şablonunu doğrulamak için Test-AzResourceGroupDeployment komutunu çalıştırın.

Test-AzResourceGroupDeployment `
  -ResourceGroupName examplegroup `
  -TemplateFile azuredeploy.json

Çıkışta, şablonun sorunlarını gidermek ve düzeltmek için kullanabileceğiniz veya InvalidTemplateDeployment gibi AccountNameInvalid hata kodları görüntülenir.

Bicep dosyası için söz dizimi doğrulama sorununun çıktısı bir 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ğrulamaya yönelik Azure PowerShell cmdlet'leri vardır.

Kapsam	Cmdlet'ler
Abonelik	Test-AzDeployment
Yönetim grubu	Test-AzManagementGroupDeployment
Kiracı	Test-AzTenantDeployment

Azure CLI

Dağıtımdan önce arm şablonunu doğrulamak için az deployment group validate komutunu çalıştırın.

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 InvalidTemplateDeployment gibi AccountNameInvalid hata kodları görüntülenir.

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.

Kapsam	Komutlar
Abonelik	az deployment sub validate
Yönetim grubu	az deployment MG verify
Kiracı	az deployment tenant validate

Dağıtım hataları

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.

Portal

Dağıtımın işlemleriyle ilgili iletileri görmek için kaynak grubunun Etkinlik günlüğünü kullanın:

1. Azure portalda oturum açın.

2. Kaynak grupları'na gidin ve dağıtımın kaynak grubu adını seçin.

3. Etkinlik günlüğü'nü seçin.

4. İşlemin hata günlüğünü bulmak için filtreleri kullanın.

   

5. İşlemin ayrıntılarını görmek için hata günlüğünü seçin.

   

Bir dağıtımın sonucunu görüntülemek için:

1. Kaynak grubuna gidin.

2. Ayarlar

3. Dağıtım için Hata ayrıntıları'nı seçin.

   

4. Hata iletisi ve hata kodu NoRegisteredProviderFound gösterilir.

   

PowerShell

PowerShell ile bir dağıtımın işlem iletilerini görmek için Get-AzResourceGroupDeploymentOperation komutunu kullanın.

Bir dağıtımın tüm işlemlerini göstermek için:

Get-AzResourceGroupDeploymentOperation `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup

Belirli bir özellik türünü belirtmek için:

(Get-AzResourceGroupDeploymentOperation `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup).StatusCode

Dağıtımın sonucunu almak için Get-AzResourceGroupDeployment komutunu kullanın.

Get-AzResourceGroupDeployment `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup

Diğer kapsamlar

Abonelik, yönetim grubu ve kiracı kapsamları için dağıtım bilgilerini almak için Azure PowerShell cmdlet'leri vardır.

Kapsam	Cmdlet'ler
Abonelik	Get-AzDeploymentOperation Get-AzDeployment
Yönetim grubu	Get-AzManagementGroupDeploymentOperation Get-AzManagementGroupDeployment komutunu çalıştırın
Kiracı	Get-AzTenantDeploymentOperation Get-AzTenantDeployment komutunu çalıştır.

Azure CLI

Azure CLI ile bir dağıtımın işlem iletilerini görmek için az deployment operation group list komutunu kullanın.

Bir dağıtımın tüm işlemlerini göstermek için:

az deployment operation group list \
  --name exampledeployment \
  --resource-group examplegroup \
  --query "[*].properties"

Belirli bir özellik türünü belirtmek için:

az deployment operation group list \
  --name exampledeployment \
  --resource-group examplegroup \
  --query "[*].properties.statusCode"

Bir dağıtımın sonucunu almak için az deployment group show komutunu kullanın.

az deployment group show \
  --resource-group examplegroup \
  --name exampledeployment

Diğer kapsamlar

Abonelik, yönetim grubu ve kiracı kapsamları için dağıtım bilgilerini almak için Azure CLI komutları vardır.

Kapsam	Komutlar
Abonelik	az dağıtım operasyon alt liste az deployment sub show (Azure dağıtımı alt komutunu göster)
Yönetim grubu	Az Deployment Operation MG List Az Deployment MG Gösterisi
Kiracı	Az Deployment Operation Kiracı Listesi az deployment tenant show

Sonraki Adımlar

• Yaygın dağıtım hataları
• Hata ayıklama kaydını etkinleştir
• Sorun giderme şablonu oluşturma