Problembehandlung von Fehlercodes bei der Ausführung von Storage Mover-Aufträgen

Ein Azure Storage Mover-Agent verwendet Zeichenfolgenstatuscodes für Status, die dem Endbenutzer übermittelt werden. Alle Statuscodes weisen das Präfix AZSM gefolgt von vier Dezimalziffern auf. Die erste Dezimalziffer gibt den Bereich auf hoher Ebene des Status an. Jeder Statuscode sollte zu einem der folgenden Bereiche gehören:

• Status, der für den gesamten Agent gilt.
  Diese Codes verwenden die Bereichsziffer 0 und weisen daher das Präfix AZSM0 auf.
• Status, der für einen bestimmten Auftrag gilt, der vom Agent ausgeführt wird.
  Diese Codes verwenden die Bereichsziffer 1 und weisen daher das Präfix AZSM1 auf.
• Status, der vom Agent für bestimmte Dateien oder Verzeichnisse festgelegt werden kann, die von einem Auftrag übertragen werden, der vom Agent ausgeführt wird.
  Diese Codes verwenden die Bereichsziffer 2 und weisen daher das Präfix AZSM2 auf.

Jeder dieser Bereiche unterteilt Status weiter in Kategorien und Unterkategorien. Jede Unterkategorie reserviert in der Regel 20 Statuscodes, um zukünftige Erweiterungen zu berücksichtigen.

Tipp

AZSM0000 ist der spezielle bereichsunabhängige Statuscode, der einen erfolgreichen Vorgang angibt und verwendet werden sollte, um einen erfolgreichen Vorgang auf beliebiger Ebene zu signieren.

