Guide pratique pour créer une API de gestion des ressources de base avec Azure Functions (préversion)

Cet article vous guide tout au long de la création d’une API fictif de base pour une application de gestion des ressources à l’aide d’Azure Functions. L’API expose une seule opération pour retourner une liste de ressources. Vous allez également apprendre à créer un connecteur personnalisé dans Power Platform à l’aide de gestion des API.

Cette API de base fournit une liste de ressources factices et est prête à être intégrée à Power Platform à l’aide d’un connecteur personnalisé via Gestion des API.

Prerequisites

• Accès au portail Azure
• Environnement Power Platform avec des applications de code activées

Créer une fonction Azure dans le portail Azure

1. Accédez au portail Azure.

2. Sélectionnez Créer une ressource>Application de fonction Web>.

3. Sélectionnez Consommation.

4. Renseignez les détails requis :

   Détail	Descriptif
   Subscription	Sélectionnez votre abonnement
   Groupe de ressources	Créez-en un ou utilisez-en un existant
   Nom de l’application de fonction	Choisir un nom unique
   Pile d’exécution	Node.js
   Region	Choisir une région proche de vous

5. Sélectionnez Vérifier + créer, puis Créer.

   

6. Une fois le déploiement terminé, accédez à votre nouvelle application de fonction.

7. Sélectionnez Créer une fonction.

8. Si vous y êtes invité, sélectionnez : Environnement de développement : Développer dans le portail.

9. Sélectionnez le déclencheur HTTP comme modèle, attribuez-lui le nom GetAssetset définissez le niveau d’autorisationsur Anonyme , car aucune authentification n’est requise dans cet exemple de base.

   

10. Sélectionnez Créer pour créer la fonction.

11. Sous l’onglet Code + Test , remplacez le code de fonction par le code d’API fictif de la section suivante.

12. Cliquez sur Enregistrer.

Implémenter l’API fictive

Modifiez GetAssets/index.js pour retourner une liste factice des ressources :

module.exports = async function (context, req) {
    context.res = {
        // status: 200, /* Defaults to 200 */
        body: [
            { id: 1, name: "Laptop", type: "Electronics", status: "Available" },
            { id: 2, name: "Projector", type: "Electronics", status: "In Use" },
            { id: 3, name: "Desk", type: "Furniture", status: "Available" },
            { id: 4, name: "Office Chair", type: "Furniture", status: "In Use" },
            { id: 5, name: "Monitor", type: "Electronics", status: "Available" },
            { id: 6, name: "Whiteboard", type: "Office Supply", status: "Available" },
            { id: 7, name: "Phone", type: "Electronics", status: "In Use" },
            { id: 8, name: "Tablet", type: "Electronics", status: "Available" },
            { id: 9, name: "Printer", type: "Electronics", status: "Maintenance" },
            { id: 10, name: "Filing Cabinet", type: "Furniture", status: "Available" }
        ]
    };
};

Exposer votre application de fonction via la gestion des API

1. Sur le portail Azure, recherchez et sélectionnez Services Gestion des API.

2. Sélectionnez + Créer pour créer une instance Gestion des API. Le niveau Développeur est gratuit pour le développement/test.

3. Renseignez les détails requis et déployez l’instance.

4. Une fois déployé, ouvrez votre instance Gestion des API.

5. Dans le menu de gauche, sélectionnez APIs>+ Ajouter API>Application de Fonctions.

   

6. Sélectionnez votre Function App et la fonction GetAssets.

   

7. Suivez la procédure de l’Assistant pour importer votre fonction en tant qu’opération d’API.

8. Après l’importation, accédez à votre API dans Gestion des API.

9. Dans le menu supérieur, sélectionnez Paramètres de votre API.

10. Sous Sécurité, définissez Abonnement requis sur Désactivé. Cela supprime la nécessité d’une clé d’abonnement (clé API) lors de l’appel de l’API.

    

11. Enregistrez vos modifications.

Créer un connecteur personnalisé dans Power Platform à l’aide de la gestion des API (à partir du portail Azure)

1. Dans les services gestion des API dans le menu de gauche dans les API, sélectionnez Power Platform.

2. Sélectionnez Créer un connecteur.

3. Sélectionnez votre API :

   

4. Sélectionnez votre environnement et votre nom d’affichage, puis sélectionnez Créer. Le connecteur personnalisé est créé dans votre environnement sélectionné.

5. Dans Power Apps, accédez aux connecteurs personnalisés pour passer en revue, modifier et tester votre nouveau connecteur.

   

Étapes suivantes

• Créer une nouvelle application de programmation à l’aide de ce connecteur personnalisé avec le SDK Power Apps.
• Développez l’API avec plus d’opérations si nécessaire. N'oubliez pas de mettre à jour le connecteur avec les nouvelles opérations lorsque vous effectuez ces modifications.
• Sécurisez votre API si vous passez au-delà du développement/test.