Résolution des problèmes liés aux codes d’erreur d’exécution du travail Storage Mover

Un agent Azure Storage Mover utilise des codes d’état de chaîne pour les états transmis à l’utilisateur final. Tous les codes d’état ont le préfixe AZSM suivi de quatre chiffres décimaux. Le premier chiffre décimal indique l’étendue générale de l’état. Chaque code d’état doit appartenir à l’une des étendues suivantes :

  • État qui s’applique à l’ensemble de l’agent.
    Ces codes utilisent le chiffre d’étendue 0, et ont donc le préfixe AZSM0.
  • État qui s’applique à un travail spécifique exécuté par l’agent.
    Ces codes utilisent le chiffre d’étendue 1 et ont donc le préfixe AZSM1.
  • État qui peut être défini par l’agent sur un fichier ou un répertoire spécifique transféré par un travail exécuté par l’agent.
    Ces codes utilisent le chiffre d’étendue 2 et ont donc le préfixe AZSM2.

Chacune de ces étendues classifie les états en catégories et sous-catégories. Chaque sous-catégorie réserve généralement 20 codes d’état pour prendre en charge l’expansion future.

Conseil

AZSM0000 est le code d’état spécial sans étendue spécifique indiquant la réussite de l’opération et doit être utilisé pour indiquer une opération réussie à n’importe quel niveau ou étendue.

