Veelgestelde vragen over cli-fouten voor ontwikkelaars Azure

Dit artikel bevat oplossingen voor veelvoorkomende fouten die kunnen optreden bij het gebruik van de Azure Developer CLI (azd).

Autorisatieverzoek is mislukt voor roltoewijzingsschrijfbewerking

Foutmelding: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>'.'

Oorzaak: U beschikt niet over voldoende machtigingen om rollen toe te wijzen in het Azure-doelabonnement of de resourcegroep. Dit is gebruikelijk wanneer uw gebruikersaccount Contributor toegang heeft, maar geen toegang tot Owner of User Access Administrator heeft. Contributor hiermee kunt u resources maken, maar geen machtigingen verlenen (rollen toewijzen) aan deze resources.

Resolutie: Zorg ervoor dat uw account de rol Eigenaar of Beheerder van gebruikerstoegang heeft voor het abonnement of de resourcegroep waarnaar u implementeert. Als u deze rollen niet kunt krijgen, vraagt u een beheerder om de eerste implementatie of roltoewijzingen voor u uit te voeren. Zie Azure ingebouwde rollen voor meer informatie.

Roltoewijzing bestaat al

Foutmelding:The role assignment already exists.

Oorzaak: Deze fout treedt op wanneer de implementatie probeert een roltoewijzing te maken die al bestaat op de resource. Hoewel Azure Resource Manager (ARM)-implementaties idempotent zijn, kunnen bepaalde configuraties of racevoorwaarden in sjablonen deze fout activeren bij het opnieuw implementeren.

Resolutie: Deze fout is vaak onregelmatig of goedaardig.

1. Voer de implementatie opnieuw uit: Uitvoeren azd up of azd deploy opnieuw.
2. Check Bicep-sjablonen: Wanneer u de sjabloon onderhoudt, zorg ervoor dat roltoewijzingen geldige name eigenschappen gebruiken (vaak strikt deterministische GUID's) om idempotentie te waarborgen. Gebruik de functie guid() Bicep om deterministische namen te genereren.

Tenant-id, principal-id of bereik mag niet worden bijgewerkt

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

Oorzaak: U probeert een roltoewijzing opnieuw te implementeren met eigenschappen die verschillen van de bestaande toewijzing. Roltoewijzingen zijn onveranderbaar; u kunt de principal-id (de gebruiker/app die de rol ontvangt) of het bereik van een bestaande toewijzings-id niet wijzigen.

Resolutie:

1. Parameters verifiëren: Zorg ervoor dat u niet per ongeluk een andere principal-id doorgeeft (bijvoorbeeld schakelen tussen een gebruiker en een service-principal) voor dezelfde roltoewijzingsresource.
2. Clean up: Als u de toewijzing wilt wijzigen, verwijdert u handmatig de conflicterende roltoewijzing in de Azure portal of via CLI met behulp van az-roltoewijzing verwijderen en implementeert u deze opnieuw.

Regiocapaciteit of SKU niet beschikbaar

Foutbericht:The region 'eastus2' currently does not have enough resources available to provision services with the SKU 'standard'. (of 'basic')

Cause: De geselecteerde Azure regio heeft tijdelijk geen capaciteit meer voor de aangevraagde service-SKU. Dit is momenteel gebruikelijk bij AI-services (zoals Azure OpenAI) in populaire regio's zoals eastus2.

Resolutie:

1. Locatie wijzigen: Uitvoeren azd env set AZURE_LOCATION <new-region> om over te schakelen naar een regio met betere beschikbaarheid (bijvoorbeeld swedencentral, westus3). francecentral
2. Check availability: Gebruik de pagina Azure Products by Region of voer az account list-locations uit om te controleren op regio's waar de service en SKU beschikbaar zijn.

TPM-quotum overschreden voor AI-modellen

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

Cause: Uw abonnement heeft de quotumlimiet bereikt voor tokens per minuut (TPM) voor het opgegeven Azure OpenAI-model in de doelregio.

Resolutie:

1. Quotum: Vraag een quotumverhoging aan via de Azure AI Studio- of Azure-portal. Zie Manage Azure OpenAI Service quota voor meer informatie.
2. Modellen/regio wijzigen: Schakel over naar een regio waar u ongebruikt quotum hebt of gebruik een andere modelversie die binnen uw limieten past.

If-Match voorwaarde is mislukt

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

Oorzaak: Dit probleem duidt doorgaans op een gelijktijdigheidsconflict. Er zijn mogelijk twee processen bezig om tegelijkertijd dezelfde resource bij te werken, of uw lokale status is niet in overeenstemming met de cloudresource (verouderde ETag).

Resolutie: Voer de bewerking opnieuw uit. Als de fout aanhoudt:

1. Zorg ervoor dat er geen andere implementaties (CI/CD-pijplijnen, andere collega's) tegelijkertijd op dezelfde omgeving zijn gericht.
2. Als u Bicep gebruikt, controleert u of uw sjabloon afhankelijkheden (dependsOn) correct definieert om parallelle wijzigingen in dezelfde resource te voorkomen.

Cognitive Services-account met status Geaccepteerd

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

Cause: Deze fout is een timingprobleem waarbij een afhankelijke resource probeert te communiceren met het Account Cognitive Services (Azure AI) voordat deze volledig is ingericht en actief is. U kunt ook een opdrachthook (bijvoorbeeld postprovision) toevoegen in uw azure.yaml om te pauzeren of de gereedheid van resources te controleren voordat u verdergaat.

De beschikbaarheid van de container-app-revisie is verlopen

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

Cause: De Azure Container App kan niet worden gestart binnen de standaardtime-outperiode. Veelvoorkomende redenen zijn onder meer:

• De containerimage is te groot en duurt te lang om te downloaden.
• De toepassing loopt vast bij het opstarten.
• Het duurt te lang voordat de toepassing luistert op de geconfigureerde poort.

Resolutie:

1. Logboeken controleren: Bekijk de containerlogboeken in de Azure-portal (Log Stream) of gebruik azd monitor om te zien of de app vastloopt.
2. Configuratie controleren: Zorg ervoor dat de targetPort in uw configuratie overeenkomen met de poort waarop uw app luistert. Zie Roubleshooting Azure Container Apps voor meer stappen voor probleemoplossing.
3. Logboeken controleren: Bekijk de containerlogboeken in de Azure-portal (Log Stream) of gebruik azd monitor om te zien of de app vastloopt.
4. Configuratie controleren: Zorg ervoor dat de targetPort in uw configuratie overeenkomen met de poort waarop uw app luistert.
5. Afbeelding optimaliseren: Verklein de grootte van uw containerafbeelding om het ophalen te versnellen.