Memecahkan masalah kesalahan penyebaran Azure yang umum
Artikel ini menjelaskan cara menyelesaikan masalah umum kesalahan penyebaran Azure dan menyediakan informasi terkait solusinya. Sumber daya Azure dapat digunakan dengan file Bicep atau templat Azure Resource Manager (templat ARM). Jika Anda tidak dapat menemukan kode kesalahan untuk kesalahan penyebaran Anda, lihat Menemukan kode kesalahan.
Jika kode kesalahan Anda tidak tercantum, kirimkan masalah GitHub. Pilih Umpan balik di sisi kanan halaman. Di bagian bawah halaman, di bawah Umpan balik pilih Halaman ini. Berikan umpan balik dokumentasi Anda, tetapi jangan sertakan informasi rahasia karena masalah GitHub bersifat publik.
Kode kesalahan
| Kode kesalahan | Mitigasi | Informasi selengkapnya |
|---|---|---|
| AccountNameInvalid | Ikuti panduan penamaan untuk akun penyimpanan. | Mengatasi kesalahan untuk nama akun penyimpanan |
| AccountPropertyCannotBeSet | Periksa properti akun penyimpanan yang tersedia. | storageAccounts |
| AllocationFailed | Kluster atau wilayah tidak memiliki sumber daya yang tersedia atau tidak dapat mendukung ukuran komputer virtual yang diminta. Coba lagi permintaan di lain waktu, atau minta ukuran komputer virtual yang berbeda. | Masalah provisi dan alokasi untuk Linux Masalah provisi dan alokasi untuk Windows Memecahkan masalah kegagalan alokasi |
| AnotherOperationInProgress | Tunggu hingga operasi bersamaan selesai. | |
| AuthorizationFailed | Akun atau perwakilan layanan Anda tidak memiliki akses yang memadai untuk menyelesaikan penyebaran. Periksa peran milik akun Anda, dan aksesnya untuk cakupan penyebaran. Anda mungkin menerima kesalahan ini ketika penyedia sumber yang diperlukan tidak terdaftar. |
Kontrol akses berbasis peran Azure (Azure RBAC) Mengatasi pendaftaran |
| BadRequest | Anda mengirim nilai penyebaran yang tidak cocok dengan apa yang diharapkan oleh Resource Manager. Periksa pesan status dalam untuk bantuan pemecahan masalah. Validasi sintaks templat untuk mengatasi kesalahan penyebaran saat menggunakan templat yang diekspor dari sumber daya Azure yang ada. |
Referensi templat Lokasi sumber daya di templat ARM Lokasi sumber daya di file Bicep Mengatasi templat yang tidak valid |
| Konflik | Anda meminta operasi yang tidak diperbolehkan dalam status sumber daya saat ini. Misalnya, pengubahan ukuran disk diizinkan hanya saat membuat komputer virtual atau saat komputer virtual didealokasikan. | |
| DeploymentActiveAndUneditable | Tunggu hingga penyebaran bersamaan ke grup sumber daya ini selesai. | |
| DeploymentFailedCleanUp | Saat Anda menyebarkan dalam mode lengkap, sumber daya apa pun yang tidak ada dalam templat akan dihapus. Anda mendapatkan kesalahan ini ketika Anda tidak memiliki izin yang memadai untuk menghapus semua sumber daya yang tidak ada dalam templat. Untuk menghindari kesalahan tersebut, ubah mode penyebaran menjadi bertambah bertahap. | Mode penyebaran Azure Resource Manager |
| DeploymentNameInvalidCharacters | Nama penyebaran hanya dapat berisi huruf, digit, deployment name can only contain letters, digit, tanda hubung (-), titik (.) atau garis bawah (_). |
|
| DeploymentNameLengthLimitExceeded | Nama penyebaran dibatasi hingga 64 karakter. | |
| DeploymentFailed | Kesalahan DeploymentFailed adalah kesalahan umum yang tidak berisi detail yang Anda perlukan untuk mengatasi kesalahan. Lihat di detail kesalahan untuk kode galat yang menyediakan informasi lebih lanjut. | Menemukan kode galat |
| DeploymentQuotaExceeded | Jika Anda mencapai batas 800 penyebaran per grup sumber daya, hapus penyebaran dari riwayat yang tidak lagi diperlukan. | Mengatasi kesalahan saat jumlah penyebaran melebihi 800 |
| DeploymentJobSizeExceeded | Sederhanakan templat Anda untuk mengurangi ukuran. | Mengatasi kesalahan ukuran templat |
| DnsRecordInUse | Nama baris DNS harus unik. Masukkan nama yang berbeda. | |
| ImageNotFound | Periksa pengaturan gambar komputer virtual. | |
| InaccessibleImage | Penyebaran instans Azure Container gagal. Anda mungkin perlu menyertakan tag gambar dengan sintaksis registry/image:tag untuk menyebarkan kontainer. Untuk registri pribadi, pastikan informasi masuk Anda sudah benar. |
Menemukan kode galat |
| InternalServerError | Disebabkan oleh masalah sementara. Coba lagi penyebarannya. | |
| InUseSubnetCannotBeDeleted | Kesalahan ini dapat terjadi ketika Anda mencoba memperbarui sumber daya, jika proses permintaan menghapus dan membuat sumber daya. Pastikan untuk menentukan semua nilai yang tidak berubah. | Memperbarui sumber daya |
| InvalidAuthenticationTokenTenant | Dapatkan token akses untuk penyewa yang sesuai. Anda hanya bisa mendapatkan token dari penyewa tempat akun Anda berada. | |
| InvalidContentLink | Kemungkinan besar Anda mencoba menautkan ke templat berlapis yang tidak tersedia. Periksa kembali URI yang Anda sediakan untuk templat berlapis. Jika templat ada di akun penyimpanan, pastikan URI dapat diakses. Anda mungkin perlu melewati token SAS. Saat ini, Anda tidak dapat menautkan ke templat yang ada di akun penyimpanan di belakang firewall Azure Storage. Pertimbangkan untuk memindahkan templat Anda ke repositori lain, seperti GitHub. | Templat ARM yang tertaut dan berlapis Modul Bicep |
| InvalidDeploymentLocation | Saat menyebarkan di tingkat langganan, Anda telah menyediakan lokasi berbeda untuk nama penyebaran yang sebelumnya digunakan. | Penyebaran langganan templat ARM Penyebaran langganan Bicep |
| InvalidParameter | Salah satu nilai yang Anda berikan untuk sumber daya tidak cocok dengan nilai yang diharapkan. Kesalahan ini dapat diakibatkan oleh berbagai kondisi. Misalnya, kata sandi mungkin tidak mencukupi, atau kemungkinan nama blob salah. Pesan kesalahan harus menunjukkan nilai mana yang perlu diperbaiki. | Parameter templat ARM Parameter Bicep |
| InvalidRequestContent | Nilai penyebaran mencakup nilai yang tidak dikenali, atau nilai yang diperlukan hilang. Konfirmasi nilai untuk jenis sumber daya Anda. | Referensi templat |
| InvalidRequestFormat | Aktifkan pengelogan debug saat menjalankan penyebaran, dan verifikasi konten permintaan. | Pengelogan debug |
| InvalidResourceLocation | Beri nama unik untuk akun penyimpanan. | Mengatasi kesalahan untuk nama akun penyimpanan |
| InvalidResourceNamespace | Periksa jenis sumber daya namespace yang Anda tentukan dalam properti jenis. | Referensi templat |
| InvalidResourceReference | Sumber daya belum ada atau salah direferensikan. Periksa apakah Anda perlu menambahkan dependensi. Verifikasi bahwa penggunaan fungsi referensi Anda menyertakan parameter yang diperlukan untuk skenario Anda. | Mengatasi dependensi |
| InvalidResourceType | Periksa jenis sumber daya yang Anda tentukan dalam properti jenis. | Referensi templat |
| InvalidSubscriptionRegistrationState | Daftarkan langganan Anda dengan penyedia sumber. | Mengatasi pendaftaran |
| InvalidTemplateDeployment InvalidTemplate |
Periksa sintaksis templat Anda untuk kesalahan. | Mengatasi templat yang tidak valid |
| InvalidTemplateCircularDependency | Hapus dependensi yang tidak perlu. | Mengatasi dependensi melingkar |
| JobSizeExceeded | Sederhanakan templat Anda untuk mengurangi ukuran. | Mengatasi kesalahan ukuran templat |
| LinkedAuthorizationFailed | Periksa apakah akun Anda milik penyewa yang sama dengan grup sumber daya tempat Anda menyebarkan. | |
| LinkedInvalidPropertyId | ID sumber daya untuk sumber daya tidak diselesaikan. Periksa apakah Anda memberikan semua nilai yang diperlukan untuk ID sumber daya. Misalnya, ID langganan, nama grup sumber daya, jenis sumber daya, nama sumber daya induk (jika diperlukan), dan nama sumber daya. | Mengatasi kesalahan untuk nama dan jenis sumber daya |
| LocationRequired | Menyediakan lokasi untuk sumber daya. | Lokasi sumber daya di templat ARM Lokasi sumber daya di file Bicep |
| MismatchingResourceSegments | Pastikan sumber daya bersarang memiliki jumlah segmen yang benar dalam nama dan jenis. | Mengatasi segmen sumber daya |
| MissingRegistrationForLocation | Periksa status pendaftaran penyedia sumber dan lokasi yang didukung. | Mengatasi pendaftaran |
| MissingSubscriptionRegistration | Daftarkan langganan Anda dengan penyedia sumber. | Mengatasi pendaftaran |
| NoRegisteredProviderFound | Periksa status pendaftaran penyedia sumber. | Mengatasi pendaftaran |
| NotFound | Anda mungkin mencoba menyebarkan sumber daya dependen secara paralel dengan sumber daya induk. Periksa apakah Anda perlu menambahkan dependensi. | Mengatasi dependensi |
| OperationNotAllowed | Mungkin ada beberapa alasan untuk pesan kesalahan ini. 1. Penyebaran mencoba operasi yang tidak diizinkan pada SKU tertentu. 2. Penyebaran mencoba operasi yang melebihi kuota untuk langganan, grup sumber daya, atau wilayah. Jika memungkinkan, revisi penyebaran anda untuk tetap berada dalam kuota. Jika tidak, pertimbangkan untuk meminta perubahan kuota Anda. |
Mengatasi kuota |
| OperationNotAllowedOnVMImageAsVMsBeingProvisioned | Anda mungkin mencoba menghapus gambar yang saat ini digunakan untuk menyediakan VM. Anda tidak dapat menghapus gambar yang sedang digunakan oleh komputer virtual apa pun selama proses penyebaran. Coba lagi operasi penghapusan gambar setelah penyebaran VM selesai. | |
| ParentResourceNotFound | Pastikan ada sumber daya induk sebelum membuat sumber daya anak. | Mengatasi sumber daya induk |
| PasswordTooLong | Anda mungkin telah memilih kata sandi dengan terlalu banyak karakter, atau mengonversi nilai kata sandi Anda ke string yang aman sebelum meneruskannya sebagai parameter. Jika template menyertakan parameter string yang aman, Anda tidak perlu mengonversi nilai ke string yang aman. Berikan nilai kata sandi sebagai teks. | |
| PrivateIPAddressInReservedRange | Alamat IP yang ditentukan mencakup rentang alamat yang diperlukan oleh Azure. Ubah alamat IP untuk menghindari rentang yang khusus. | Alamat IP privat |
| PrivateIPAddressNotInSubnet | Alamat IP yang ditentukan berada di luar rentang subnet. Ubah alamat IP agar berada dalam rentang subnet. | Alamat IP privat |
| PropertyChangeNotAllowed | Beberapa properti tidak dapat diubah pada sumber daya yang disebarkan. Saat memperbarui sumber daya, batasi perubahan Anda pada properti yang diizinkan. | Memperbarui sumber daya |
| PublicIPCountLimitReached | Anda telah mencapai batas untuk jumlah IP publik yang berjalan. Matikan sumber daya yang tidak diperlukan atau hubungi dukungan Azure untuk meminta peningkatan. Misalnya, di Azure Databricks, lihat Penghentian kluster tak terduga dan batas alamat IP mencegah pembuatan kluster. | Batas alamat IP publik |
| RegionDoesNotAllowProvisioning | Pilih wilayah lain atau kirimkan permintaan dukungan kuota untuk Akses wilayah. | |
| RequestDisallowedByPolicy | Langganan Anda menyertakan kebijakan sumber daya yang mencegah tindakan yang Anda coba lakukan selama penyebaran. Temukan kebijakan yang memblokir tindakan. Jika memungkinkan, ubah penyebaran Anda untuk memenuhi batasan dari kebijakan. | Mengatasi kebijakan |
| ReservedResourceName | Berikan nama sumber daya yang tidak menyertakan nama khusus. | Nama sumber daya khusus |
| ResourceGroupBeingDeleted | Tunggu hingga penghapusan selesai. | |
| ResourceGroupNotFound | Periksa nama grup sumber daya target untuk penyebaran. Grup sumber daya target harus sudah ada di langganan Anda. Periksa konteks langganan Anda. | Azure CLI PowerShell |
| ResourceNotFound | Penyebaran Anda mereferensikan sumber daya yang tidak dapat diatasi. Verifikasi bahwa penggunaan fungsi referensi Anda menyertakan parameter yang diperlukan untuk skenario Anda. | Mengatasi referensi |
| ResourceQuotaExceeded | Penyebaran mencoba membuat sumber daya yang melebihi kuota untuk langganan, grup sumber daya, atau wilayah. Jika memungkinkan, revisi infrastruktur Anda agar tetap berada dalam kuota. Jika tidak, pertimbangkan untuk meminta perubahan kuota Anda. | Mengatasi kuota |
| SkuNotAvailable | Pilih SKU (seperti ukuran komputer virtual) yang tersedia untuk lokasi yang Anda pilih. | Mengatasi SKU |
| StorageAccountAlreadyTaken StorageAccountAlreadyExists |
Beri nama unik untuk akun penyimpanan. | Mengatasi kesalahan untuk nama akun penyimpanan |
| StorageAccountInAnotherResourceGroup | Beri nama unik untuk akun penyimpanan. | Mengatasi kesalahan untuk nama akun penyimpanan |
| StorageAccountNotFound | Periksa langganan, grup sumber daya, dan nama akun penyimpanan yang coba Anda gunakan. | |
| SubnetsNotInSameVnet | Komputer virtual hanya dapat memiliki satu jaringan virtual. Saat menyebarkan beberapa NIC, pastikan NIC termasuk dalam jaringan virtual yang sama. | Windows VM dengan beberapa NIC Linux VM dengan beberapa NIC |
| SubnetIsFull | Tidak ada cukup alamat yang tersedia di subnet untuk menyebarkan sumber daya. Anda dapat merilis alamat dari subnet, menggunakan subnet yang berbeda, atau membuat subnet baru. | Mengelola subnet dan FAQ jaringan virtual Alamat IP privat |
| SubscriptionNotFound | Langganan yang ditentukan untuk penyebaran tidak dapat diakses. Bisa jadi ID langganan salah, pengguna yang menyebarkan templat tidak memiliki izin yang memadai untuk menyebarkan ke langganan, atau ID langganan berada dalam format yang salah. Saat menggunakan penyebaran berlapis templat ARM untuk diterapkan di seluruh cakupan, berikan GUID langganan. | Templat ARM diterapkan di seluruh cakupan File bisep disebarkan di seluruh cakupan |
| SubscriptionNotRegistered | Saat sumber daya disebarkan, penyedia sumber daya harus terdaftar untuk langganan Anda. Saat Anda menggunakan templat Azure Resource Manager untuk penyebaran, penyedia sumber secara otomatis terdaftar dalam langganan. Terkadang, pendaftaran otomatis tidak selesai tepat waktu. Untuk menghindari kesalahan terputus-terputus ini, daftarkan penyedia sumber sebelum penyebaran. | Mengatasi pendaftaran |
| SubscriptionRequestsThrottled | Azure Resource Manager membatasi permintaan di tingkat langganan atau tingkat penyewa. Penyedia sumber daya seperti Microsoft.Compute juga membatasi permintaan khusus untuk operasinya. Ketika batas tercapai, Anda mendapatkan pesan dan nilai dengan jumlah waktu yang harus Anda tunggu sebelum mengirim permintaan baru. Misalnya: Number of requests for subscription '<subscription-id-guid>' and operation '<resource provider>' exceeded the backend storage limit. Please try again after '6' seconds. Respons HTTP mengembalikan pesan seperti HTTP status code 429 Too Many Requests dengan Retry-After nilai yang menentukan jumlah detik untuk menunggu sebelum Anda mengirim permintaan lain. |
Membatasi permintaan Resource Manager Pemecahan masalah kesalahan pembatasan API - komputer virtual Pembatasan Azure Kubernetes Service |
| TemplateResourceCircularDependency | Hapus dependensi yang tidak perlu. | Mengatasi dependensi melingkar |
| TooManyTargetResourceGroups | Mengurangi jumlah grup sumber daya untuk satu penyebaran. | Templat ARM diterapkan di seluruh cakupan File bisep disebarkan di seluruh cakupan |
Langkah berikutnya
- Untuk informasi mengenai kesalahan validasi atau penyebaran, lihat Menemukan kode kesalahan.
- Untuk mendapatkan detail selengkapnya mengenai pemecahan masalah penyebaran, lihat Mengaktifkan pengelogan debug.
- Untuk mengisolasi penyebab kesalahan penyebaran, lihat Membuat templat pemecahan masalah.