Azure Geliştirici CLI Hataları hakkında SSS

Bu makalede, Azure Geliştirici CLI'sını (azd) kullanırken karşılaşabileceğiniz yaygın hatalar için çözümler sağlanır.

Rol ataması yazma için yetkilendirme başarısız oldu

Hata mesajı:The template deployment failed with error: 'Authorization failed for template resource '<guid>' of type 'Microsoft.Authorization/roleAssignments'. The client '##Email##' with object id '<guid>' does not have permission to perform action 'Microsoft.Authorization/roleAssignments/write' at scope '<resourceId>'.'

Cause: Hedef Azure aboneliğinde veya kaynak grubunda rol atamak için yeterli izniniz yok. Bu durum, kullanıcı hesabınızın Contributor erişimi olup Owner veya User Access Administrator erişimi olmadığı zaman sık karşılaşılan bir durumdur. Contributor kaynakları oluşturmanıza izin verir, ancak bu kaynaklara izin vermez (rol ataması yapamazsınız).

Çözünürlük: Hesabınızın, dağıttığınız abonelikte veya kaynak grubunda Sahip veya Kullanıcı Erişimi Yöneticisi rolüne sahip olduğundan emin olun. Bu roller size verilemiyorsa, bir yöneticiden sizin için ilk dağıtım veya rol atamalarını gerçekleştirmesini isteyin. Daha fazla bilgi için bkz. Azure yerleşik roller.

Rol ataması zaten var

Hata mesajı:The role assignment already exists.

Neden: Bu hata, dağıtım kaynakta zaten var olan bir rol ataması oluşturmaya çalıştığında oluşur. Azure Resource Manager (ARM) dağıtımları idempotent olsa da, şablonlardaki bazı yapılandırmalar veya yarış koşulları, yeniden dağıtım sırasında bu hatayı tetikleyebilir.

Çözünürlük: Bu hata genellikle aralıklı veya zararsızdır.

