Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 Bereichsziffer0und weisen daher das PräfixAZSM0auf. - Status, der für einen bestimmten Auftrag gilt, der vom Agent ausgeführt wird.
Diese Codes verwenden die Bereichsziffer1und weisen daher das PräfixAZSM1auf. - 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 Bereichsziffer2und weisen daher das PräfixAZSM2auf.
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.
- Navigieren Sie zur entsprechenden Ressource – Key Vault, Dateifreigabe oder Blobcontainer.
- Navigieren Sie zu Access Control (IAM).
- Hinzufügen einer neuen Rollenzuweisung: Zuweisen von Azure-Rollen mithilfe des Azure-Portals – Azure RBAC | Microsoft Learn.
- 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".
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.