Felsöka felkoder för körning av Storage Mover-jobb

En Azure Storage Mover-agent använder strängstatuskoder för status som förmedlas till slutanvändaren. Alla statuskoder har prefixet AZSM följt av fyra decimalsiffror. Den första decimaltecknet anger statusens omfång på hög nivå. Varje statuskod ska tillhöra något av följande omfång:

• Status som gäller för hela agenten.
  Dessa koder använder omfångssiffran 0, och därför och har prefixet AZSM0.
• Status som gäller för ett visst jobb som körs av agenten.
  Dessa koder använder omfångssiffran 1 och har därför prefixet AZSM1.
• Status som kan anges av agenten för en specifik fil eller katalog som överförs av ett jobb som körs av agenten.
  Dessa koder använder omfångssiffran 2 och har därför prefixet AZSM2.

Var och en av dessa omfång delar ytterligare in status i kategorier och underkategorier. Varje underkategori reserverar vanligtvis 20 statuskoder för framtida expansion.

Dricks

AZSM0000 är den särskilda omfångsagnostiska statuskoden som anger lyckad åtgärd och bör användas för att beteckna lyckade åtgärder på alla omfång/nivåer.

Felkod	Felmeddelande	Information/Felsökningssteg/Åtgärd
AZSM1001	Det gick inte att montera källsökvägen	Kontrollera att det angivna servernamnet eller IP-adressen är giltigt eller att källplatsen är korrekt. Om du använder SMB kontrollerar du att det angivna användarnamnet och lösenordet är korrekt.
AZSM1002	Ett fel uppstod vid genomsökning av källan	Försök igen eller skapa ett supportärende.
AZSM1003	Det gick inte att komma åt källmappen på grund av behörighetsproblem	Kontrollera att agenten har beviljats behörighet till källfilresursen.
AZSM1004	Den angivna källsökvägen är ogiltig	Skapa en ny slutpunkt med en giltig källresurssökväg och uppdatera jobbdefinitionen och försök igen.
AZSM1020	Diverse fel vid åtkomst till källan	Det här felet rapporteras av vilken anledning som helst som orsakar fel vid läsning av källfil eller -mapp. Några av felen kan vara "ingen sådan fil eller katalog", "behörighet nekad", "I/O-fel" osv. Se till att nätverksanslutningen mellan agenten och källdelningen fungerar väl. Källresursen/mappen/filerna måste finnas och agenten ska ha läsbehörighet till källresursen.
AZSM1021	Det gick inte att komma åt målmappen på grund av behörighetsproblem	Försök igen eller skapa ett supportärende.
AZSM1022	Den angivna målsökvägen är ogiltig	Skapa en ny slutpunkt med en giltig målcontainer och sökväg och uppdatera jobbdefinitionen och försök igen.
AZSM1023	Lånet har upphört att gälla för den här agenten i målcontainern	Försök igen eller skapa ett supportärende.
AZSM1024	Auktoriseringsfel vid åtkomst till målplatsen	Agenten har inte tillräcklig behörighet för att komma åt målplatsen. Rolltilldelningar för RBAC (rollbaserad åtkomstkontroll) utförs automatiskt när resurser skapas med hjälp av Azure Portal. Om du använder API:er, PowerShell-cmdletar eller SDK:er skapar du manuellt en rolltilldelning för agentens hanterade identitet för att få åtkomst till målplatsen. För lagringsblobcontainermål använder du rolltilldelningen Storage Blob Data Contributor . För Azure-fildelning som mål, använd privilegierad deltagare för lagringsfildata. Om du till exempel vill tilldela RBAC-roll kan du läsa artikeln Tilldela en Azure-roll för åtkomst till blobdata .
AZSM1025	Autentiseringsfel vid åtkomst till källplatsen	Kontrollera att agenten har behörighet till källplatsen.
AZSM1026	Måltypen stöds inte av agenten	Den här måltypen stöds inte av den aktuella Storage Mover-agenten.
AZSM1027	Målplatsen är upptagen	Agenten kan inte göra anspråk på målandelen eller containern eftersom det finns ett aktivt hyresavtal. Leasen kan bero på ett annat migreringsjobb eller att ett tidigare avbrutet jobb fortfarande gör anspråk på filen som heter "AZURE_STORAGE_MOVER_MARKER". Kontrollera att inget annat jobb körs för det här målet. Om ingen körs startar du om agenten och försöker igen. Kontakta supporten om problemet kvarstår.
AZSM1028	Åtkomstfel för Key Vault	Det här felet kan inträffa om agentens hanterade identitet saknar RBAC-åtkomsten "Key Vault Secrets User", om brandväggar eller nätverks-ACL:er blockerar anslutningar till nyckelvalvets slutpunkt eller om hemligheter saknas. För ett "SVAR 403"-fel kontrollerar du rolltilldelningar och eventuella brandväggsregler i nyckelvalvet som kan begränsa trafiken. För andra fel använder du menyalternativet xdmsh "5) Testa en slutpunktsanslutning" under "2) Nätverkskonfiguration" för att verifiera slutpunktens nåbarhet.
AZSM1029	Källslutpunktstyp stöds inte av den här agentversionen	Den här källtypen stöds inte av den aktuella Storage Mover-agenten.
AZSM1030	Det går inte att verifiera lagringskontotypen	Kontrollera att lagringskontot och containern finns och att agenten har beviljats behörighet till dem.
AZSM1031	Det gick inte att lösa målvärden	Kontrollera nätverkskonfigurationen för att bekräfta att brandväggar eller ACL:er inte blockerar åtkomsten till lagringskontots slutpunkt. Använd menyalternativet xdmsh "5) Testa en slutpunktsanslutning" under "2) Nätverkskonfiguration" för att verifiera slutpunktens nåbarhet.
AZSM1040	Diverse fel vid åtkomst till målet	Det är troligt att det här felet är tillfälligt. Försök migreringsjobbet igen. Om problemet kvarstår skapar du en supportbegäran för ytterligare hjälp.
AZSM1041	Det gick inte att skicka jobbstatus	Det är troligt att det här felet är tillfälligt. Försök migreringsjobbet igen. Om problemet kvarstår skapar du en supportbegäran för ytterligare hjälp.
AZSM1042	Det gick inte att skapa jobbet	Det här felet kan inträffa på grund av olika orsaker, till exempel att agenten inte kan nå lagringskontots slutpunkt, brandväggar eller nätverks-ACL:er som blockerar anslutningen, trafik från agenten som dirigeras via en offentlig IP-adress när en privat slutpunkt har konfigurerats för lagringskontot eller en proxy som ändrar certifikatet. Om du vill verifiera lagringskontots slutpunktstillgänglighet använder du menyalternativet xdmsh "5) Testa en slutpunktsanslutning" under "2) Nätverkskonfiguration". Om felet som rapporteras är "x509: certifikat signerat av okänd utfärdare" anger det att det lokala nätverket avlyssnar och ändrar SSL-certifikat (SSL-avlyssning) för trafik till de nödvändiga slutpunkterna, vilket gör att agenten inte känner igen de mottagna certifikaten. När du lägger till certifikat i agenten brukar det här problemet lösas, men den här funktionen stöds för närvarande inte. Om du vill att agenten ska få åtkomst till dessa slutpunkter kan du överväga att lägga till dem i listan över tillåtna för att kringgå SSL-avlyssning.
AZSM1043	Det gick inte att återuppta jobbet	Försök igen eller skapa ett supportärende.
AZSM1044	Det gick inte att slutföra jobbet.	Försök igen eller skapa ett supportärende.
AZSM1045	Jobbet avbröts medan det fortfarande kördes.	Försök igen eller skapa ett supportärende.
AZSM1060	Diverse fel under jobbkörningen.	Det här felet kan inträffa på grund av olika orsaker. Granska det rapporterade felet och vidta korrigerande åtgärder baserat på dess information enligt beskrivningen nedan. Om felet anger: 1) "InvalidResourceName": Kontrollera att mapp- och filnamn följer namngivningskonventioner som stöds. Till exempel är "con" inte ett giltigt katalognamn. 2) "Den angivna resursen är full": Verifiera målresursens kapacitet. 3) "felaktig filbeskrivning": Bekräfta att SMB-nätverksanslutningen mellan agenten och källan fungerar korrekt och att SMB-servern svarar på läsbegäranden. 4) "403 Den här begäran har inte behörighet att utföra den här åtgärden": Om en privat slutpunkt har konfigurerats för mållagringskontot, kontrollera att DNS är korrekt konfigurerat och verifiera att det inte finns några dns-felroute eller lastbalanserarkonfigurationer som orsakar felaktig IP-upplösning. 5) Försök igen för andra fel. Om problemet kvarstår skapar du ett supportärende.
AZSM2021	Filtypen stöds inte av målet.	Den här måltypen stöder inte filer av den här typen. Referera till skalbarhets- och prestandamål för Azure Files och Azure Blob Storage för ytterligare information.
AZSM2024	Längden på källsökvägen är längre än max som stöds av målet.	Se vägledningen i artikeln Namngivning och referens till resurser, kataloger, filer och metadata .
AZSM2026	Källfilen har en storlek som är större än max som stöds av målet.	Se vägledningen i artikeln Namngivning och referens till resurser, kataloger, filer och metadata .
AZSM2027	Källfilsäkerhetsbeskrivningen har egenskaper som inte stöds	Granska filens eller mappens behörigheter.
AZSM2061	Okänt fel påträffades vid genomsökning av källan.	Kan vara ett tillfälligt fel. Kör migreringsjobbet igen.
AZSM2062	Det gick inte att läsa källfilen på grund av behörighetsproblem.	Kontrollera att agenten har behörighet till källplatsen.
AZSM2063	Påträffade I/O-fel när källfilen lästes.	Det är troligt att det här felet är tillfälligt. Försök migreringsjobbet igen. Om problemet kvarstår skapar du en supportbegäran för ytterligare hjälp.
AZSM2069	Det gick inte att läsa målfilen på grund av behörighetsproblem.	Kontrollera att agenten har beviljats behörigheter till målplatsen.
AZSM2070	Det går inte att skriva blob eftersom den har ett aktivt lån	Det här felet kan orsakas av att en annan agent skriver till platsen. Kontrollera att inget annat jobb körs mot målet. Försök igen eller skapa ett supportärende.
AZSM2071	Källfilen ändrades under överföringen	Det är troligt att det här felet är tillfälligt. Försök migreringsjobbet igen. Om problemet kvarstår skapar du en supportbegäran för ytterligare hjälp.
AZSM2080	Kopiering misslyckades på grund av ett okänt fel	Det är troligt att det här felet är tillfälligt. Försök migreringsjobbet igen. Om problemet kvarstår skapar du en supportbegäran för ytterligare hjälp.

Felsöka RBAC-problem med Storage Mover

Under en jobbkörning sker automatiska RBAC-tilldelningar. Om det finns fel i tilldelningar lägger du till den nödvändiga rolltilldelningen manuellt.

1. Navigera till lämplig resurs – Key Vault, filresursdelning eller blobcontainer.
2. Gå till Åtkomstkontroll (IAM).
3. Lägg till en ny rolltilldelning: Tilldela Azure-roller med hjälp av Azure-portalen – Azure RBAC | Microsoft Learn.
4. I guiden Lägg till rolltilldelning söker du efter lämplig roll i tabellen nedan efter den resurstyp som valts i steg 1. I exemplet nedan är resursen Key Vault.

Resurstyp	Roller som krävs
Key Vault	Användare av Nyckelvalvets hemligheter
Fildelning	Storage File Data Privilegierad Bidragsgivare
Blobcontainer	Storage Blob Data Privilegierad bidragsgivare

i. Tilldela åtkomst ska vara för "Hanterad identitet".
ii. I den högra rutan väljer du hanterad identitetstyp som Maskin – Azure Arc.
iii. Välj maskinbågen i listan. Den har samma namn som agenten.
iv. Slutför uppgiften.