Bagikan melalui


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