Delen via

Foutcodes zoeken

  • Artikel

Wanneer de implementatie van een Azure-resource mislukt met behulp van Azure Resource Manager-sjablonen (ARM-sjablonen) of Bicep-bestanden, wordt er een foutcode ontvangen. In dit artikel wordt beschreven hoe u foutcodes kunt vinden, zodat u het probleem kunt oplossen. Zie Veelvoorkomende implementatiefouten voor meer informatie over foutcodes.

Fouttypen

Er zijn drie typen fouten die gerelateerd zijn aan een implementatie:

  • Validatiefouten treden op voordat een implementatie begint en worden veroorzaakt door syntaxisfouten in uw bestand. Een code-editor zoals Visual Studio Code kan deze fouten identificeren.
  • Preflight-validatiefouten treden op wanneer een implementatieopdracht wordt uitgevoerd, maar resources niet worden geïmplementeerd. Deze fouten worden gevonden zonder de implementatie te starten. Als een parameterwaarde bijvoorbeeld onjuist is, wordt de fout gevonden in de validatie vooraf.
  • Implementatiefouten treden op tijdens het implementatieproces en kunnen alleen worden gevonden door de voortgang van de implementatie in uw Azure-omgeving te beoordelen.

Beide typen fouten retourneren een foutcode die je gebruikt om de problemen met de implementatie op te lossen. Validatie- en voorbereidende fouten worden weergegeven in het activiteitenlogboek, maar worden niet weergegeven in je implementatiegeschiedenis. Een Bicep-bestand met syntaxisfouten wordt niet gecompileerd in JSON en wordt niet weergegeven in het activiteitenlogboek.

Als u syntaxisfouten wilt identificeren, kunt u Visual Studio Code gebruiken met de meest recente Bicep-extensie of azure Resource Manager Tools-extensie.

Validatiefouten

Sjablonen worden gevalideerd tijdens het implementatieproces en foutcodes worden weergegeven. Voordat u een implementatie uitvoert, kunt u validatie- en voorbereidende fouten identificeren door validatietests uit te voeren met Azure PowerShell of Azure CLI.

Een ARM-sjabloon kan worden geïmplementeerd vanuit de portal. Als de sjabloon syntaxisfouten bevat, ziet u een validatiefout wanneer u de implementatie probeert uit te voeren. Zie Resources implementeren vanuit een aangepaste sjabloon voor meer informatie over portalimplementaties.

In het volgende voorbeeld wordt geprobeerd een opslagaccount te implementeren en treedt er een validatiefout op.

Schermopname van een validatiefout in de Azure Portal voor een implementatiepoging van een opslagaccount.

Selecteer het bericht voor meer informatie. De sjabloon heeft een syntaxisfout met foutcode InvalidTemplate. In De Samenvatting ziet u dat een expressie een haakje sluiten mist.

Schermopname van een validatiefoutbericht in de Azure Portal, met een syntaxisfout met foutcode InvalidTemplate.

Implementatiefouten

Er worden verschillende bewerkingen verwerkt om een Azure-resource te implementeren. Implementatiefouten treden op wanneer een bewerking is gevalideerd, maar mislukt tijdens de implementatie. U kunt berichten weergeven over elke implementatiebewerking en elke implementatie voor een resourcegroep.

Als u berichten over de bewerkingen van een implementatie wilt bekijken, gebruikt u het activiteitenlogboek van de resourcegroep:

  1. Meld u aan bij de Azure-portal.

  2. Ga naar Resourcegroepen en selecteer de naam van de resourcegroep van de implementatie.

  3. Selecteer Activiteitenlogboek.

  4. Gebruik de filters om het foutenlogboek van een bewerking te vinden.

    Schermopname van het activiteitenlogboek van de resourcegroep van de Azure Portal, met de nadruk op een mislukte implementatie met een foutenlogboek.

  5. Selecteer het foutenlogboek om de details van de bewerking te bekijken.

    Schermopname van de details van het activiteitenlogboek in de Azure Portal, met het foutbericht en de bewerkingsgegevens van een mislukte implementatie.

Het resultaat van een implementatie weergeven:

  1. Ga naar de resourcegroep.

  2. Selecteer Instellingen>Implementaties.

  3. Selecteer Foutdetails voor de implementatie.

    Schermopname van de sectie implementaties van een resourcegroep in de Azure Portal, met een koppeling naar foutdetails voor een mislukte implementatie.

  4. Het foutbericht en de foutcode NoRegisteredProviderFound worden weergegeven.

    Schermopname van een samenvatting van een implementatiefout in de Azure Portal, met het foutbericht en de foutcode NoRegisteredProviderFound.

Volgende stappen