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. Belge geri bildiriminizi sağlayın, ancak GitHub sorunları herkese açık olduğundan 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 beklenenlerle eşleşmeyen dağıtım değerleri gönderdiniz. Sorun gidermeyle ilgili yardım için iç durum iletisini denetleyin. Var olan bir Azure kaynağından dışarı aktarılan bir şablon 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 izinleriniz 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 |
DeploymentJobSizeExceededed | Boyutu küçültmek için şablonunuzu basitleştirin. | Şablon boyutu hatalarını çözme |
DnsRecordInUse | DNS kayıt adı benzersiz olmalıdır. Farklı bir ad girin. | |
ImageNotFound | VM görüntü 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 sorun nedeniyle. Dağıtımı yeniden deneyin. | |
InUseSubnetCannotBeDeleted | Bu hata, bir kaynağı güncelleştirmeye çalıştığınızda, istek işlemi silip kaynağı 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 iç içe yerleştirilmiş bir ş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ğerler içerir veya gerekli değerler eksiktir. Kaynak türünüz için değerleri 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 bulunulamıyor. 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ı çözme |
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 |
LocationRequired | Kaynak için bir konum belirtin. | ARM şablonunda kaynak konumu Bicep dosyasında kaynak konumu |
MismatchingResourceSegments | İç içe yerleştirilmiş bir kaynağın ad ve tür olarak doğru sayıda kesime sahip olduğundan emin olun. | Kaynak kesimlerini çö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, belirtilen SKU üzerinde izin verilmeyen bir işlem deneniyor. 2. Dağıtım, abonelik, kaynak grubu veya bölge kotasını aşan bir işlem gerçekleştirmeye çalışır. 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 parola değerinizi parametre olarak geçirmeden önce 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 tarafından gereken bir adres aralığı 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ığında 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 bir 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 çözme |
ReservedResourceName | Ayrılmış ad içermeyen bir kaynak adı belirtin. | 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 CLI PowerShell |
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 yapmayı göz önünde bulundurun. | Kotaları çözme |
SkuNotAvailable | Seçtiğiniz konum için kullanılabilen 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 yayınlayabilir, 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. Bu, abonelik kimliğinin yanlış olması, şablonu dağıtan kullanıcının aboneliğe dağıtmak için yeterli izinlere sahip olmaması veya abonelik kimliğinin yanlış biçimde olması olabilir. Kapsamlar arasında dağıtmak için ARM şablonu iç içe dağıtımları kullanırken aboneliğin GUID'sini 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 kaydedilmesi 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. Kaynak sağlayıcıları da Microsoft.Compute işlemlerine özgü istekleri kısıtlamayı sever. 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. Örneğin: 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 bekleyebilecekleri saniye sayısını belirten bir değerle 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.