Temukan kode galat

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 galat sehingga Anda dapat memecahkan masalah. Untuk informasi selengkapnya tentang kode galat, 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 Anda dapat mengidentifikasi kesalahan ini.
  • Kesalahan validasi pra-penerbangan 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.

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 sintaks, Anda dapat menggunakan Visual Studio Code dengan ekstensi Bicep atau ekstensi Alat Azure Resource Manager terbaru.

Kesalahan validasi

Templat divalidasi selama proses penyebaran dan kode galat ditampilkan. Sebelum menjalankan penyebaran, Anda dapat menjalankan tes validasi dengan Azure PowerShell atau Azure CLI untuk mengidentifikasi validasi dan kesalahan pra-penerbangan.

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

Contoh berikut mencoba menyebarkan akun penyimpanan dan terjadi kesalahan validasi.

Screenshot of an Azure portal validation error.

Pilih pesan untuk mengetahui detail selengkapnya. Templat memiliki galat sintaksis dengan kode galat InvalidTemplate. Ringkasan menunjukkan ekspresi kekurangan kurung penutup.

Screenshot of a validation error message that shows a syntax error.

Kesalahan penyebaran

Beberapa operasi diproses untuk menyebarkan sumber daya Azure. Kesalahan penyebaran terjadi saat operasi lulus validasi tetapi gagal selama penyebaran. Anda dapat melihat pesan tentang setiap operasi penyebaran dan setiap penyebaran untuk grup sumber daya.

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 galat operasi.

    Screenshot of the resource group's activity log that highlights a failed deployment.

  5. Pilih log galat untuk melihat detail operasi.

    Screenshot of the activity log details that shows a failed deployment's error message.

Untuk melihat hasil penyebaran:

  1. Buka grup sumber daya.

  2. Pilih Pengaturan>Penyebaran.

  3. Pilih Detail kesalahan untuk penyebaran.

    Screenshot of a resource group's link to error details for a failed deployment.

  4. Pesan kesalahan dan kode galat NoRegisteredProviderFound ditunjukkan.

    Screenshot of a message that shows deployment error details.

Langkah berikutnya