Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de changer d’annuaire.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer d’annuaire.
Cet article fournit une vue d’ensemble des codes d’erreur associés aux flux de travail de migration de passerelle, ainsi que leurs causes et résolutions. Problèmes qui se produisent généralement pendant chaque étape du processus de migration : Valider, Préparer, Migrer et Valider ou Abandonner.
Meilleures pratiques pour éviter les erreurs de migration
Suivez ces bonnes pratiques pour réduire les erreurs pendant le processus de migration de passerelle :
Maintenir l’intégrité des ressources : assurez-vous que toutes les ressources restent dans un état réussi tout au long de la migration. Évitez d’exécuter des mises à jour sur les ressources associées pendant le processus.
Évitez les mises à jour des propriétés : évitez de mettre à jour les propriétés telles que FastPath, le poids des itinéraires ou les bascules de trafic pour les connexions et les passerelles, car ces mises à jour peuvent entraîner des défaillances de ressources.
Migration de passerelle séquentielle : migrez les passerelles connectées au même circuit un par un. Les migrations parallèles sur le même circuit ne sont pas prises en charge.
Évitez les modifications manuelles : évitez de créer, de supprimer, de mettre à jour ou de réinitialiser manuellement des passerelles ou leurs connexions pendant qu’elles transportent activement le trafic (état administrateur activé) pendant le processus de migration.
Vérifier la maintenance : évitez de créer des connexions à des passerelles en cours de maintenance, car cette opération échoue. Toutes les connexions ayant échoué doivent être supprimées avant de réessayer.
En respectant ces pratiques, vous pouvez réduire la probabilité de rencontrer des erreurs pendant la migration.
Problèmes courants lors des étapes de migration et de leurs résolutions
Le tableau suivant présente les problèmes courants rencontrés lors de chaque étape de migration et fournit des stratégies pour les résoudre :
| Étape de migration | Problème | Résolution |
|---|---|---|
| Procéder à la validation | L’état des ressources n’est pas « réussi ». | Pour résoudre le problème, effectuez une opération GET et SET sur les ressources affectées. |
| Préparer | La création de nouvelles ressources échoue. | Réessayez l’opération. Si les nouvelles tentatives continuent d’échouer, supprimez les ressources nouvellement créées et réessayez l’opération. |
| Émigrer | Les deux passerelles restent activées après un échec de migration. | Redirigez le trafic vers l’ancienne passerelle et réessayez le processus de migration. |
| Commiter | L’ancienne passerelle reste activée et l’étape de validation échoue. | Réessayez l’étape de migration. Une fois l’ancienne passerelle désactivée, supprimez l’ancienne passerelle et ses ressources associées. |
| abandonner | Le nettoyage des ressources échoue pendant l’étape d’interruption. | Redirigez le trafic vers la nouvelle passerelle et réessayez d'annuler l'opération. |
Messages d'erreur courants
Le tableau suivant présente les messages d’erreur courants rencontrés pendant le processus de migration, ainsi que leurs causes et résolutions :
Scénarios avec prise en charge conditionnelle
Ces scénarios incluent des solutions pour éviter les défaillances et garantir une migration réussie.
| Nom de l’erreur | Message | Résolution |
|---|---|---|
| Taille insuffisante du sous-réseau de passerelle | Le réseau {vnetName} virtuel n’a pas suffisamment d’espace pour déployer une autre passerelle. |
Supprimez et recréez gatewaySubnet en tant que préfixe /27 ou plus court (par exemple, /26 ou /25). Pour obtenir des conseils, consultez Supprimer et recréer un sous-réseau. |
| Mode de connexion hérité | Les connexions ExpressRoute liées à la passerelle ont été créées avant 2017 (mode hérité). | Supprimez et recréez toutes les connexions avant de lancer la migration. Pour obtenir des instructions détaillées, consultez Convertir les connexions de passerelle ExpressRoute héritées. |
| Circuit dédié incompatible | La migration de passerelle ne peut pas se poursuivre en raison d’un module de sécurité matériel dédié (HSM) connecté au réseau virtuel. | Pour poursuivre la migration, libérez le module de sécurité matériel dédié (HSM). Pour obtenir des instructions détaillées sur la résolution des problèmes, consultez Résoudre les problèmes de HSM dédié. |
| Ressources en état d’échec | L’étape validée échoue si la passerelle ou toute ressource connectée, telle que des circuits, des connexions, des adresses IP publiques, des réseaux virtuels ou gatewaySubnet, est dans un état d’échec. | Vérifiez que toutes les ressources sont dans un état réussi avant de lancer le processus de migration. Pour plus d’informations, consultez Résolution des problèmes d’état d’échec. |
| Limitation des SKU de passerelle par défaut | Les passerelles par défaut doivent être mises à niveau vers une référence SKU Standard avant la migration pour garantir la résilience de zone. | Remplacez la référence SKU de passerelle par Standard avant de poursuivre la migration. Pour plus d’informations, consultez Redimensionner une référence SKU de passerelle. |
| Restriction de configuration FastPath | L’activation ou la désactivation de FastPath pendant la migration n’est pas prise en charge. | Vérifiez que FastPath reste dans sa configuration d’origine avant de poursuivre la migration. |
| Restriction de modification du poids de l’itinéraire | L’ajustement du poids de l’itinéraire pendant la migration n’est pas autorisé. | Rétablissez le poids de l’itinéraire à sa valeur d’origine avant de poursuivre le processus de migration. |
Scénarios non pris en charge à éviter
Le tableau suivant présente les scénarios non pris en charge qui peuvent entraîner des échecs de migration et qui n’ont pas de résolutions disponibles :
| Nom de l’erreur | Message | La cause |
|---|---|---|
| Nombre maximal de passerelles dans le réseau virtuel atteint | L’opération a échoué pour le réseau {virtualNetworkName} virtuel, car elle contient déjà le nombre maximal de passerelles autorisées. |
Un réseau virtuel ne peut pas avoir plus de deux passerelles ExpressRoute déployées. |
| Limite de connexion dépassée | La passerelle existante a {connectionCount} connexions, ce qui dépasse la limite de {circuitLimit} connexions pour la nouvelle taille de passerelle {gatewaySize}. |
La migration vers une passerelle avec une limite de connexion inférieure à celle de la passerelle existante n’est pas autorisée. La rétrogradation du type de référence SKU n’est pas prise en charge. |
| Restriction FastPath | ExpressRouteGatewayByPass n’est pas pris en charge pour les passerelles de taille {gatewaySize}. |
Les passerelles connectées aux connexions compatibles FastPath peuvent uniquement migrer vers les SKU UltraPerf ou ERGW3AZ. La rétrogradation du type de référence SKU n’est pas prise en charge. |
| Autorisation de circuit révoquée | L’opération a échoué pour le réseau {virtualNetworkName} virtuel, car elle contient déjà le nombre maximal de passerelles autorisées. |
Les passerelles connectées aux circuits avec des autorisations révoquées ne peuvent pas poursuivre la migration. |
Étapes suivantes
- Découvrez comment migrer à l’aide du portail Azure.
- Découvrez comment migrer à l’aide de PowerShell.
- Explorez les meilleures pratiques pour la haute disponibilité.