Foutcodes voor het uitvoeren van storage Mover-taken oplossen

Een Azure Storage Mover-agent maakt gebruik van tekenreeksstatuscodes voor statussen die worden overgebracht naar de eindgebruiker. Alle statuscodes hebben het voorvoegsel AZSM gevolgd door vier decimale cijfers. Het eerste decimale cijfer geeft het bereik op hoog niveau van de status aan. Elke statuscode moet deel uitmaken van een van de volgende bereiken:

• Status die van toepassing is op de hele agent.
  Deze codes gebruiken het bereikcijfer 0en hebben daarom het voorvoegsel AZSM0.
• Status die van toepassing is op een specifieke taak die door de agent wordt uitgevoerd.
  Deze codes gebruiken het bereikcijfer 1 en hebben daarom het voorvoegsel AZSM1.
• De status die door de agent kan worden ingesteld voor een specifiek bestand of een specifieke map die wordt overgedragen door een taak die door de agent wordt uitgevoerd.
  Deze codes gebruiken het bereikcijfer 2 en hebben daarom het voorvoegsel AZSM2.

Elk van deze bereiken verdeelt statussen verder in categorieën en subcategorieën. Elke subcategorie reserveert doorgaans 20 statuscodes voor toekomstige uitbreiding.

Tip

AZSM0000 is de speciale scope-agnostische statuscode die aangeeft dat de bewerking is geslaagd en moet worden gebruikt om een geslaagde bewerking op elk bereik/niveau aan te geven.

