FAQ zu Azure Entwickler-CLI-Fehlern

Dieser Artikel enthält Lösungen für häufige Fehler, die bei Verwendung der Azure Developer CLI (azd) auftreten können.

Autorisierungsfehler beim Schreiben von Rollenzuweisungen

Fehlermeldung: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: Sie verfügen nicht über ausreichende Berechtigungen zum Zuweisen von Rollen im Zielabonnement oder der Ressourcengruppe Azure. Dies ist üblich, wenn Ihr Benutzerkonto Contributor Zugriff hat, aber nicht auf Owner oder User Access Administrator. Contributor ermöglicht ihnen das Erstellen von Ressourcen, aber nicht das Erteilen von Berechtigungen (Zuweisen von Rollen) zu diesen Ressourcen.

Auflösung: Stellen Sie sicher, dass Ihr Konto über die Rolle "Besitzer" oder " Benutzerzugriffsadministrator " in der Abonnement- oder Ressourcengruppe verfügt, für die Sie bereitstellen. Wenn Ihnen diese Rollen nicht erteilt werden können, bitten Sie einen Administrator, die anfängliche Bereitstellung oder Rollenzuweisungen für Sie auszuführen. Weitere Informationen finden Sie unter Azure integrierte Rollen.

Rollenzuweisung existiert bereits

Fehlermeldung:The role assignment already exists.

Ursache: Dieser Fehler tritt auf, wenn die Bereitstellung versucht, eine Rollenzuweisung zu erstellen, die bereits in der Ressource vorhanden ist. Während Azure Resource Manager (ARM)-Bereitstellungen idempotent sind, können bestimmte Konfigurationen oder Wettlaufbedingungen in Vorlagen diesen Fehler bei der erneuten Bereitstellung auslösen.

Auflösung: Dieser Fehler ist häufig zeitweise oder harmlos.

1. Wiederholen Sie die Bereitstellung: Führen Sie azd up oder azd deploy erneut aus.
2. Check Bicep templates: Wenn Sie die Vorlage verwalten, stellen Sie sicher, dass Rollenzuweisungen gültige name-Eigenschaften (häufig streng deterministische GUIDs) verwenden, um die Idempotenz sicherzustellen. Verwenden Sie die Funktion guid() Bicep, um deterministische Namen zu generieren.

Mandanten-ID, Prinzipal-ID oder Geltungsbereich dürfen nicht aktualisiert werden

Fehlermeldung:Tenant ID, application ID, principal ID, and scope are not allowed to be updated.

Ursache: Sie versuchen, eine Rollenzuweisung mit Eigenschaften erneut bereitzustellen, die sich von der vorhandenen Zuordnung unterscheiden. Rollenzuweisungen sind unveränderlich; Sie können die Prinzipal-ID (der Benutzer/die App, die die Rolle empfängt) oder den Bereich einer vorhandenen Zuordnungs-ID nicht ändern.

Lösung:

1. Parameter überprüfen: Stellen Sie sicher, dass Sie nicht versehentlich eine unterschiedliche Prinzipal-ID übergeben (zum Beispiel beim Wechseln zwischen einem Benutzer und einem Dienstprinzipal) für dieselbe Rollenzuweisungsressource.
2. Clean up: Wenn Sie die Zuordnung ändern müssen, löschen Sie die konfliktbehaftete Rollenzuweisung im Azure-Portal oder über die CLI mithilfe von az role assignment delete, und führen Sie dann eine erneute Bereitstellung durch.

Regionskapazität oder SKU nicht verfügbar

Fehlermeldung:The region 'eastus2' currently does not have enough resources available to provision services with the SKU 'standard'. (oder 'einfach')

Cause: Die ausgewählte Azure-Region hat vorübergehend keine Kapazität für die angeforderte Dienst-SKU. Dies ist derzeit mit KI-Diensten (wie Azure OpenAI) in beliebten Regionen wie eastus2 üblich.

Lösung:

