Sık karşılaşılan Azure dağıtım hatalarını giderme
Bu makalede yaygın Azure dağıtım hatalarını giderme adımları açıklanır ve çözümler hakkında bilgi sağlanır. Azure kaynakları, Bicep dosyaları veya Azure Resource Manager şablonları (ARM şablonları) ile dağıtılabilir. Dağıtım hatanızın hata kodunu bulamazsanız bkz. Hata kodunu bulma.
Hata kodunuz listede yoksa GitHub sorunu gönderin. Sayfanın sağ tarafında Geri Bildirim'i seçin. Sayfanın alt kısmındaki Geri Bildirim'in altında Bu sayfa'yı seçin. GitHub sorunları herkese açık olduğundan, belge geri bildiriminizi sağlayın ancak gizli bilgileri eklemeyin .
Hata kodları
Hata kodu | Risk azaltma | Daha fazla bilgi |
---|---|---|
AccountNameInvalid | Depolama hesapları için adlandırma yönergelerini izleyin. | Depolama hesabı adlarıyla ilgili hataları düzeltme |
AccountPropertyCannotBeSet | Kullanılabilir depolama hesabı özelliklerini denetleyin. | storageAccounts |
Ayırma Başarısız Oldu | Kümede veya bölgede kullanılabilir kaynaklar yok veya istenen VM boyutunu destekleyemez. İsteği daha sonra yeniden deneyin veya farklı bir VM boyutu isteyin. | Linux için sağlama ve ayırma sorunları Windows için sağlama ve ayırma sorunları Ayırma hataları ile ilgili sorunları giderme |
AnotherOperationInProgress | Eşzamanlı işlemin tamamlanmasını bekleyin. | |
AuthorizationFailed | Hesabınızın veya hizmet sorumlunuzun dağıtımı tamamlamak için yeterli erişimi yok. Hesabınızın ait olduğu rolü ve dağıtım kapsamına erişimini denetleyin. Gerekli bir kaynak sağlayıcısı kaydedilmediğinde bu hatayı alabilirsiniz. |
Azure rol tabanlı erişim denetimi (Azure RBAC) Kaydı çözme |
BadRequest | Resource Manager tarafından beklenenle eşleşmeyen dağıtım değerleri gönderdiniz. Sorun giderme konusunda yardım için iç durum iletisini denetleyin. Mevcut Azure kaynağından dışarı aktarılan bir şablonu kullanırken dağıtım hatalarını çözmek için şablonun söz dizimini doğrulayın. |
Şablon başvurusu ARM şablonunda kaynak konumu Bicep dosyasında kaynak konumu Geçersiz şablonu çözümleme |
Çakışma | Kaynağın geçerli durumunda izin verilmeyen bir işlem istiyorsunuz. Örneğin, disk yeniden boyutlandırmaya yalnızca VM oluşturulurken veya VM serbest bırakıldığında izin verilir. | |
DeploymentActiveAndUneditable | Bu kaynak grubuna eşzamanlı dağıtımın tamamlanmasını bekleyin. | |
DeploymentFailedCleanUp | Tam modda dağıttığınızda, şablonda olmayan tüm kaynaklar silinir. Şablonda bulunmayan tüm kaynakları silmek için yeterli izniniz olmadığında bu hatayı alırsınız. Hatadan kaçınmak için dağıtım modunu artımlı olarak değiştirin. | Azure Resource Manager dağıtım modları |
DeploymentNameInvalidCharacters | Dağıtım adı yalnızca harf, rakam, kısa çizgi (-) , nokta (.) veya alt çizgi (_) içerebilir. |
|
DeploymentNameLengthLimitExceeded | Dağıtım adları 64 karakterle sınırlıdır. | |
DeploymentFailed | DeploymentFailed hatası, hatayı çözmek için ihtiyacınız olan ayrıntıları sağlamayan genel bir hatadır. Daha fazla bilgi sağlayan bir hata kodu için hata ayrıntılarına bakın. | Hata kodunu bulma |
DeploymentQuotaExceeded | Kaynak grubu başına 800 dağıtım sınırına ulaşırsanız, artık gerekli olmayan dağıtımları geçmişten silin. | Dağıtım sayısı 800'ü aştı hatasını çözme |
DeploymentJobSizeExceeded | Boyutu küçültmek için şablonunuzu basitleştirin. | Şablon boyutu hatalarını düzeltme |
DnsRecordInUse | DNS kayıt adı benzersiz olmalıdır. Farklı bir ad girin. | |
ImageNotFound | VM görüntüsü ayarlarını denetleyin. | |
InaccessibleImage | Azure Container Instance dağıtımı başarısız oluyor. Kapsayıcıyı dağıtmak için görüntünün etiketini söz dizimine registry/image:tag eklemeniz gerekebilir. Özel kayıt defteri için kimlik bilgilerinizin doğru olduğunu doğrulayın. |
Hata kodunu bulma |
InternalServerError | Geçici bir sorundan kaynaklanmaktadır. Dağıtımı yeniden deneyin. | |
InUseSubnetCannotBeDeleted | bu hata, bir kaynağı güncelleştirmeyi denediğinizde, istek işlemi kaynağı silip oluşturursa oluşabilir. Değişmeyen tüm değerleri belirttiğinizden emin olun. | Güncelleştirme kaynağı |
InvalidAuthenticationTokenTenant | Uygun kiracı için erişim belirteci alma. Belirteci yalnızca hesabınızın ait olduğu kiracıdan alabilirsiniz. | |
InvalidContentLink | Büyük olasılıkla kullanılabilir olmayan bir iç içe şablona bağlanmayı denediniz. İç içe şablon için sağladığınız URI'yi bir kez daha denetleyin. Şablon bir depolama hesabında varsa URI'nin erişilebilir olduğundan emin olun. SAS belirteci geçirmeniz gerekebilir. Şu anda Azure Depolama güvenlik duvarının arkasındaki depolama hesabında bulunan bir şablona bağlanamazsınız. Şablonunuzu GitHub gibi başka bir depoya taşımayı göz önünde bulundurun. | Bağlantılı ve iç içe yerleştirilmiş ARM şablonları Bicep modülleri |
InvalidDeploymentLocation | Abonelik düzeyinde dağıtım yaparken, daha önce kullanılan bir dağıtım adı için farklı bir konum sağladınız. | ARM şablonu abonelik dağıtımı Bicep aboneliği dağıtımı |
InvalidParameter | Bir kaynak için sağladığınız değerlerden biri beklenen değerle eşleşmiyor. Bu hata birçok farklı koşuldan kaynaklanabilir. Örneğin, parola yetersiz olabilir veya blob adı yanlış olabilir. Hata iletisi hangi değerin düzeltilmesi gerektiğini göstermelidir. | ARM şablonu parametreleri Bicep parametreleri |
InvalidRequestContent | Dağıtım değerleri tanınmayan değerleri içerir veya gerekli değerler eksiktir. Kaynak türünüzün değerlerini onaylayın. | Şablon başvurusu |
InvalidRequestFormat | Dağıtımı çalıştırırken hata ayıklama günlüğünü etkinleştirin ve isteğin içeriğini doğrulayın. | Hata ayıklama günlüğü |
InvalidResourceLocation | Depolama hesabına benzersiz bir ad verin. | Depolama hesabı adlarıyla ilgili hataları düzeltme |
InvalidResourceNamespace | type özelliğinde belirttiğiniz kaynak ad alanını denetleyin. | Şablon başvurusu |
InvalidResourceReference | Kaynağa henüz mevcut değil veya yanlış başvuruda bulunulur. Bağımlılık eklemeniz gerekip gerekmediğini denetleyin. Başvuru işlevini kullanımınızın senaryonuz için gerekli parametreleri içerdiğini doğrulayın. | Bağımlılıkları çözme |
InvalidResourceType | type özelliğinde belirttiğiniz kaynak türünü denetleyin. | Şablon başvurusu |
InvalidSubscriptionRegistrationState | Aboneliğinizi kaynak sağlayıcısına kaydedin. | Kaydı çözme |
InvalidTemplateDeployment InvalidTemplate |
Şablon söz diziminizde hatalar olup olmadığını denetleyin. | Geçersiz şablonu çözümleme |
InvalidTemplateCircularDependency | Gereksiz bağımlılıkları kaldırın. | Döngüsel bağımlılıkları çözme |
JobSizeExceeded | Boyutu küçültmek için şablonunuzu basitleştirin. | Şablon boyutu hatalarını düzeltme |
LinkedAuthorizationFailed | Hesabınızın dağıttığınız kaynak grubuyla aynı kiracıya ait olup olmadığını denetleyin. | |
LinkedInvalidPropertyId | Bir kaynağın kaynak kimliği çözümlenmez. Kaynak kimliği için tüm gerekli değerleri sağladığınızı denetleyin. Örneğin, abonelik kimliği, kaynak grubu adı, kaynak türü, üst kaynak adı (gerekirse) ve kaynak adı. | Kaynak adı ve türü hatalarını düzeltme |
Konum Sorgulandı | Kaynak için bir konum belirtin. | ARM şablonunda kaynak konumu Bicep dosyasında kaynak konumu |
UyumsuzlukResourceSegments | İç içe bir kaynağın ad ve tür olarak doğru sayıda segmente sahip olduğundan emin olun. | Kaynak segmentlerini çözümleme |
MissingRegistrationForLocation | Kaynak sağlayıcısı kayıt durumunu ve desteklenen konumları denetleyin. | Kaydı çözme |
MissingSubscriptionRegistration | Aboneliğinizi kaynak sağlayıcısına kaydedin. | Kaydı çözme |
NoRegisteredProviderFound | Kaynak sağlayıcısı kayıt durumunu denetleyin. | Kaydı çözme |
NotFound | Bağımlı bir kaynağı bir üst kaynakla paralel olarak dağıtmayı denemiş olabilirsiniz. Bağımlılık eklemeniz gerekip gerekmediğini denetleyin. | Bağımlılıkları çözme |
OperationNotAllowed | Bu hata iletisinin çeşitli nedenleri olabilir. 1. Dağıtım, spcecified SKU'da izin verilmeyen bir işlem deneniyor. 2. Dağıtım, abonelik, kaynak grubu veya bölge kotasını aşan bir işlem deneniyor. Mümkünse, kotaların içinde kalmak için dağıtımınızı düzeltin. Aksi takdirde, kotalarınızda değişiklik yapmayı göz önünde bulundurun. |
Kotaları çözme |
OperationNotAllowedOnVMImageAsVMsBeingProvisioned | VM'leri sağlamak için kullanılmakta olan bir görüntüyü silmeye çalışıyorsunuz olabilir. Dağıtım işlemi sırasında herhangi bir sanal makine tarafından kullanılan bir görüntüyü silemezsiniz. VM dağıtımı tamamlandıktan sonra görüntü silme işlemini yeniden deneyin. | |
ParentResourceNotFound | Alt kaynakları oluşturmadan önce bir üst kaynağın var olduğundan emin olun. | Üst kaynağı çözümleme |
PasswordTooLong | Çok fazla karakter içeren bir parola seçmiş veya parametre olarak geçirmeden önce parola değerinizi güvenli bir dizeye dönüştürebilirsiniz. Şablon güvenli bir dize parametresi içeriyorsa, değeri güvenli bir dizeye dönüştürmeniz gerekmez. Parola değerini metin olarak belirtin. | |
PrivateIPAddressInReservedRange | Belirtilen IP adresi, Azure'ın gerektirdiği bir adres aralığını içerir. Ayrılmış aralıktan kaçınmak için IP adresini değiştirin. | Özel IP adresleri |
PrivateIPAddressNotInSubnet | Belirtilen IP adresi alt ağ aralığının dışında. IP adresini alt ağ aralığı içinde olacak şekilde değiştirin. | Özel IP adresleri |
PropertyChangeNotAllowed | Dağıtılan bir kaynakta bazı özellikler değiştirilemez. Bir kaynağı güncelleştirirken, değişikliklerinizi izin verilen özelliklerle sınırlayın. | Güncelleştirme kaynağı |
PublicIPCountLimitReached | Çalışan genel IP sayısı sınırına ulaştınız. Gereksiz kaynakları kapatın veya artış istemek için Azure desteği başvurun. Örneğin, Azure Databricks'te bkz . Beklenmeyen küme sonlandırma ve IP adresi sınırı küme oluşturmayı engeller. | Genel IP adresi sınırları |
RegionDoesNotAllowProvisioning | Farklı bir bölge seçin veya Bölge erişimi için bir kota destek isteği gönderin. | |
RequestDisallowedByPolicy | Aboneliğiniz, dağıtım sırasında gerçekleştirmeye çalıştığınız eylemi engelleyen bir kaynak ilkesi içerir. Eylemi engelleyen ilkeyi bulun. Mümkünse, ilkedeki sınırlamaları karşılamak için dağıtımınızı değiştirin. | İlkeleri çözümleme |
ReservedResourceName | Ayrılmış ad içermeyen bir kaynak adı sağlayın. | Ayrılmış kaynak adları |
ResourceGroupBeingDeleted | Silme işleminin tamamlanmasını bekleyin. | |
ResourceGroupNotFound | Dağıtım için hedef kaynak grubunun adını denetleyin. Hedef kaynak grubu aboneliğinizde zaten mevcut olmalıdır. Abonelik bağlamınızı denetleyin. | Azure CLIPowerShell |
ResourceNotFound | Dağıtımınız çözümlenebilen bir kaynağa başvurur. Başvuru işlevini kullanımınızın senaryonuz için gerekli parametreleri içerdiğini doğrulayın. | Başvuruları çözümleme |
ResourceQuotaExceeded | Dağıtım, abonelik, kaynak grubu veya bölge kotasını aşan kaynaklar oluşturmaya çalışıyor. Mümkünse altyapınızı kotaların içinde kalacak şekilde düzeltin. Aksi takdirde, kotalarınızda değişiklik isteğinde bulunmayı göz önünde bulundurun. | Kotaları çözme |
SkuNotAvailable | Seçtiğiniz konum için kullanılabilir olan SKU'yu (vm boyutu gibi) seçin. | SKU'yu çözümleme |
StorageAccountAlreadyTaken StorageAccountAlreadyExists |
Depolama hesabına benzersiz bir ad verin. | Depolama hesabı adlarıyla ilgili hataları düzeltme |
StorageAccountInAnotherResourceGroup | Depolama hesabına benzersiz bir ad verin. | Depolama hesabı adlarıyla ilgili hataları düzeltme |
StorageAccountNotFound | Kullanmaya çalıştığınız depolama hesabının aboneliğini, kaynak grubunu ve adını denetleyin. | |
Alt ağlarNotInSameVnet | Bir sanal makinede yalnızca bir sanal ağ olabilir. Birkaç NIC dağıtırken aynı sanal ağa ait olduklarından emin olun. | Windows VM birden çok NIC Linux VM birden çok NIC |
SubnetIsFull | Alt ağda kaynakları dağıtmak için yeterli kullanılabilir adres yok. Adresleri alt ağdan serbest bırakabilirsiniz, farklı bir alt ağ kullanabilir veya yeni bir alt ağ oluşturabilirsiniz. | Alt ağları yönetme ve Sanal ağ hakkında SSS Özel IP adresleri |
SubscriptionNotFound | Dağıtım için belirtilen aboneliğe erişilemiyor. Abonelik kimliği yanlış olabilir, şablonu dağıtan kullanıcının aboneliğe dağıtmak için yeterli izinleri olmayabilir veya abonelik kimliği yanlış biçimde olabilir. Kapsamlar arasında dağıtmak için ARM şablonu iç içe dağıtımları kullanırken aboneliğin GUID değerini sağlayın. | Kapsamlar arasında ARM şablonu dağıtma Kapsamlar arasında Bicep dosyası dağıtımı |
SubscriptionNotRegistered | Bir kaynak dağıtıldığında, kaynak sağlayıcısının aboneliğiniz için kayıtlı olması gerekir. Dağıtım için bir Azure Resource Manager şablonu kullandığınızda, kaynak sağlayıcısı aboneliğe otomatik olarak kaydedilir. Bazen otomatik kayıt zamanında tamamlanmaz. Bu aralıklı hatayı önlemek için dağıtımdan önce kaynak sağlayıcısını kaydedin. | Kaydı çözme |
SubscriptionRequestsThrottled | Azure Resource Manager istekleri abonelik düzeyinde veya kiracı düzeyinde kısıtlar. İşlemlerine özgü istekleri kısıtlamak gibi Microsoft.Compute kaynak sağlayıcıları da. Bir sınıra ulaşıldığında, yeni bir istek göndermeden önce beklemeniz gereken süreyi içeren bir ileti ve değer alırsınız. Örnek: Number of requests for subscription '<subscription-id-guid>' and operation '<resource provider>' exceeded the backend storage limit. Please try again after '6' seconds. HTTP yanıtı, başka bir istek göndermeden önce bekleyebilecek saniye sayısını belirten bir değere sahip gibi HTTP status code 429 Too Many Requests bir Retry-After ileti döndürür. |
Resource Manager isteklerini azaltma API azaltma hatalarını giderme - sanal makineler Azure Kubernetes Service azaltma |
TemplateResourceCircularDependency | Gereksiz bağımlılıkları kaldırın. | Döngüsel bağımlılıkları çözme |
TooManyTargetResourceGroups | Tek bir dağıtım için kaynak grubu sayısını azaltın. | Kapsamlar arasında ARM şablonu dağıtma Kapsamlar arasında Bicep dosyası dağıtımı |
Sonraki adımlar
- Doğrulama veya dağıtım hataları hakkında bilgi için bkz. Hata kodlarını bulma.
- Dağıtım sorunlarını giderme hakkında daha fazla bilgi edinmek için bkz. Hata ayıklama günlüğünü etkinleştirme.
- Dağıtım hatasının nedenini yalıtmak için bkz . Sorun giderme şablonu oluşturma.