Code d'erreur Message d’erreur Détails/Étapes de résolution des problèmes/Atténuation
AZSM1001 Échec du montage du chemin source Vérifiez que le nom du serveur ou l’adresse IP fourni est valide ou que l’emplacement source est correct. Si vous utilisez SMB, vérifiez que le nom d’utilisateur et le mot de passe fournis sont corrects.
AZSM1002 Une erreur s’est produite lors de l’analyse de la source Réessayez ou créez un ticket de support.
AZSM1003 Échec de l’accès au dossier source en raison de problèmes d’autorisation Vérifiez que l’agent a reçu des autorisations pour le partage de fichiers source.
AZSM1004 Le chemin source fourni n’est pas valide Créez un point de terminaison avec un chemin de partage source valide et mettez à jour la définition du travail, puis réessayez.
AZSM1020 Erreur diverses lors de l’accès à la source Cette erreur est signalée pour une raison quelconque qui provoque des échecs de lecture de fichier/dossier source. Certaines des erreurs peuvent être « aucun fichier ou répertoire de ce type », « autorisation refusée », « erreur d’entrée/sortie », etc. Vérifiez que la connexion réseau entre l’agent et le partage source fonctionne correctement. Le partage source/dossier/fichiers doit être présent et l’agent doit avoir un accès en lecture au partage source.
AZSM1021 Échec de l’accès au dossier cible en raison de problèmes d’autorisation Réessayez ou créez un ticket de support.
AZSM1022 Le chemin cible fourni n’est pas valide Créez un point de terminaison avec un conteneur cible et un chemin valides, puis mettez à jour la définition du travail et réessayez.
AZSM1023 Bail expiré pour cet agent sur le conteneur cible Réessayez ou créez un ticket de support.
AZSM1024 Échec d’autorisation lors de l’accès à l’emplacement cible L’agent n’a pas l’autorisation suffisante pour accéder à l’emplacement cible. Les attributions de rôles RBAC (contrôle d’accès en fonction du rôle) sont effectuées automatiquement lorsque des ressources sont créées à l’aide du Portail Azure. Si vous utilisez des API, des applets de commande PowerShell ou des SDK, créez manuellement une attribution de rôle pour l’identité managée de l’agent pour accéder à l’emplacement cible. Pour la cible de conteneur d’objets blob de stockage, utilisez l’attribution du rôle Contributeur aux données Blob de stockage. Pour le partage de fichiers Azure en tant que cible, utilisez Storage File Data Privileged Contributor. Par exemple, pour affecter un rôle RBAC, reportez-vous à Attribuer un rôle Azure pour accéder à l’article sur les données blob.
AZSM1025 Échec d’authentification lors de l’accès à l’emplacement source Vérifiez que l’agent dispose d’autorisations sur l’emplacement source.
AZSM1026 Le type cible n’est pas pris en charge par l’agent Ce type cible n’est pas pris en charge par l’agent Storage Mover actuel.
AZSM1027 L’emplacement cible est occupé L’agent ne peut pas revendiquer le partage ou le conteneur cible, car il existe un bail actif. Le bail peut être dû à une autre tâche de migration ou à une tâche abandonnée précédente qui contient toujours une revendication sur le fichier « AZURE_STORAGE_MOVER_MARKER ». Assurez-vous qu’aucun autre travail n’est en cours d’exécution pour cette cible. Si aucun n’est en cours d’exécution, redémarrez l’agent et réessayez . si le problème persiste, contactez le support.
AZSM1028 Échec de l’accès Key Vault Cette erreur peut se produire si l’identité managée de l’agent ne dispose pas d’un accès RBAC « Key Vault Secrets », si des pare-feu ou des listes de contrôle d’accès réseau bloquent les connexions au point de terminaison du coffre de clés, ou si des secrets sont manquants. En cas d'erreur « RESPONSE 403 », vérifiez les attributions de rôles et toutes les règles de pare-feu sur le coffre de clés pouvant restreindre le trafic. Pour d’autres erreurs, utilisez l’option de menu xdmsh « 5) Tester la connectivité de point de terminaison unique » sous « 2) Configuration réseau » pour vérifier l’accessibilité du point de terminaison.
AZSM1029 Type de point de terminaison source non pris en charge par cette version de l’agent Ce type de source n’est pas pris en charge par l’agent Storage Mover actuel.
AZSM1030 Impossible de vérifier le type de compte de stockage Vérifiez que le compte de stockage et le conteneur existent, et que l’agent a reçu des autorisations sur ceux-ci.
AZSM1031 Impossible de résoudre l’hôte cible Vérifiez la configuration réseau pour confirmer que les pare-feu ou les listes de contrôle d’accès ne bloquent pas l’accès au point de terminaison du compte de stockage. Utilisez l’option de menu xdmsh « 5) Tester la connectivité de point de terminaison unique » sous « 2) Configuration réseau » pour vérifier l’accessibilité du point de terminaison.
AZSM1040 Erreur diverse lors de l’accès à la cible Il est probable que cette erreur soit temporaire. Réessayez la tâche de migration. Si le problème persiste, créez un ticket de support pour obtenir une assistance supplémentaire.
AZSM1041 Échec de l’envoi de la progression du travail Il est probable que cette erreur soit temporaire. Réessayez la tâche de migration. Si le problème persiste, créez un ticket de support pour obtenir une assistance supplémentaire.
AZSM1042 Échec de la création du travail Cette erreur peut se produire en raison de différentes raisons, telles que l’agent incapable d’atteindre le point de terminaison du compte de stockage, les pare-feu ou les listes de contrôle d’accès réseau bloquant la connexion, le trafic de l’agent acheminé sur une adresse IP publique lorsqu’un point de terminaison privé est configuré sur le compte de stockage ou un proxy modifiant le certificat. Pour vérifier l’accessibilité du point de terminaison du compte de stockage, utilisez l’option de menu xdmsh « 5) Tester la connectivité de point de terminaison unique » sous « 2) Configuration réseau ». Si l’erreur signalée est « x509 : certificat signé par une autorité inconnue », indique que le réseau local intercepte et modifie les certificats SSL (interception SSL) pour le trafic vers les points de terminaison requis, ce qui entraîne l’échec de la reconnaissance des certificats reçus par l’Agent. Bien que l’ajout de certificats à l’agent résolve généralement ce problème, cette fonctionnalité n’est actuellement pas prise en charge. Pour permettre à l’agent d’accéder à ces points de terminaison, ajoutez-les à la liste d'autorisation afin de contourner l’interception SSL.
AZSM1043 Échec de la reprise du travail Réessayez ou créez un ticket de support.
AZSM1044 Échec de la finalisation du travail. Réessayez ou créez un ticket de support.
AZSM1045 Le travail a été abandonné en cours d’exécution. Réessayez ou créez un ticket de support.
AZSM1060 Erreur diverse lors de l’exécution du travail. Cette erreur peut se produire en raison de différentes raisons. Passez en revue l’erreur signalée et prenez des mesures correctives en fonction de ses détails, comme indiqué ci-dessous. Si l’erreur indique : 1) « InvalidResourceName » : vérifiez que les noms de dossiers et de fichiers suivent les conventions d’affectation de noms prises en charge. Par exemple, « con » n’est pas un nom de répertoire valide. 2) « Le partage spécifié est plein » : vérifiez la capacité du partage cible. 3) « descripteur de fichier incorrect » : vérifiez que la connexion réseau SMB entre l’agent et la source fonctionne correctement et que le serveur SMB répond aux demandes de lecture. 4) « 403 Cette requête n’est pas autorisée à effectuer cette opération » : si un point de terminaison privé est configuré pour le compte de stockage cible, vérifiez que DNS est correctement configuré et vérifiez qu’il n’existe aucune configuration d’équilibrage de charge ou d’exécution incorrecte du DNS provoquant une résolution IP incorrecte. 5) Pour d’autres erreurs, réessayez le travail ; si le problème persiste, créez un ticket de support.
AZSM2021 Type de fichier non pris en charge par la cible. Ce type cible ne prend pas en charge les fichiers de ce type. Consultez les informations de référence sur la scalabilité et les cibles de performances pour Azure Files et Stockage Blob Azure pour plus d’informations.
AZSM2024 Longueur du chemin source supérieure à la longueur maximale prise en charge par la cible. Reportez-vous aux instructions de l’article Nommage et référencement des partages, des répertoires, des fichiers et des métadonnées.
AZSM2026 Le fichier source a une taille supérieure à la taille maximale prise en charge par la cible. Reportez-vous aux instructions de l’article Nommage et référencement des partages, des répertoires, des fichiers et des métadonnées.
AZSM2027 Le descripteur de sécurité du fichier source a des propriétés non prises en charge Passez en revue les autorisations du fichier ou du dossier.
AZSM2061 Erreur inconnue rencontrée lors de l’analyse de la source. Peut être une erreur temporaire. Réexécutez la tâche de migration.
AZSM2062 Échec de la lecture du fichier source en raison de problèmes d’autorisation. Vérifiez que l’agent dispose d’autorisations sur l’emplacement source.
AZSM2063 Erreur d’E/S rencontrée lors de la lecture du fichier source. Il est probable que cette erreur soit temporaire. Réessayez la tâche de migration. Si le problème persiste, créez un ticket de support pour obtenir une assistance supplémentaire.
AZSM2069 Échec de lecture du fichier cible en raison de problèmes d’autorisation. Vérifiez que l’agent a reçu des autorisations pour l’emplacement cible.
AZSM2070 Impossible d’écrire un objet blob, car il a un bail actif Cette erreur peut être due à l’écriture d’un autre agent à l’emplacement. Vérifiez qu’aucun autre travail n’est en cours d’exécution sur la cible. Réessayez ou créez un ticket de support.
AZSM2071 Le fichier source a été modifié pendant le transfert Il est probable que cette erreur soit temporaire. Réessayez la tâche de migration. Si le problème persiste, créez un ticket de support pour obtenir une assistance supplémentaire.
AZSM2080 La copie a échoué en raison d’une erreur inconnue Il est probable que cette erreur soit temporaire. Réessayez la tâche de migration. Si le problème persiste, créez un ticket de support pour obtenir une assistance supplémentaire.