Foutcode	Foutbericht	Details/Stappen voor probleemoplossing/Risicobeperking
AZSM1001	Kan bronpad niet koppelen	Controleer of de opgegeven servernaam of het opgegeven IP-adres geldig is of dat de bronlocatie juist is. Als u SMB gebruikt, controleert u of de opgegeven gebruikersnaam en het opgegeven wachtwoord juist zijn.
AZSM1002	Er is een fout opgetreden tijdens het scannen van de bron	Probeer het opnieuw of maak een ondersteuningsticket.
AZSM1003	Kan de bronmap niet openen vanwege machtigingsproblemen	Controleer of de agent machtigingen heeft gekregen voor de bronbestandsshare.
AZSM1004	Het opgegeven bronpad is ongeldig	Maak een nieuw eindpunt met een geldig bronsharepad en werk de taakdefinitie bij en probeer het opnieuw.
AZSM1020	Diverse fout tijdens het openen van de bron	Deze fout wordt gerapporteerd voor elke reden die het lezen van bronbestanden of -mappen onmogelijk maakt. Sommige van de fouten kunnen 'geen dergelijk bestand of dergelijke map' zijn, 'machtiging geweigerd', 'invoer-/uitvoerfout', enzovoort. Zorg ervoor dat de netwerkverbinding tussen de agent en de bronshare goed werkt. De gedeelde bron/map/bestanden moeten aanwezig zijn en de agent moet leestoegang hebben tot de gedeelde bron.
AZSM1021	Kan de doelmap niet openen vanwege machtigingsproblemen	Probeer het opnieuw of maak een ondersteuningsticket.
AZSM1022	Het opgegeven doelpad is ongeldig	Maak een nieuw eindpunt met een geldig doelcontainer en -pad en werk de taakdefinitie bij en probeer het opnieuw.
AZSM1023	Lease is verlopen voor deze agent in de doelcontainer	Probeer het opnieuw of maak een ondersteuningsticket.
AZSM1024	Autorisatiefout bij toegang tot de doellocatie	De agent heeft onvoldoende machtigingen voor toegang tot de doellocatie. RBAC-roltoewijzingen (op rollen gebaseerd toegangsbeheer) worden automatisch uitgevoerd wanneer resources worden gemaakt met behulp van Azure Portal. Als u de API's, PowerShell-cmdlets of SDK's gebruikt, maakt u handmatig een roltoewijzing voor de beheerde identiteit van de agent voor toegang tot de doellocatie. Gebruik de roltoewijzing Storage Blob Data Contributor voor het Storage Blob container doel. Voor Azure-bestandsshare als doel, gebruik Storage File Data Privileged Contributor. Als u bijvoorbeeld een RBAC-rol wilt toewijzen, raadpleegt u Een Azure-rol toewijzen voor toegang tot het artikel over blobgegevens .
AZSM1025	Verificatiefout bij toegang tot de bronlocatie	Controleer of de agent machtigingen heeft voor de bronlocatie.
AZSM1026	Doeltype wordt niet ondersteund door de agent	Dit doeltype wordt niet ondersteund door de huidige Storage Mover-agent.
AZSM1027	De doellocatie is bezet	De agent kan de doelshare of container niet claimen omdat er een actieve lease is. De lease kan worden veroorzaakt door een andere migratietaak of een eerdere afgebroken taak die nog steeds een claim op het bestand 'AZURE_STORAGE_MOVER_MARKER' bevat. Zorg ervoor dat er geen andere taak wordt uitgevoerd voor dit doel. Als er geen wordt uitgevoerd, start u de agent opnieuw en probeert u het opnieuw; als het probleem zich blijft voordoen, neemt u contact op met de ondersteuning.
AZSM1028	Toegangsfout in Key Vault	Deze fout kan optreden als de beheerde identiteit van de agent geen RBAC-toegang voor Key Vault-geheimen heeft, als firewalls of netwerk-ACL's verbindingen met het sleutelkluiseindpunt blokkeren of als er geheimen ontbreken. Controleer bij een 'RESPONSE 403'-fout de roltoewijzingen en de eventuele firewallregels op de sleutelkluis die het verkeer kunnen beperken. Voor andere fouten gebruikt u de xdmsh-menuoptie '5) Test enkele eindpuntconnectiviteit' onder '2) Netwerkconfiguratie' om de bereikbaarheid van het eindpunt te controleren.
AZSM1029	Broneindpunttype wordt niet ondersteund door deze agentversie	Dit brontype wordt niet ondersteund door de huidige Storage Mover-agent.
AZSM1030	Kan het type opslagaccount niet verifiëren	Controleer of het opslagaccount en de container bestaan en of de agent machtigingen heeft gekregen.
AZSM1031	Kan doelhost niet oplossen	Controleer de netwerkconfiguratie om te bevestigen dat firewalls of ACL's de toegang tot het eindpunt van het opslagaccount niet blokkeren. Gebruik de xdmsh-menuoptie '5) Test enkele eindpuntconnectiviteit' onder '2) Netwerkconfiguratie' om de bereikbaarheid van eindpunten te controleren.
AZSM1040	Diverse fout tijdens het openen van het doel	Deze fout is waarschijnlijk tijdelijk. Voer de migratietaak opnieuw uit. Als het probleem zich blijft voordoen, maakt u een ondersteuningsticket voor meer hulp.
AZSM1041	Kan de voortgang van de taak niet verzenden	Deze fout is waarschijnlijk tijdelijk. Voer de migratietaak opnieuw uit. Als het probleem zich blijft voordoen, maakt u een ondersteuningsticket voor meer hulp.
AZSM1042	Kan taak niet maken	Deze fout kan optreden vanwege verschillende oorzaken, zoals het niet bereiken van het eindpunt van het opslagaccount, firewalls of netwerk-ACL's die de verbinding blokkeren, verkeer van de agent die wordt gerouteerd via een openbaar IP-adres wanneer een privé-eindpunt is geconfigureerd in het opslagaccount of een proxy die het certificaat wijzigt. Als u de bereikbaarheid van het eindpunt van het opslagaccount wilt controleren, gebruikt u de menuoptie xdmsh '5) Test enkele eindpuntconnectiviteit' onder '2) Netwerkconfiguratie'. Als de gemelde fout 'x509: certificaat ondertekend door onbekende instantie' is, geeft dit aan dat het on-premises netwerk SSL-certificaten (SSL Interception) onderschept en wijzigt voor verkeer naar de vereiste eindpunten, waardoor de agent de ontvangen certificaten niet herkent. Hoewel het toevoegen van certificaten aan de agent dit probleem doorgaans oplost, wordt deze functie momenteel niet ondersteund. Als u wilt dat de agent toegang heeft tot deze eindpunten, kunt u deze toevoegen aan de acceptatielijst om SSL Interception te omzeilen.
AZSM1043	Kan taak niet hervatten	Probeer het opnieuw of maak een ondersteuningsticket.
AZSM1044	Kan de taak niet voltooien.	Probeer het opnieuw of maak een ondersteuningsticket.
AZSM1045	De taak is afgebroken terwijl deze nog actief was.	Probeer het opnieuw of maak een ondersteuningsticket.
AZSM1060	Diverse fout tijdens het uitvoeren van de taak.	Deze fout kan om verschillende redenen optreden. Bekijk de gemelde fout en voer corrigerende acties uit op basis van de details, zoals hieronder wordt beschreven. Als de fout aangeeft: 1) "InvalidResourceName": Controleer of de map- en bestandsnamen de ondersteunde naamconventies volgen. 'con' is bijvoorbeeld geen geldige mapnaam. 2) "De opgegeven share is vol": Controleer de capaciteit van de doelshare. 3) 'ongeldige bestandsdescriptor': controleer of de SMB-netwerkverbinding tussen de agent en de bron correct functioneert en of de SMB-server reageert op leesaanvragen. 4) '403 Deze aanvraag is niet gemachtigd om deze bewerking uit te voeren': als een privé-eindpunt is geconfigureerd voor het doelopslagaccount, controleert u of DNS juist is geconfigureerd en controleert u of er geen DNS-onjuiste routeringsconfiguraties of load balancer-configuraties zijn die een onjuiste IP-omzetting veroorzaken. 5) Voor andere fouten voert u de taak opnieuw uit; Als het probleem zich blijft voordoen, maakt u een ondersteuningsticket.
AZSM2021	Bestandstype wordt niet ondersteund door het doel.	Dit doeltype biedt geen ondersteuning voor bestanden van dit type. Raadpleeg de schaalbaarheids- en prestatiedoelen voor Azure Files en Azure Blob Storage voor aanvullende informatie.
AZSM2024	Lengte van bronpad langer dan het maximum dat door het doel wordt ondersteund.	Raadpleeg de richtlijnen in het artikel Naamgeving en verwijzingen naar shares, mappen, bestanden en metagegevens .
AZSM2026	Het bronbestand heeft een grootte die groter is dan het maximum dat door het doel wordt ondersteund.	Raadpleeg de richtlijnen in het artikel Naamgeving en verwijzingen naar shares, mappen, bestanden en metagegevens .
AZSM2027	Descriptor voor beveiliging van bronbestanden heeft niet-ondersteunde eigenschappen	Controleer de machtigingen van het bestand of de map.
AZSM2061	Er is een onbekende fout opgetreden bij het scannen van de bron.	Kan een tijdelijke fout zijn. Voer de migratietaak opnieuw uit.
AZSM2062	Kan het bronbestand niet lezen vanwege machtigingsproblemen.	Controleer of de agent machtigingen heeft voor de bronlocatie.
AZSM2063	Er is een I/O-fout opgetreden tijdens het lezen van het bronbestand.	Deze fout is waarschijnlijk tijdelijk. Voer de migratietaak opnieuw uit. Als het probleem zich blijft voordoen, maakt u een ondersteuningsticket voor meer hulp.
AZSM2069	Kan het doelbestand niet lezen vanwege machtigingsproblemen.	Controleer of de agent machtigingen heeft gekregen voor de doellocatie.
AZSM2070	Kan geen blob schrijven omdat deze een actieve lease heeft	Deze fout kan worden veroorzaakt door een andere agent die naar de locatie schrijft. Zorg ervoor dat er geen andere taak wordt uitgevoerd op het doel. Probeer het opnieuw of maak een ondersteuningsticket.
AZSM2071	Bronbestand is gewijzigd tijdens de overdracht	Deze fout is waarschijnlijk tijdelijk. Voer de migratietaak opnieuw uit. Als het probleem zich blijft voordoen, maakt u een ondersteuningsticket voor meer hulp.
AZSM2080	Kopiëren is mislukt vanwege een onbekende fout	Deze fout is waarschijnlijk tijdelijk. Voer de migratietaak opnieuw uit. Als het probleem zich blijft voordoen, maakt u een ondersteuningsticket voor meer hulp.

