Delen via

Foutcodes zoeken

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 nieuwste 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 preflight-fouten identificeren door validatietests uit te voeren met Azure PowerShell of Azure CLI.

Een ARM-sjabloon kan vanuit de portal worden geïmplementeerd. 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.

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

Selecteer het bericht voor meer informatie. De sjabloon heeft een syntaxisfout met foutcode InvalidTemplate. In de samenvatting wordt aangegeven dat er een expressie ontbreekt en dat er een haakje sluiten ontbreekt.

Schermafbeelding 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 de validatie doorstaat, maar tijdens de implementatie mislukt. 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 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.

    Schermafbeelding van het activiteitenlogboek van de resourcegroep van de Azure Portal, waarbij een mislukte implementatie wordt benadrukt met een foutenlogboek.

  5. Selecteer het foutenlogboek om de details van de bewerking weer te geven.

    Schermafbeelding van de details van het activiteitenlogboek in de Azure Portal, met het foutbericht en de bewerkingsdetails 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.

    Schermafbeelding 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.

    Schermafbeelding van een overzicht van implementatiefouten in de Azure Portal, met het foutbericht en de foutcode NoRegisteredProviderFound.

Volgende stappen

  • Last updated on