Partage via

Comment migrer une instance Gestion des API Azure d'une région vers une autre

  • Article

S’APPLIQUE À : Développeur | De base | Standard | Premium

Cet article explique comment déplacer une instance de Gestion Azure vers une autre région Azure. Vous aurez peut être à migrer votre instance vers une autre région pour de multiples raisons. Par exemple :

  • Localisez votre instance plus près de vos consommateurs d’API
  • Déployer les fonctionnalités disponibles uniquement dans des régions spécifiques
  • Respecter les exigences de gouvernance et de stratégie internes

Pour migrer des instances de Gestion des API d'une région Azure vers une autre, vous pouvez utiliser les opérations de sauvegarde et de restauration du service. Vous pouvez utiliser un autre nom d’instance de Gestion des API ou le nom existant.

Notes

La Gestion des API prend également en charge le déploiement multirégions, qui distribue un service de gestion des API Azure unique sur plusieurs régions Azure. Ce déploiement multirégions permet de réduire la latence de la requête telle qu’elle est perçue par les consommateurs distribués de l’API et améliore la disponibilité du service si une région est mise hors connexion.

À propos de l’installation

  • Choisissez le même niveau tarifaire de Gestion des API dans les régions source et cible.
  • La sauvegarde et la restauration ne fonctionneront pas lors de la migration entre différents types de cloud. Pour ce scénario, exportez la ressource en tant que modèle. Adaptez ensuite le modèle exporté à la région Azure cible et recréez la ressource.

Prérequis

  • Passez en revue les exigences et les limitations des opérations de sauvegarde et de restauration de la Gestion des API.
  • Consultez les Éléments non sauvegardés. Enregistrez les paramètres et les données que vous devrez recréer manuellement après le déplacement de l’instance.
  • Créez un compte de stockage situé dans la région source. Vous allez utiliser ce compte pour sauvegarder l’instance source.

Préparer et déplacer

Option 1 : Utiliser un nom d'instance Gestion des API différent

  1. Dans la région cible, créez une nouvelle instance Gestion des API avec le même niveau tarifaire que l'instance source. Utilisez un nom différent pour la nouvelle instance.
  2. Sauvegardez l'instance de Gestion des API existante sur le compte de stockage.
  3. Restaurez la sauvegarde de l’instance source vers la nouvelle instance de Gestion des API.
  4. Si vous disposez d'un domaine personnalisé pointant vers l'instance Gestion des API de la région source, mettez à jour l'enregistrement CNAME du domaine personnalisé pour qu'il pointe vers la nouvelle instance Gestion des API.

Option n°2 : Utiliser le même nom d'instance Gestion des API

Avertissement

Cette option supprime l’instance de Gestion des API d’origine et entraîne un temps d’arrêt pendant la migration. Vérifiez que vous disposez d’une sauvegarde valide avant de supprimer l’instance source.

  1. Sauvegardez l'instance de Gestion des API existante sur le compte de stockage.
  2. Supprimez l'instance de Gestion des API de la région source.
  3. Créez une nouvelle instance Gestion des API dans la région cible en lui attribuant le même nom que celle de la région source.
  4. Restaurez la sauvegarde de l’instance source vers la nouvelle instance de Gestion des API dans la région cible.

Vérifier

  1. Assurez-vous que l’opération de restauration se termine correctement avant d’accéder à votre instance de Gestion des API dans la région cible.
  2. Configurez les paramètres qui ne sont pas déplacés automatiquement au cours de l’opération de restauration. Exemples : la configuration du réseau virtuel, les identités managées, le contenu du portail des développeurs et les certificats de l’autorité de certification personnalisée et du domaine personnalisé.
  3. Accédez à vos points de terminaison de Gestion des API dans la région cible. Par exemple, testez vos API ou accédez au portail des développeurs.

Nettoyer les ressources sources

Si vous avez déplacé l’instance Gestion des API à l’aide de l’Option 1, vous pouvez supprimer l’instance source après la restauration et la configuration réussies de l’instance cible.

Étapes suivantes