Développer des flux partagés

Cette page s'applique à Apigee et à Apigee hybrid.

Consultez la documentation d'Apigee Edge.

Remarque : Utilisez le développement local avec Apigee et Apigee hybrid 1.5 et versions ultérieures.

Combinez des règles et des ressources au sein d'un flux partagé : cela vous permet d'utiliser ce flux depuis plusieurs proxys d'API, et même depuis d'autres flux partagés. Bien qu'il soit comparable à un proxy, un flux partagé ne possède pas de point de terminaison. Il ne peut être utilisé que depuis un proxy d'API ou un flux partagé appartenant à la même organisation que le flux partagé lui-même.

Développez vos flux partagés à l'aide d'Apigee dans Cloud Code, comme décrit dans les sections suivantes. Voir aussi Gérer les dossiers et les fichiers dans un espace de travail Apigee.

Avant de commencer : familiarisez-vous avec les concepts décrits dans les rubriques suivantes :

• Créer des flux partagés réutilisables
• Ajouter un flux partagé via un hook de flux

Créer un flux partagé

Pour créer un flux partagé à l'aide d'Apigee dans Cloud Code, procédez comme suit :

1. Effectuez l'une des opérations suivantes :

   • Dans Apigee Explorer, placez le curseur sur le dossier shareflows et cliquez sur .

   • Cliquez sur Afficher > Palette de commandes pour ouvrir la palette de commandes, puis sélectionnez Cloud Code : Créer un groupe de flux partagés Apigee.

   L'assistant "Créer un flux partagé" s'ouvre.

2. Saisissez un nom unique pour le flux partagé lorsque l'invite s'affiche, puis appuyez sur Entrée.

Une fois la procédure de l'assistant terminée, le nouveau dossier sharedflow-name est ajouté sous sharedflows dans Apigee Explorer. Chaque dossier de flux partagé est structuré comme décrit dans la section Structure du répertoire de groupe de flux partagé.

Importer un groupe de flux partagé

Pour importer un groupe de flux partagé à l'aide d'Apigee dans Cloud Code, procédez comme suit :

1. Effectuez l'une des actions suivantes :

   • Dans Apigee Explorer, placez le curseur sur le dossier sharedflows et cliquez sur .

   • Cliquez sur Afficher > Palette de commandes pour ouvrir la palette de commandes, puis sélectionnez Cloud Code : Importer un groupe de flux partagés Apigee.

2. Accédez au groupe de flux partagé que vous souhaitez importer, puis cliquez sur Importer un flux partagé. Le groupe de flux partagé doit être structuré comme décrit dans la section Structure du répertoire d'un groupe de flux partagé.

3. (Facultatif) Par défaut, le nom du fichier ZIP moins son extension est utilisé pour le nom du flux partagé. Si ce nom n'est pas unique, vous êtes invité à en saisir un.

Le dossier sharedflow-name importé est ajouté sous sharedflows dans Apigee Explorer.

Configurer des flux partagés

Configurez les flux partagés, comme décrit dans les rubriques suivantes :

• Créer des flux partagés réutilisables
• Ajouter des fonctionnalités à l'aide de règles
• Gérer les ressources

Utiliser des flux partagés

Vous pouvez appeler un flux partagé à l'aide de la stratégie FlowCallout, comme décrit dans la règle FlowCallout.

En outre, en associant un flux partagé à un hook de flux, vous pouvez exécuter le flux partagé avant une demande proxy ou cible, ou après une réponse proxy ou cible. Pour en savoir plus, consultez les pages suivantes :

• Associer un flux partagé à l'aide d'un hook de flux (présentation des concepts)
• Associer des flux partagés à l'aide de hooks de flux (flowhooks.json) (étapes utilisant Apigee dans Cloud Code)

Remarque : Apigee ne valide pas les dépendances entre les flux partagés et les proxys d'API au moment du déploiement. Par exemple, si la règle FlowCallout d'un proxy d'API fait référence à un flux partagé qui n'existe pas ou qui n'est pas déployé, le déploiement du proxy d'API réussit toujours. Lorsqu'Apigee vérifie la dépendance au moment de l'exécution et que la validation échoue, Apigee génère une erreur de proxy d'API avec un code d'état HTTP 500.