Menemukan kode kesalahan

Saat penyebaran sumber daya Azure gagal menggunakan templat Azure Resource Manager (templat ARM) atau file Bicep, dan kode kesalahan diterima. Artikel ini menjelaskan cara menemukan kode kesalahan sehingga Anda dapat memecahkan masalah. Untuk informasi selengkapnya tentang kode kesalahan, lihat kesalahan penyebaran umum.

Jenis kesalahan

Ada dua jenis kesalahan yang terkait dengan penyebaran:

• Kesalahan validasi terjadi sebelum penyebaran dimulai dan disebabkan oleh kesalahan sintaks dalam file Anda. Editor kode seperti Visual Studio Code dapat mengidentifikasi kesalahan ini.
• Kesalahan validasi preflight terjadi saat perintah penyebaran dijalankan tetapi sumber daya tidak disebarkan. Kesalahan ini ditemukan tanpa memulai penyebaran. Misalnya, jika nilai parameter tidak benar, kesalahan ditemukan dalam validasi sebelum penerbangan.
• Kesalahan penyebaran terjadi selama proses penyebaran dan hanya dapat ditemukan dengan menilai kemajuan penyebaran di lingkungan Azure Anda.

Kedua jenis kesalahan tersebut mengembalikan kode kesalahan yang Anda gunakan untuk memecahkan masalah penyebaran. Validasi dan kesalahan pra-penerbangan ditampilkan di log aktivitas tetapi tidak muncul di riwayat penyebaran Anda. File Bicep dengan kesalahan sintaks tidak dikompilasi ke dalam JSON dan tidak ditampilkan di log aktivitas.

Untuk mengidentifikasi kesalahan sintaksis, Anda dapat menggunakan Visual Studio Code dengan ekstensi Bicep terbaru atau ekstensi Alat Azure Resource Manager.

Kesalahan validasi

Templat divalidasi selama proses penyebaran dan kode kesalahan ditampilkan. Sebelum menjalankan penyebaran, Anda dapat mengidentifikasi kesalahan validasi dan preflight dengan menjalankan pengujian validasi dengan Azure PowerShell atau Azure CLI.

Portal

Templat ARM dapat disebarkan dari portal. Jika templat memiliki kesalahan sintaks, Anda akan melihat kesalahan validasi saat mencoba menjalankan penyebaran. Untuk informasi selengkapnya tentang penyebaran portal, lihat menyebarkan sumber daya dari templat kustom.

Contoh berikut mencoba menyebarkan akun penyimpanan dan terjadi kesalahan validasi.

Pilih pesan untuk mengetahui detail selengkapnya. Templat memiliki kesalahan sintaksis dengan kode kesalahan InvalidTemplate. Ringkasan memperlihatkan ekspresi tidak memiliki tanda kurung penutup.

PowerShell

Untuk memvalidasi templat ARM sebelum penyebaran, jalankan Test-AzResourceGroupDeployment.

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

Output menampilkan kode kesalahan seperti InvalidTemplateDeployment atau AccountNameInvalid yang dapat Anda gunakan untuk memecahkan masalah dan memperbaiki templat.

Untuk file Bicep, output untuk masalah validasi sintaks menunjukkan kesalahan parameter.

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.

Untuk mendapatkan informasi pemecahan masalah lainnya, gunakan perintah build Bicep. Output menunjukkan nomor baris dan kolom setiap kesalahan dalam tanda kurung, serta pesan kesalahan.

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.

Cakupan lainnya

Ada cmdlet Azure PowerShell untuk memvalidasi templat penyebaran untuk langganan, grup manajemen, dan cakupan penyewa.

Ruang Lingkup	Cmdlets (sebuah kumpulan skrip command-line)
Langganan	Test-AzDeployment
Grup Manajemen	Test-AzManagementGroupDeployment
Penyewa	Test-AzTenantDeployment

Azure CLI

Untuk memvalidasi templat ARM sebelum penyebaran, jalankan validasi grup penyebaran az.

