Vanliga frågor och svar om cli-fel för Azure utvecklare

Den här artikeln innehåller lösningar på vanliga fel som kan uppstå när du använder CLI för Azure Developer (azd).

Auktoriseringen misslyckades för rolltilldelningsskrivning

Felmeddelande: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: Du har inte tillräcklig behörighet för att tilldela roller i målprenumerationen för Azure eller resursgruppen. Detta är vanligt när ditt användarkonto har Contributor åtkomst men inte Owner eller User Access Administrator åtkomst. Contributor gör att du kan skapa resurser men inte bevilja behörigheter (tilldela roller) till dessa resurser.

Upplösning: Kontrollera att ditt konto har rollen Ägare eller Administratör för användaråtkomst för den prenumeration eller resursgrupp som du distribuerar till. Om du inte kan beviljas dessa roller ber du en administratör att utföra de inledande distributions- eller rolltilldelningarna åt dig. För mer information, se Azure inbyggda roller.

Rolltilldelningen finns redan

Felmeddelande:The role assignment already exists.

Orsaka: Det här felet uppstår när distributionen försöker skapa en rolltilldelning som redan finns på resursen. Även om Azure Resource Manager -distributioner (ARM) är idempotenter kan vissa konfigurationer eller konkurrensvillkor i mallar utlösa det här felet vid omdistribution.

Upplösning: Det här felet är ofta tillfälligt eller ofarligt.

1. Försök att distribuera igen: Kör azd up eller azd deploy igen.
2. Kontrollera Bicep-mallar: Om du hanterar mallen, se till att rolltilldelningarna använder giltiga egenskaper (ofta strikt deterministiska GUIDs) för att säkerställa idempotens. Använd funktionen guid() Bicep för att generera deterministiska namn.

Får inte uppdateras: tenant-ID, principal-ID eller omfång

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

Orsaka: Du försöker distribuera om en rolltilldelning med egenskaper som skiljer sig från den befintliga tilldelningen. Rolltilldelningar är oföränderliga. Du kan inte ändra huvud-ID :t (användaren/appen som tar emot rollen) eller omfattningen för ett befintligt tilldelnings-ID.

Upplösning:

1. Verifiera parametrar: Kontrollera att du inte oavsiktligt skickar ett annat huvudnamns-ID (till exempel växla mellan en användare och ett huvudnamn för tjänsten) för samma rolltilldelningsresurs.
2. Clean up: Om du behöver ändra tilldelningen, ta manuellt bort den konfliktande rolltilldelningen i Azure-portalen eller via CLI med hjälp av az role assignment delete, och distribuera sedan på nytt.

Regionkapacitet eller SKU är inte tillgänglig

Felmeddelande:The region 'eastus2' currently does not have enough resources available to provision services with the SKU 'standard'. (eller "grundläggande")

Cause: Den valda Azure regionen har tillfälligt slut på kapacitet för den begärda tjänst-SKU:n. Detta är för närvarande vanligt med AI-tjänster (till exempel Azure OpenAI) i populära regioner som eastus2.

Upplösning:

1. Ändra plats: Kör azd env set AZURE_LOCATION <new-region> för att växla till en region med bättre tillgänglighet (till exempel swedencentral, westus3, francecentral).
2. Checka tillgänglighet: Använd sidan Azure Products by Region eller kör az account list-locations för att söka efter regioner där tjänsten och SKU:n är tillgängliga.

TPM-kvoten har överskridits för AI-modeller

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

Cause: Din prenumeration har nått sin kvotgräns för token per minut (TPM) för den angivna Azure OpenAI-modellen i målregionen.

Upplösning:

1. Request Quota: Begär en kvotökning via Azure AI Studio eller Azure portalen. Mer information finns i Hantera Azure OpenAI Service kvot.
2. Ändra modeller/region: Växla till en region där du har en oanvänd kvot eller använd en annan modellversion som passar inom dina gränser.

If-Match förhandsvillkor misslyckades

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

Orsaka: Det här problemet indikerar vanligtvis en samtidighetskonflikt. Två processer kanske försöker uppdatera samma resurs samtidigt, eller så är din lokala konfiguration inte synkroniserad med molnresursen (föråldrad ETag).

Upplösning: Försök utföra åtgärden igen. Om felet kvarstår:

1. Se till att inga andra distributioner (CI/CD-pipelines, andra kollegor) riktar in sig på samma miljö samtidigt.
2. Om du använder Bicep kontrollerar du att mallen korrekt definierar beroenden (dependsOn) för att förhindra parallella ändringar av samma resurs.

Cognitive Services-konto i tillståndet Accepterad

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

Cause: Det här felet är ett tidsfel där en beroende resurs försöker interagera med Cognitive Services-kontot (Azure AI) innan det är helt etablerat och aktivt. Du kan också lägga till en kommandokrok (till exempel postprovision) i din azure.yaml för att pausa eller söka efter resursberedskap innan du fortsätter.

Containerappens revisionsetablering har upphört att gälla

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

Cause: Det gick inte att starta Azure Container App inom standardtidsintervallet. Vanliga orsaker:

• Containeravbildningen är för stor och tar för lång tid att ladda ner.
• Programmet kraschar vid start.
• Programmet tar för lång tid att lyssna på den konfigurerade porten.

Upplösning:

1. Checka loggar: Visa containerloggarna i Azure-portalen (Log Stream) eller använd azd monitor för att se om appen kraschar.
2. Granska konfiguration: Se till att det i din konfiguration targetPort matchar den port som din app lyssnar på. Fler felsökningssteg finns i Felsökning Azure Container Apps
3. Checka loggar: Visa containerloggarna i Azure-portalen (Log Stream) eller använd azd monitor för att se om appen kraschar.
4. Granska konfigurationen: Se till att targetPort i din konfiguration matchar den port som appen lyssnar på.
5. Optimera bild: Minska storleken på containerbilden för att snabba upp hämtningen.