Fehlercode	Fehlermeldung	Details/Problembehandlungsschritte/Risikominderung
AZSM1001	Fehler beim Bereitstellen des Quellpfads	Verifizieren Sie, ob der angegebene Servername oder die angegebene IP-Adresse gültig ist oder der Quellspeicherort korrekt ist. Wenn Sie SMB verwenden, verifizieren Sie, ob der angegebene Benutzername und das angegebene Kennwort korrekt sind.
AZSM1002	Fehler beim Überprüfen der Quelle	Wiederholen Sie den Vorgang, oder erstellen Sie ein Supportticket.
AZSM1003	Fehler beim Zugriff auf den Quellordner aufgrund von Berechtigungsproblemen	Verifizieren Sie, dass dem Agent Berechtigungen für die Quelldateifreigabe erteilt wurden.
AZSM1004	Der angegebene Quellpfad ist ungültig	Erstellen Sie einen neuen Endpunkt mit einem gültigen Quellfreigabepfad, und aktualisieren Sie die Auftragsdefinition, und wiederholen Sie den Vorgang.
AZSM1020	Sonstiger Fehler beim Zugriff auf die Quelle	Dieser Fehler wird aus irgendeinem Grund gemeldet, der fehler beim Lesen von Quelldateien/Ordnern verursacht. Zu diesen Fehlern können „Datei oder Verzeichnis nicht vorhanden“, „Berechtigung verweigert“, „Eingabe-/Ausgabefehler“ usw. zählen. Stellen Sie sicher, dass die Netzwerkverbindung zwischen Agent und Quellfreigabe ordnungsgemäß funktioniert. Die Quellfreigabe/Ordner/Dateien müssen vorhanden sein, und der Agent sollte Lesezugriff auf die Quellfreigabe haben.
AZSM1021	Fehler beim Zugriff auf den Zielordner aufgrund von Berechtigungsproblemen	Wiederholen Sie den Vorgang, oder erstellen Sie ein Supportticket.
AZSM1022	Der angegebene Zielpfad ist ungültig	Erstellen Sie einen neuen Endpunkt mit einem gültigen Zielcontainer und -pfad, und aktualisieren Sie die Auftragsdefinition, und wiederholen Sie den Vorgang.
AZSM1023	Lease abgelaufen für diesen Agent im Zielcontainer	Wiederholen Sie den Vorgang, oder erstellen Sie ein Supportticket.
AZSM1024	Autorisierungsfehler beim Zugriff auf den Zielspeicherort	Der Agent verfügt nicht über ausreichende Berechtigungen für den Zugriff auf den Zielspeicherort. Zuweisungen von RBAC-Rollen (rollenbasierte Zugriffssteuerung) werden automatisch ausgeführt, wenn Ressourcen mithilfe des Azure-Portals erstellt werden. Wenn Sie die APIs, PowerShell-Cmdlets oder SDKs verwenden, erstellen Sie manuell eine Rollenzuweisung für die verwaltete Identität des Agents, um auf den Zielspeicherort zuzugreifen. Verwenden Sie für das Ziel des Speicher-Blob-Containers die Rollenzuweisung " Storage Blob Data Contributor ". Verwenden Sie die Rollenzuweisung Privilegierter Mitwirkender für Speicherdateidaten, wenn das Ziel eine Azure-Dateifreigabe ist. Wenn Sie z. B. eine RBAC-Rolle zuweisen möchten, lesen Sie den Artikel Azure-Rolle für den Zugriff auf Blob-Daten zuweisen.
AZSM1025	Authentifizierungsfehler beim Zugriff auf den Quellspeicherort	Überprüfen Sie, dass der Agent über Berechtigungen für den Quellstandort verfügt.
AZSM1026	Der Zieltyp wird vom Agenten nicht unterstützt.	Dieser Zieltyp wird vom aktuellen Storage Mover-Agent nicht unterstützt.
AZSM1027	Der Zielspeicherort ist belegt	Der Agent kann die Zielfreigabe oder den Zielcontainer nicht beanspruchen, da eine aktive Lease besteht. Der Lease kann auf einen anderen Migrationsauftrag oder auf einen vorher abgebrochenen Auftrag zurückzuführen sein, der immer noch einen Anspruch auf die Datei "AZURE_STORAGE_MOVER_MARKER" hat. Stellen Sie sicher, dass für dieses Ziel kein anderer Auftrag ausgeführt wird. Wenn keine Aufträge ausgeführt werden, starten Sie den Agent neu, und versuchen Sie es nochmal. Sollte das Problem weiterhin bestehen, wenden Sie sich an den Support.
AZSM1028	Fehler beim Zugriff auf Key Vault	Dieser Fehler kann auftreten, wenn die verwaltete Identität des Agents den RBAC-Zugriff "Key Vault Secrets User" nicht aufweist, wenn Firewalls oder Netzwerk-ACLs Verbindungen mit dem Schlüsseltresor-Endpunkt blockieren oder geheime Schlüssel fehlen. Überprüfen Sie bei einem Fehler vom Typ ANTWORT 403 die Rollenzuweisungen und alle Firewallregeln für den Schlüsseltresor, die den Datenverkehr einschränken könnten. Verwenden Sie bei anderen Fehlern die Menüoption "xdmsh" "5) Testen der Konnektivität einzelner Endpunkte" unter "2) Netzwerkkonfiguration", um die Reichweite des Endpunkts zu überprüfen.
AZSM1029	Der Quellendpunkttyp wird von dieser Agentversion nicht unterstützt	Dieser Quelltyp wird vom aktuellen Storage Mover-Agent nicht unterstützt.
AZSM1030	Der Speicherkontotyp kann nicht verifiziert werden	Verifizieren Sie, dass das Speicherkonto und der Speichercontainer vorhanden sind und dem Agent dafür Berechtigungen erteilt wurden.
AZSM1031	Fehler beim Auflösen des Zielhosts	Überprüfen Sie die Netzwerkkonfiguration, um Firewalls zu bestätigen, oder ACLs blockieren den Zugriff auf den Endpunkt des Speicherkontos nicht. Verwenden Sie die xdmsh-Menüoption "5) Testen der Konnektivität einzelner Endpunkte" unter "2) Netzwerkkonfiguration", um die Reichweite des Endpunkts zu überprüfen.
AZSM1040	Sonstiger Fehler beim Zugriff auf das Ziel	Es ist wahrscheinlich, dass dieser Fehler temporär ist. Wiederholen Sie den Migrationsauftrag. Wenn das Problem weiterhin besteht, erstellen Sie ein Supportticket für weitere Unterstützung.
AZSM1041	Fehler beim Senden des Auftragsfortschritts	Es ist wahrscheinlich, dass dieser Fehler temporär ist. Wiederholen Sie den Migrationsauftrag. Wenn das Problem weiterhin besteht, erstellen Sie ein Supportticket für weitere Unterstützung.
AZSM1042	Fehler beim Erstellen des Auftrags	Dieser Fehler kann aus verschiedenen Gründen auftreten, z. B. weil der Agent den Endpunkt des Speicherkontos, firewalls oder Netzwerk-ACLs nicht erreichen kann, die die Verbindung blockieren, Datenverkehr vom Agent, der über eine öffentliche IP weitergeleitet wird, wenn ein privater Endpunkt im Speicherkonto konfiguriert ist, oder ein Proxy, der das Zertifikat ändert. Um die Reichweite des Speicherkonto-Endpunkts zu überprüfen, verwenden Sie die Menüoption "5) Testen der Konnektivität einzelner Endpunkte" unter "2) Netzwerkkonfiguration". Wenn der gemeldete Fehler "x509: Zertifikat, das von unbekannter Autorität signiert ist", gibt er an, dass das lokale Netzwerk SSL-Zertifikate (SSL Interception) für den Datenverkehr an die erforderlichen Endpunkte abfangen und ändert, was dazu führt, dass der Agent die empfangenen Zertifikate nicht erkennt. Während das Hinzufügen von Zertifikaten zum Agent dieses Problem in der Regel beheben würde, wird dieses Feature derzeit nicht unterstützt. Um dem Agent den Zugriff auf diese Endpunkte zu ermöglichen, sollten Sie diese zur Zulassungsliste hinzufügen, um SSL-Abfangen zu umgehen.
AZSM1043	Fehler beim Fortsetzen des Auftrags	Wiederholen Sie den Vorgang, oder erstellen Sie ein Supportticket.
AZSM1044	Fehler beim Abschließen des Auftrags.	Wiederholen Sie den Vorgang, oder erstellen Sie ein Supportticket.
AZSM1045	Der Auftrag wurde abgebrochen, während er noch ausgeführt wurde.	Wiederholen Sie den Vorgang, oder erstellen Sie ein Supportticket.
AZSM1060	Sonstiger Fehler während der Auftragsausführung.	Dieser Fehler kann aus verschiedenen Gründen auftreten. Überprüfen Sie den gemeldeten Fehler, und ergreifen Sie Korrekturmaßnahmen basierend auf den unten beschriebenen Details. Wenn der Fehler angibt: 1) "InvalidResourceName": Überprüfen Sie, ob Ordner und Dateinamen den unterstützten Benennungskonventionen entsprechen. "con" ist z. B. kein gültiger Verzeichnisname. 2) „Die angegebene Freigabe ist voll“: Überprüfen Sie die Kapazität der Zielfreigabe. 3) "Ungültige Dateibeschreibung": Vergewissern Sie sich, dass die SMB-Netzwerkverbindung zwischen Agent und Quelle ordnungsgemäß funktioniert und dass der SMB-Server auf Leseanforderungen reagiert. 4) "403 Diese Anforderung ist nicht zum Ausführen dieses Vorgangs autorisiert": Wenn ein privater Endpunkt für das Zielspeicherkonto konfiguriert ist, überprüfen Sie, ob DNS ordnungsgemäß konfiguriert ist, und überprüfen Sie, ob keine DNS-Fehlleitungs- oder Lastenausgleichskonfigurationen vorhanden sind, was zu einer falschen IP-Auflösung führt. 5) Bei anderen Fehlern versuchen Sie den Auftrag erneut; wenn das Problem weiterhin besteht, erstellen Sie ein Supportticket.
AZSM2021	Der Dateityp wird vom Ziel nicht unterstützt.	Dieser Zieltyp unterstützt keine Dateien dieses Typs. Verweisen Sie auf Skalierbarkeits- und Leistungsziele für Azure Files und Azure Blob Storage, um weitere Informationen zu erhalten.
AZSM2024	Der Quellpfad ist länger als die vom Ziel unterstützte maximale Länge.	Weitere Informationen finden Sie im Artikel Benennen und Referenzieren von Freigaben, Verzeichnissen, Dateien und Metadaten.
AZSM2026	Die Quelldatei ist größer als die vom Ziel unterstützte maximale Größe.	Weitere Informationen finden Sie im Artikel Benennen und Referenzieren von Freigaben, Verzeichnissen, Dateien und Metadaten.
AZSM2027	Der Sicherheitsbeschreibung für Quelldateien verfügt über nicht unterstützte Eigenschaften	Überprüfen Sie die Berechtigungen der Datei oder des Ordners.
AZSM2061	Unbekannter Fehler beim Überprüfen der Quelle.	Hierbei kann es sich um einen vorübergehenden Fehler handeln. Führen Sie den Migrationsauftrag erneut aus.
AZSM2062	Fehler beim Lesen der Quelldatei aufgrund von Berechtigungsproblemen.	Überprüfen Sie, dass der Agent über Berechtigungen für den Quellstandort verfügt.
AZSM2063	E/A-Fehler beim Lesen der Quelldatei.	Es ist wahrscheinlich, dass dieser Fehler temporär ist. Wiederholen Sie den Migrationsauftrag. Wenn das Problem weiterhin besteht, erstellen Sie ein Supportticket für weitere Unterstützung.
AZSM2069	Fehler beim Lesen der Zieldatei aufgrund von Berechtigungsproblemen.	Verifizieren Sie, dass dem Agent Berechtigungen für den Zielspeicherort erteilt wurden.
AZSM2070	Das Blob kann nicht geschrieben werden, da es über eine aktive Lease verfügt	Dieser Fehler kann durch einen anderen Agent verursacht werden, der in den Speicherort schreibt. Stellen Sie sicher, dass kein anderer Auftrag für das Ziel ausgeführt wird. Wiederholen Sie den Vorgang, oder erstellen Sie ein Supportticket.
AZSM2071	Die Quelldatei wurde während der Übertragung geändert.	Es ist wahrscheinlich, dass dieser Fehler temporär ist. Wiederholen Sie den Migrationsauftrag. Wenn das Problem weiterhin besteht, erstellen Sie ein Supportticket für weitere Unterstützung.
AZSM2080	Der Kopiervorgang ist aufgrund eines unbekannten Fehlers fehlgeschlagen	Es ist wahrscheinlich, dass dieser Fehler temporär ist. Wiederholen Sie den Migrationsauftrag. Wenn das Problem weiterhin besteht, erstellen Sie ein Supportticket für weitere Unterstützung.

