Tutoriel : Utiliser l'extension Gestion des API Azure pour Visual Studio Code pour importer et gérer des API

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

Dans ce tutoriel, vous allez apprendre à utiliser l’extension Gestion des API Azure pour Visual Studio Code pour les opérations courantes dans Gestion des API. Vous pouvez utiliser l’environnement Visual Studio Code familier pour importer, mettre à jour, tester et gérer des API.

Remarque

Actuellement, cette fonctionnalité n’est pas disponible dans les espaces de travail.

Dans cet article, vous allez apprendre à :

• Importer une API dans Gestion des API
• Modifier l’API
• Appliquer des stratégies de gestion d'API
• Tester l’API

Pour une introduction à d’autres fonctionnalités gestion des API, consultez Importer et publier votre première API.

Prérequis

• Comprendre la terminologie relative au service Gestion des API Azure
• Installez Visual Studio Code et la dernière extension Gestion des API Azure pour Visual Studio Code.
• Créez une instance Gestion des API.

Importer une API

L’exemple suivant importe une spécification OpenAPI au format JSON dans Gestion des API. Pour cet exemple, vous importez l’API Petstore open source.

1. Dans Visual Studio Code, sélectionnez l’icône Azure dans la barre d’activités.

2. Dans le volet de l’Explorateur, développez l’instance Gestion des API que vous avez créée.

3. Cliquez avec le bouton droit sur API, puis sélectionnez Importer à partir d’un lien OpenAPI.

4. Quand vous y êtes invité, entrez les valeurs suivantes :

   1. Un lien OpenAPI pour du contenu au format JSON. Pour cet exemple : https://petstore.swagger.io/v2/swagger.json .

      Ce fichier spécifie le service back-end qui implémente l’exemple de l’API et les opérations qu’elle prend en charge.

   2. Nom d’API, tel que petstore, unique dans l’instance Gestion des API. Ce nom ne peut contenir que des lettres, des chiffres et des traits d’union. Le premier et le dernier caractères doivent être alphanumériques. Ce nom est utilisé dans le chemin pour appeler l’API.

Une fois l’API importée, elle apparaît dans le volet de l’Explorateur et les opérations d’API disponibles sont listées sous le nœud Opérations.

Modifier l’API

Vous pouvez modifier l’API dans Visual Studio Code. Par exemple, modifiez la description JSON Resource Manager de l’API dans la fenêtre de l’éditeur pour supprimer le protocole http utilisé pour accéder à l’API, qui est mis en évidence dans la capture suivante :

Pour modifier le format OpenAPI, cliquez avec le bouton droit sur le nom de l’API dans le volet de l’Explorateur, puis sélectionnez Modifier OpenAPI. Apportez vos modifications, puis sélectionnez Fichier>Enregistrer.

Appliquer des stratégies à l’API

Gestion des API fournit des stratégies que vous pouvez configurer pour vos API. Les politiques sont un ensemble de déclarations. Ces instructions sont exécutées de manière séquentielle sur demande ou sur réponse d’une API. Les stratégies peuvent être soit globales (c’est-à-dire qu’elles s’appliquent à toutes les API de votre instance Gestion des API), soit propres à un produit, une API ou une opération d’API.

Cette section montre comment appliquer des stratégies entrantes et sortantes courantes à votre API.

1. Dans le volet de l’Explorateur, sélectionnez Stratégie sous l’API petstore que vous avez importée. Le fichier de stratégie s’ouvre dans la fenêtre de l’éditeur. Ce fichier configure des stratégies pour toutes les opérations dans l’API.

2. Mettez à jour le fichier avec le contenu suivant :

   <policies>
       <inbound>
           <rate-limit calls="3" renewal-period="15" />
           <base />
       </inbound>
       <outbound>
           <set-header name="Custom" exists-action="override">
               <value>"My custom value"</value>
             </set-header>
           <base />
       </outbound>
       <on-error>
           <base />
       </on-error>
   </policies>
   

   • La rate-limit stratégie de la inbound section limite le nombre d’appels à l’API à 3 appels toutes les 15 secondes.
   • La stratégie set-header dans la section outbound ajoute un en-tête de réponse personnalisé à des fins de démonstration.

3. Enregistrez le fichier . Si vous y êtes invité, sélectionnez Charger pour charger le fichier dans le cloud.

Tester l’API

Pour tester l'API, obtenez une clé de la souscription puis faites une requête à la passerelle de Gestion des API.

Obtenir la clé d’abonnement

Vous avez besoin d’une clé d’abonnement pour permettre à votre instance Gestion des API de tester l’API importée et les stratégies appliquées.

1. Dans le volet de l’Explorateur, cliquez avec le bouton droit sur le nom de votre instance Gestion des API.

2. Sélectionnez Copier la clé d’abonnement. Cette clé concerne l'abonnement à accès illimité intégré créé lorsque vous créez une instance de Gestion des API.

   

   Attention

   La souscription à accès illimité permet d'accéder à chaque API de cette instance de Gestion des API et ne doit être utilisé que par les utilisateurs autorisés. Ne l'utilisez jamais pour un accès de routine à l'API et n'intégrez jamais la clé d'accès complet dans les applications clientes.

Tester une opération d’API

1. Dans le volet de l’Explorateur, développez le nœud Opérations sous l’API petstore que vous avez importée.

2. Sélectionnez une opération comme [GET] Find pet by ID (Trouver un animal de compagnie par ID), puis cliquez avec le bouton droit sur l’opération et sélectionnez Opération de test.

3. Dans la fenêtre de l’éditeur, remplacez 5 pour le paramètre petId dans l’URL de requête.

4. Dans la fenêtre de l’éditeur, en regard d’Ocp-Apim-Subscription-Key, copiez la clé d’abonnement que vous avez copiée.

5. Sélectionnez Envoyer une demande.

   

Quand la demande réussit, le back-end répond avec 200 OK et des données.

Notez le détail suivant dans la réponse :

• L’en-tête Custom est ajouté à la réponse.

Testez maintenant la stratégie de limitation de débit. Sélectionnez Envoyer une requête plusieurs fois dans une ligne. Après l’envoi d’un nombre trop important de requêtes dans la période configurée, vous obtenez la réponse 429 Too Many Requests.

Traitement des requêtes de trace

Vous pouvez éventuellement obtenir des informations détaillées sur le suivi des requêtes pour vous aider à déboguer et dépanner l'API.

Pour connaître les étapes permettant d’activer le suivi pour une API, consultez Activer le suivi pour une API. Pour limiter la divulgation involontaire d’informations sensibles, le traçage n’est autorisé que pendant 1 heure par défaut.

Nettoyer les ressources

Quand vous n’en avez plus besoin, enlevez l’instance Gestion des API en cliquant avec le bouton droit et en sélectionnant Ouvrir dans le portail pour supprimer le service Gestion des API et son groupe de ressources.

Vous pouvez également sélectionner Supprimer la gestion des API pour supprimer uniquement l’instance Gestion des API. Cette opération ne supprime pas son groupe de ressources.

Contenu connexe

L’extension Gestion des API fournit plus de fonctionnalités pour travailler avec vos API, telles que :

• Créer, comprendre et déboguer des stratégies de gestion des API Azure (disponibles dans le niveau de service Développeur)
• Utiliser des valeurs nommées dans les stratégies gestion des API Azure