az deployment group validate \
  --resource-group examplegroup \
  --template-file azuredeploy.json

Output menampilkan kode kesalahan seperti InvalidTemplateDeployment atau AccountNameInvalid yang dapat Anda gunakan untuk memecahkan masalah dan memperbaiki templat.

Untuk file Bicep, output menunjukkan baris dan nomor kolom setiap kesalahan dalam tanda kurung, dan pesan kesalahan.

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.

Cakupan lainnya

Ada perintah Azure CLI untuk memvalidasi templat penyebaran untuk langganan, grup manajemen, dan cakupan penyewa.

Ruang Lingkup	Perintah
Langganan	az validasi sub penyebaran
Grup Manajemen	az deployment mg validate
Penyewa	validasi penyebaran tenant az

Kesalahan penyebaran

Beberapa operasi diproses untuk menyediakan sumber daya Azure. Kesalahan penyebaran terjadi ketika operasi melewati validasi tetapi gagal selama penyebaran. Anda dapat melihat pesan tentang setiap operasi penyebaran dan setiap penyebaran untuk grup sumber daya.

Portal

Untuk melihat pesan tentang operasi penyebaran, gunakan Log Aktivitas grup sumber daya.

1. Masuk ke portal Microsoft Azure.

2. Buka Grup sumber daya dan pilih nama grup sumber daya penyebaran.

3. Pilih Log aktivitas.

4. Gunakan filter untuk menemukan log kesalahan operasi.

   

5. Pilih log kesalahan untuk melihat detail operasi.

   

Untuk melihat hasil penyebaran:

1. Pergi ke grup sumber daya.

2. Pilih Pengaturan>Penyebaran.

3. Pilih Detail kesalahan untuk pengiriman.

   

4. Pesan kesalahan dan kode NoRegisteredProviderFound kesalahan ditampilkan.

   

PowerShell

Untuk melihat pesan operasi penyebaran dengan PowerShell, gunakan Get-AzResourceGroupDeploymentOperation.

Untuk menampilkan semua operasi penyebaran:

Get-AzResourceGroupDeploymentOperation `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup

Untuk menentukan jenis properti tertentu:

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

Untuk mendapatkan hasil penyebaran, gunakan Get-AzResourceGroupDeployment.

Get-AzResourceGroupDeployment `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup

Cakupan lainnya

Ada cmdlet Azure PowerShell untuk mendapatkan informasi penyebaran untuk langganan, grup manajemen, dan cakupan penyewa.

Ruang Lingkup	Cmdlets (sebuah kumpulan skrip command-line)
Langganan	Get-AzDeploymentOperation Get-AzDeployment
Grup Manajemen	Get-AzManagementGroupDeploymentOperation (Perintah untuk mendapatkan operasi penyebaran grup manajemen Azure) Get-AzManagementGroupDeployment
Penyewa	Get-AzTenantDeploymentOperation Get-AzTenantDeployment

Azure CLI

Untuk melihat pesan operasi penyebaran dengan Azure CLI, gunakan daftar grup operasi penyebaran az.

Untuk menampilkan semua operasi penyebaran:

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

Untuk menentukan jenis properti tertentu:

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

Untuk mendapatkan hasil penyebaran, gunakan az deployment group show.

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

Cakupan lainnya

Ada perintah Azure CLI untuk mendapatkan informasi penyebaran untuk cakupan langganan, grup manajemen, dan penyewa.

Ruang Lingkup	Perintah
Langganan	daftar sub operasi penggelaran az az deployment sub show
Grup Manajemen	Daftar MG operasi penyebaran az az deployment mg show
Penyewa	Daftar penyewa operasi penyebaran az In situations where context is needed, an explanation might be added such as "az deployment tenant show (gunakan perintah ini untuk menunjukkan penyebaran penyewa)" for clarity.

Langkah selanjutnya

• Kesalahan penyebaran umum
• Aktifkan log debug
• Membuat templat pemecahan masalah