Tutoriel : Créer ou lier un Centre d’API à Gestion des API

Ce tutoriel montre comment intégrer une instance Gestion des API Azure à un Centre d’API Azure. Lorsqu’elles sont liées, les API de l’instance Gestion des API et les définitions d’API facultatives sont synchronisées en permanence dans l’inventaire du Centre d’API. Le Centre d’API est un hub central de catalogue et de gouvernance pour les API et les artefacts associés, et les clients Gestion des API l’utilisent pour découvrir et réutiliser des API, partager des définitions entre les équipes et appliquer des stratégies de gouvernance et de cycle de vie cohérentes.

Note

Un seul centre d’API peut être lié à une seule instance gestion des API.

Dans ce tutoriel, vous allez :

• Créer un centre d’API et le lier à une instance gestion des API
• Lier un centre d’API existant et synchroniser des API
• Afficher les API synchronisées et supprimer le lien si nécessaire

Prerequisites

Avant de commencer, vérifiez que vous répondez aux exigences suivantes.

• Un compte Azure avec un abonnement actif est requis. Si vous n’en avez pas déjà un, vous pouvez créer un compte gratuit.
• Un service Gestion des API existant dans l’abonnement dans lequel vous souhaitez gérer les API
• Autorisations de contributeur (ou propriétaire) sur la ressource Gestion des API et l’autorisation de créer des ressources dans un groupe de ressources

Créer un centre d’API et lier vos API

Ces étapes montrent comment créer un centre d’API et le lier à une instance gestion des API afin que les API soient synchronisées.

1. À partir du portail Azure, ouvrez votre service Gestion des API.

2. Dans le menu de gauche, accédez aux APIs>Centre d'API.

3. Dans le volet central, sous Utiliser le Centre d’API pour la découverte, la réutilisation et la gouvernance des API, sélectionnez Créer.

4. Dans la page Créer un centre d’API , sélectionnez Créer un lien.

5. Fournissez des valeurs pour les champs suivants :

   Champ	Détails
   groupe de ressources	Sélectionnez un groupe de ressources existant ou créez-en un.
   Emplacement	Choisissez une région. Les régions disponibles pour le Centre d’API peuvent différer de la région de votre instance Gestion des API.
   Nom	Fournissez un nom unique pour l’instance du Centre d’API.
   Plan tarifaire	Sélectionnez un plan.
   Cycle de vie	Sélectionnez l’état du cycle de vie à associer aux API lorsqu’elles sont synchronisées. Ces métadonnées peuvent être modifiées ultérieurement.

6. Sélectionnez Créer.

   • Une fois l’opération terminée, vous devez voir un message de demande réussi et une confirmation que votre service Gestion des API et le Centre d’API sont synchronisés.

Utiliser un Centre d’API existant

Ces étapes montrent comment lier une instance Gestion des API à un Centre d’API existant déjà.

1. Dans la section Centre des API de votre service Gestion des API, sélectionnez Utiliser le Centre d’API existant.
2. Dans la liste déroulante, choisissez le Centre d’API que vous souhaitez lier.
3. Sélectionnez Synchroniser les API pour démarrer la synchronisation entre le service Gestion des API et le Centre d’API sélectionné.

Afficher le Centre d’API lié et les API synchronisées

Utilisez cette section pour vérifier l’état d’intégration et afficher les API synchronisées à partir de Gestion des API.

1. Dans le portail Azure, ouvrez la ressource du Centre d’API.
2. Dans le menu de gauche du Centre des API, accédez à Plateformes>Integrations. L’état de l’intégration à Gestion des API doit indiquer lié et synchronisé.
3. Pour afficher les API synchronisées, accédez auxAPI>.
   Une icône s’affiche indiquant que les API sont liées.

Supprimer le lien vers le Centre d’API

Procédez comme suit pour supprimer le lien entre Gestion des API et le Centre d’API ou pour supprimer la ressource du Centre d’API.

1. Dans la ressource du Centre d’API, recherchez l’instance gestion des API liée.
2. Dans le menu de gauche, accédez à Plateformes>Integrations.
3. Sélectionnez l’icône corbeille pour supprimer le lien.

Nettoyer les ressources

Supprimez les ressources que vous avez créées pour ce didacticiel afin d’éviter les frais.

Si vous avez créé un Centre d’API pour ce didacticiel et n’en avez plus besoin, supprimez la ressource du Centre d’API et tout groupe de ressources que vous avez créé pour éviter les frais.

Contenu connexe

Synchroniser les API à partir d’une instance Gestion des API