Dela via

Hitta felkoder

När en Azure-resursdistribution misslyckas med att använda Azure Resource Manager-mallar (ARM-mallar) eller Bicep-filer tas en felkod emot. I den här artikeln beskrivs hur du hittar felkoder så att du kan felsöka problemet. Mer information om felkoder finns i vanliga distributionsfel.

Feltyper

Det finns två typer av fel som rör en distribution:

  • Valideringsfel inträffar innan en distribution påbörjas och orsakas av syntaxfel i filen. En kodredigerare som Visual Studio Code kan identifiera dessa fel.
  • Valideringsfel före start inträffar när ett distributionskommando körs men resurser inte distribueras. Dessa fel påträffas utan att distributionen startas. Om ett parametervärde till exempel är felaktigt, hittas felet i valideringen före start.
  • Distributionsfel uppstår under distributionsprocessen och kan bara hittas genom att utvärdera distributionens förlopp i Din Azure-miljö.

Båda typerna av fel returnerar en felkod som du använder för att felsöka distributionen. Valideringsfel och fel före start visas i aktivitetsloggen men visas inte i distributionshistoriken. En Bicep-fil med syntaxfel kompileras inte till JSON och visas inte i aktivitetsloggen.

Om du vill identifiera syntaxfel kan du använda Visual Studio Code med det senaste Bicep-tillägget eller Azure Resource Manager Tools-tillägget.

Valideringsfel

Mallar verifieras under distributionsprocessen och felkoder visas. Innan du kör en distribution kan du identifiera verifierings- och preflight-fel genom att köra valideringstester med Azure PowerShell eller Azure CLI.

En ARM-mall kan distribueras från portalen. Om mallen har syntaxfel visas ett verifieringsfel när du försöker köra distributionen. Mer information om portaldistributioner finns i distribuera resurser från en anpassad mall.

Följande exempel försöker distribuera ett lagringskonto och ett verifieringsfel inträffar.

Skärmbild av ett valideringsfel i Azure-portalen för ett distributionsförsök för lagringskontot.

Välj meddelandet för mer information. Mallen har ett syntaxfel med felkoden InvalidTemplate. Sammanfattningen visar att ett uttryck saknar en avslutande parentes.

Skärmbild av ett valideringsfelmeddelande i Azure-portalen som visar ett syntaxfel med felkoden InvalidTemplate.

Distributionsfel

Flera åtgärder bearbetas för att distribuera en Azure-resurs. Distributionsfel uppstår när en åtgärd godkänns men misslyckas under distributionen. Du kan visa meddelanden om varje distributionsåtgärd och varje distribution för en resursgrupp.

Om du vill se meddelanden om en distributions åtgärder använder du resursgruppens aktivitetslogg:

  1. Logga in på Azure-portalen.

  2. Gå till Resursgrupper och välj distributionens resursgruppsnamn.

  3. Välj Aktivitetslogg.

  4. Använd filtren för att hitta en åtgärds fellogg.

    Skärmbild av aktivitetsloggen för Azure-portalens resursgrupp som betonar en misslyckad distribution med en fellogg.

  5. Välj felloggen för att se åtgärdens information.

    Skärmbild av aktivitetslogginformationen i Azure-portalen som visar felmeddelandet och åtgärdsinformationen för en misslyckad distribution.

Så här visar du resultatet för en distribution:

  1. Gå till resursgruppen.

  2. Välj Inställningar>Distributioner.

  3. Välj Felinformation för distributionen.

    Skärmbild av distributionsavsnittet för en resursgrupp i Azure-portalen, som visar en länk till felinformation för en misslyckad distribution.

  4. Felmeddelandet och felkoden NoRegisteredProviderFound visas.

    Skärmbild av en sammanfattning av distributionsfel i Azure-portalen som visar felmeddelandet och felkoden NoRegisteredProviderFound.

Nästa steg