1. Ort ändern: Führen Sie azd env set AZURE_LOCATION <new-region> aus, um zu einer Region mit besserer Verfügbarkeit zu wechseln (z. B. swedencentral, westus3, francecentral).
2. Überprüfung der Verfügbarkeit: Verwenden Sie die Seite Azure Produkte nach Region oder führen Sie az account list-locations aus, um nach Regionen zu suchen, in denen der Dienst und die SKU verfügbar sind.

TPM-Kontingent für KI-Modelle überschritten

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

Cause: Ihr Abonnement hat sein Kontingentlimit für Token pro Minute (TPM) für das angegebene Azure OpenAI-Modell in der Zielregion erreicht.

Lösung:

1. Request Quota: Fordern Sie eine Kontingenterhöhung über das Azure AI Studio oder Azure Portal an. Weitere Informationen finden Sie unter Manage Azure OpenAI Service Kontingent.
2. Modelle/Region ändern: Wechseln Sie zu einer Region, in der Sie ein nicht genutztes Kontingent haben, oder verwenden Sie eine andere Modellversion, die in Ihre Grenzen passt.

If-Match-Vorbedingung fehlgeschlagen

Fehlermeldung:The specified precondition 'If-Match = ""<guid>""' failed.

Ursache: Dieses Problem weist in der Regel auf einen Parallelitätskonflikt hin. Zwei Prozesse versuchen möglicherweise, dieselbe Ressource gleichzeitig zu aktualisieren, oder Ihr lokaler Zustand ist nicht mit der Cloudressource synchronisiert (veraltetes ETag).

Auflösung: Wiederholen Sie den Vorgang. Wenn der Fehler weiterhin besteht:

1. Stellen Sie sicher, dass keine anderen Bereitstellungen (CI/CD-Pipelines, andere Kollegen) gleichzeitig auf dieselbe Umgebung ausgerichtet sind.
2. Stellen Sie bei Verwendung von Bicep sicher, dass ihre Vorlage Abhängigkeiten (dependsOn) ordnungsgemäß definiert, um parallele Änderungen an derselben Ressource zu verhindern.

Cognitive Services-Konto im Status der Akzeptiert

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

Cause: Dieser Fehler ist ein Zeitproblem, bei dem eine abhängige Ressource versucht, mit dem Cognitive Services-Konto (Azure AI) zu interagieren, bevor es vollständig bereitgestellt und aktiv ist. Sie können auch einen Befehlshaken (z. B. postprovision) in Ihrer azure.yaml hinzufügen, um die Ressourcenbereitschaft anzuhalten oder zu überprüfen, bevor Sie fortfahren.

Die Bereitstellung der Container-App-Revision ist abgelaufen.

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

Cause: Die Azure Container-App konnte nicht innerhalb des Standardtimeoutzeitraums gestartet werden. Häufige Ursachen:

• Das Containerimage ist zu groß und benötigt zu lange, um abgerufen zu werden.
• Die Anwendung stürzt beim Start ab.
• Die Anwendung braucht zu lange, um auf dem konfigurierten Port zu lauschen.

Lösung:

1. Check logs: Zeigen Sie die Containerprotokolle im Azure Portal (Log Stream) an, oder verwenden Sie azd monitor, um festzustellen, ob die App abstürzt.
2. Konfiguration überprüfen: Stellen Sie sicher, dass die targetPort Konfiguration mit dem Port übereinstimmt, auf den Ihre App lauscht. Weitere Schritte zur Problembehandlung finden Sie unter Troubleshooting Azure Container Apps
3. Check logs: Zeigen Sie die Containerprotokolle im Azure Portal (Log Stream) an, oder verwenden Sie azd monitor, um festzustellen, ob die App abstürzt.
4. Konfiguration überprüfen: Stellen Sie sicher, dass die targetPort Konfiguration mit dem Port übereinstimmt, auf den Ihre App lauscht.
5. Bild optimieren: Verringern Sie die Größe Ihres Containerimages, um das Pulling zu beschleunigen.