Résolution des problèmes RBAC du Storage Mover

Pendant une exécution de travail, des affectations RBAC automatiques se produisent. En cas d’échecs dans les affectations, ajoutez manuellement l’attribution de rôle requise.

  1. Accédez à la ressource appropriée : Key Vault, partage de fichiers ou conteneur Blob.
  2. Accédez au contrôle d’accès (IAM).
  3. Ajouter une nouvelle attribution de rôle : Attribuer des rôles Azure à l’aide du portail Azure - Azure RBAC | Microsoft Learn.
  4. Dans l’Assistant d'ajout d'attribution de rôle, cherchez le rôle approprié dans le tableau ci-dessous pour le type de ressource sélectionné à l’étape 1. Dans l’exemple ci-dessous, la ressource serait Key Vault.

Image montrant les rôles attribués à la ressource Key Vault.

Type de ressource Rôles requis
Coffre de clés Utilisateur des secrets de Key Vault
Partage de fichiers Contributeur privilégié des données du fichier de stockage
Conteneur d’objets blob Contributeur privilégié des données du blob de stockage

i. L'accès doit être attribué à l'« Identité managée ».
ii. Dans le volet droit, sélectionnez Type d’identité managée en tant que machine – Azure Arc.
iii. Sélectionnez l’arc de machine dans la liste. C'est le même nom que celui de l'agent.
iv. Terminez la tâche.