Problembehandlung von Storage Mover RBAC-Problemen

Während einer Auftragsausführung erfolgen automatische RBAC-Zuweisungen (rollenbasierte Zugriffssteuerung). Wenn Fehler in Zuordnungen auftreten, fügen Sie die erforderliche Rollenzuweisung manuell hinzu.

1. Navigieren Sie zur entsprechenden Ressource – Key Vault, Dateifreigabe oder Blobcontainer.
2. Navigieren Sie zu Access Control (IAM).
3. Hinzufügen einer neuen Rollenzuweisung: Zuweisen von Azure-Rollen mithilfe des Azure-Portals – Azure RBAC | Microsoft Learn.
4. Suchen Sie im Assistenten zum Hinzufügen von Rollenzuweisungen nach der entsprechenden Rolle in der nachstehenden Tabelle nach dem in Schritt 1 ausgewählten Ressourcentyp. Im folgenden Beispiel wäre die Ressource "Key Vault".

Ressourcentyp	Erforderliche Rollen
Key Vault	Key Vault Secrets-Benutzer
Dateifreigabe	Privilegierter Mitwirkender für Speicherdateidaten
BLOB-Container	Privilegierter Mitwirkender für Speicherblobdaten

i. Der Zugriff sollte "Verwaltete Identität" zugewiesen werden.
ii. Wählen Sie im rechten Bereich den Typ der verwalteten Identität als "Maschine – Azure Arc" aus.
iii. Wählen Sie den Maschinenbogen aus der Liste. Sie hat denselben Namen wie der Agent.
iv. Schließen Sie die Aufgabe ab.