Problemen met Storage Mover RBAC oplossen

Tijdens een taakuitvoering worden automatische RBAC-toewijzingen uitgevoerd. Als er fouten optreden in toewijzingen, voegt u handmatig de vereiste roltoewijzing toe.

1. Navigeer naar de juiste resource: Key Vault, bestandsshare of blobcontainer.
2. Navigeer naar Toegangsbeheer (IAM).
3. Een nieuwe roltoewijzing toevoegen: Azure-rollen toewijzen met behulp van Azure Portal - Azure RBAC | Microsoft Learn.
4. Gebruik de wizard Roltoewijzing Toevoegen om de juiste rol in de onderstaande tabel te zoeken voor het resourcetype dat is geselecteerd in stap 1. In het onderstaande voorbeeld is de resource Key Vault.

Type bron	Vereiste rollen
Key Vault	Key Vault-geheimengebruiker
Bestandsdeling	Inzender met bevoegdheid voor opslagbestandsgegevens
Blobcontainer	Inzender met bevoegdheden voor opslagblobgegevens

i Toegang moet worden toegewezen aan "Managed Identity".
Ii. Selecteer in het rechterdeelvenster het type Beheerde identiteit als Machine – Azure Arc.
Iii. Selecteer de machineboog in de lijst. Deze heeft dezelfde naam als de agent.
Iv. Voltooi de opdracht.