1. Dağıtımı yeniden deneyin: Veya azd up yeniden çalıştırınazd deploy.
2. Bicep şablonlarını denetleyin: Şablonu yönetiyorsanız rol atamalarının geçerli name özelliklerini (genellikle kesin deterministik GUID'ler) kullandığından emin olun. Belirleyici adlar oluşturmak için guid() Bicep işlevini kullanın.

Kiracı kimliği, asıl kimlik veya kapsamın güncelleştirilmesine izin verilmiyor

Hata mesajı:Tenant ID, application ID, principal ID, and scope are not allowed to be updated.

Neden: Mevcut atamadan farklı özelliklere sahip bir rol atamasını yeniden dağıtmaya çalışıyorsunuz. Rol atamaları sabittir; asıl kimliği (rolü alan kullanıcı/uygulama) veya mevcut atama kimliğinin kapsamını değiştiremezsiniz.

Çözünürlük:

1. Parametreleri doğrulayın: Aynı rol ataması kaynağı için yanlışlıkla farklı bir asıl kimlik (örneğin, kullanıcı ve hizmet birimi arasında geçiş yapma) geçirmediğinizden emin olun.
2. Temizlik: Atamayı değiştirmeniz gerekiyorsa, çakışan rol atamasını Azure portalında veya CLI aracılığıyla az rol ataması silme kullanarak el ile silin ve ardından yeniden dağıtım yapın.

Bölge kapasitesi veya Ürün Stok Kodu (SKU) mevcut değil

Hata iletisi:The region 'eastus2' currently does not have enough resources available to provision services with the SKU 'standard'. (veya 'temel')

Cause: Seçilen Azure bölgesi, istenen hizmet SKU'su için geçici olarak yetersiz. Bu durum şu anda eastus2 gibi popüler bölgelerdeki yapay zeka hizmetlerinde (Azure OpenAI gibi) yaygındır.

Çözünürlük:

1. Konumu değiştir: Daha iyi kullanılabilirliğe sahip bir bölgeye (örneğin, azd env set AZURE_LOCATION <new-region>, , swedencentralwestus3) geçmek için komutunu çalıştırınfrancecentral.
2. Kullanılabilirliği denetleyin:Azure Bölgeye Göre Ürünler sayfasını kullanın veya hizmetin ve SKU'nun kullanılabilir olduğu bölgeleri denetlemek için az account list-locations çalıştırın.

Yapay zeka modelleri için TPM kotası aşıldı

Hata mesajı:This operation require <amount> new capacity in quota Tokens Per Minute (thousands) - <model> - GlobalStandard, which is bigger than the current available capacity <available>.

Cause: Aboneliğiniz hedef bölgede belirtilen Azure OpenAI modeli için Dakika Başına Belirteçler (TPM) kota sınırına ulaştı.

Çözünürlük:

1. Request Quota:Azure AI Studio veya Azure portalı aracılığıyla kota artışı isteyin. Daha fazla bilgi için bkz. Azure OpenAI Service kotasını yönetme.
2. Modelleri/Bölgeyi Değiştir: Kullanılmayan kotanızın olduğu bir bölgeye geçin veya sınırlarınıza uygun farklı bir model sürümü kullanın.

If-Match önkoşulu başarısız oldu

Hata mesajı:The specified precondition 'If-Match = ""<guid>""' failed.

Neden: Bu sorun genellikle eşzamanlılık çakışması olduğunu gösterir. İki işlem aynı kaynağı aynı anda güncelleştirmeye çalışıyor olabilir veya yerel durumunuz bulut kaynağıyla eşitlenmemiş olabilir (eski ETag).

Çözünürlük: İşlemi yeniden deneyin. Eğer hata devam ederse:

1. Başka hiçbir dağıtımın (CI/CD işlem hatları, diğer iş arkadaşları) aynı ortamı aynı anda hedeflemediğinden emin olun.
2. Bicep kullanıyorsanız, şablonunuzun aynı kaynakta paralel değişiklikler yapılmasını önlemek için bağımlılıkları (dependsOn) doğru tanımladığını doğrulayın.

Kabul Edildi durumundaki Bilişsel Hizmetler hesabı

Hata mesajı:Call to Microsoft.CognitiveServices/accounts failed. Error message: Account <resourceId> in state Accepted.

Cause: Bu hata, bağımlı bir kaynağın tam olarak sağlanıp etkin hale gelmeden önce Bilişsel Hizmetler (Azure AI) hesabıyla etkileşim kurmaya çalıştığı bir zamanlama sorunudur. Devam etmeden önce kaynak hazırlığını duraklatmak veya denetlemek için komutunuza bir postprovision (örneğin, azure.yaml) ekleyebilirsiniz.

Kapsayıcı uygulama revizyonu süresi sona erdi

Hata mesajı:Failed to provision revision for container app <appName>. Error details: Operation expired.

Cause: Azure Kapsayıcı Uygulaması varsayılan zaman aşımı süresi içinde başlatılamadı. Yaygın nedenler şunları içerir:

• Kapsayıcı görüntüsü çok büyük ve çekmesi çok uzun sürüyor.
• Uygulama başlatıldığında kilitleniyor.
• Uygulamanın yapılandırılan bağlantı noktasını dinlemesi çok uzun sürüyor.

Çözünürlük:

1. Günlükleri Kontrol Et: Uygulamanın çöküp çökmediğini görmek için Azure portalındaki kapsayıcı günlüklerini (Günlük Akışı) veya azd monitor kullanarak görüntüleyin.
2. Yapılandırmayı Gözden Geçir: Yapılandırmanızdaki targetPort değeri uygulamanızın dinlediği port ile eşleşiyor olduğundan emin olun. Daha fazla sorun giderme adımı için Bkz. Azure Container Apps için Sorun Giderme
3. Günlükleri Kontrol Et: Uygulamanın çöküp çökmediğini görmek için Azure portalındaki kapsayıcı günlüklerini (Günlük Akışı) veya azd monitor kullanarak görüntüleyin.
4. Yapılandırmayı Gözden Geçir: Yapılandırmanızdaki targetPort değeri uygulamanızın dinlediği port ile eşleşiyor olduğundan emin olun.
5. Görüntüyü İyileştir: Çekme işlemini hızlandırmak için kapsayıcı görüntünüzün boyutunu küçültün.