Partager via

Importer une API gRPC

S’APPLIQUE À : Développeur | Premium

Cet article montre comment importer une définition de service gRPC tant qu’API dans API Management. Vous pouvez ensuite gérer l’API dans API Management, sécuriser l’accès, puis appliquer d’autres stratégies, puis transmettre des requêtes d’API gRPC via la passerelle vers le serveur principal gRPC.

Pour ajouter une API gRPC à API Management, vous devez :

  • Charger le fichier de définition Protobuf (mémoire tampon de protocole) de l’API dans API Management
  • Spécifier l’emplacement de votre service gRPC
  • Configurer l’API dans API Management

API Management prend en charge la méthode Pass-through avec les types de méthodes de service gRPC suivants : type unaire, diffusion en continu du serveur, diffusion en continu du client et diffusion en continu bidirectionnelle. Si vous souhaitez en savoir plus sur gRPC, consultez Présentation de gRPC.

Remarque

  • Actuellement, les API gRPC sont prises en charge dans la passerelle auto-hébergée uniquement, pas dans la passerelle managée de votre instance API Management.
  • Actuellement, le test des API gRPC n’est pas pris en charge dans la console de test du portail Azure, ni dans le portail des développeurs API Management.
  • L’importation est limitée à un seul fichier Protobuff (.proto).

Prérequis

Ajouter une API gRPC

  1. Dans le portail Azure, accédez à votre instance API Management.

  2. Dans le menu de gauche, sélectionnez API>+ Ajouter une API.

  3. Sous Définir une nouvelle API, sélectionnez gRPC.

    Capture d’écran de la création d’une API gRPC dans le portail.

  4. Dans la fenêtre Créer une fenêtre d’API gRPC, sélectionnez Complète.

  5. Pour une API gRPC, vous devez spécifier les paramètres suivants :

    1. Dans Charger un schéma, sélectionnez un fichier .proto local associé à l’API à importer.

    2. Dans URL du serveur gRPC, entrez l’adresse du service gRPC. L’adresse doit être accessible via HTTPS.

    3. Dans la liste Passerelles, sélectionnez la ressource de passerelle que vous souhaitez utiliser pour exposer l’API.

      Important

      En préversion publique, vous ne pouvez sélectionner qu’une passerelle auto-hébergée. La passerelle managée n’est pas prise en charge.

  6. Entrez les paramètres restants pour configurer votre API. Ces paramètres sont expliqués dans le tutoriel Importer et publier votre première API.

  7. Sélectionnez Créer.

    L’API est ajoutée à la liste des API. Vous pouvez afficher et mettre à jour vos paramètres en accédant à l’onglet Paramètres de l’API.

Appeler les services gRPC avec .NET

Pour plus d’informations sur l’appel de services gRPC avec .NET, consultez les articles suivants :

Ajouter d’autres API

Vous pouvez composer une API à partir d'API exposées par différents services, notamment :

  • Une spécification OpenAPI
  • Une API SOAP
  • Une API GraphQL
  • Une application web hébergée dans Azure App Service
  • Les fonctions Azure
  • Azure Logic Apps
  • Azure Service Fabric

Remarque

Lorsque vous importez une API, les opérations sont ajoutées à votre API actuelle.

Pour ajouter une API à une API existante :

  1. Accédez à votre instance Azure API Management dans le portail Azure :

    Capture d’écran montrant la page des services API Management.

  2. Sélectionnez API dans la page Vue d’ensemble, ou sélectionnez API>API dans le menu de gauche.

    Capture d’écran montrant la sélection d’API dans la page Vue d’ensemble.

  3. Sélectionnez les points de suspension (...) à côté de l’API à laquelle vous souhaitez ajouter une autre API.

  4. Sélectionnez Importer dans le menu déroulant :

    Capture d’écran montrant la commande d’importation.

  5. Sélectionnez un service à partir duquel importer une API.

Contenu connexe