Publication de données vers une fonction Lambda AWS à l'aide d'une destination personnalisée

Avant de commencer

Assurez-vous que vous disposez d'une fonction Lambda active. Pour plus de détails sur la création d'une fonction Lambda AWS, voir https://docs.aws.amazon.com/lambda/latest/dg/getting-started.html

Assurez-vous d'avoir configuré l'alias AWS. Pour plus d'informations sur la configuration d'un alias AWS, voir Configuration d'un alias AWS.

Procédure

Ouvrez le menu des options et sélectionnez Administration.
Cliquez sur Destinations.
Sélectionnez Destinations personnalisées dans le volet de navigation gauche.

La page Destination personnalisée s'affiche.
Indiquez le nom de la destination personnalisée dans le champ Nom.
Le nom doit être unique et ne doit pas être le nom d'une destination prédéfinie telle que webMethods API Gateway telles que Elasticsearch.
Pour configurer les conditions qui déterminent les données à publier dans la destination spécifiée, procédez comme suit dans la section Conditions :
- Sélectionnez l'une des options suivantes dans le champ Type de condition :
  - Et... Publier des données qui répondent à toutes vos conditions.
  - Ou bien. Publier des données qui répondent à l'une de vos conditions.
- Cliquez sur + Ajouter une condition.
- Fournissez les détails suivants pour votre condition :
  - Variable. Nom de la variable sur laquelle vous voulez valider votre condition. Ce champ prend en charge les variables disponibles dans le cadre des variables. Pour plus de détails sur la liste des variables disponibles, voir Variable Framework.
  - Opérateur. L'opérateur à utiliser pour relier la variable et la valeur.
  - Valeur. La valeur de la variable à laquelle il faut correspondre pour satisfaire à la condition.
- Cliquez sur Ajouter.
La condition apparaît dans la grille.

Répétez ce processus pour ajouter le nombre de conditions. Cliquez sur une condition pour la modifier et cliquez sur l'icône de suppression à côté d'une condition pour la supprimer.
Sélectionnez AWS Lambda dans le champ Type.

Fournissez les informations suivantes dans la section AWS Lambda.

Propriété	Descriptif
Nom de fonction	Indiquez le nom de la fonction Lambda AWS vers laquelle vous souhaitez publier les données configurées.
Type d'appel	Spécifiez le type d'invocation de AWS, asynchrone ou synchrone. Les options disponibles sont les suivantes RequestResponse (type synchrone) Événement (type asynchrone)
Alias AWS	Fournir l'alias AWS configuré pour le compte AWS.

Configurer les propriétés de l'extension personnalisée.

Pour plus d'informations sur les propriétés des extensions personnalisées et leurs descriptions, voir Propriétés des extensions personnalisées.
Dans la section Événements, sélectionnez les données que vous souhaitez publier vers la destination configurée. Les options disponibles sont les suivantes
- Types d'événements. Type d'événements à publier vers la destination spécifiée. Les types d'événements disponibles sont les suivants
  - Error Se produit chaque fois qu'une invocation de l'API entraîne une erreur.
  - Cycle de vie Se produit chaque fois qu'un webMethods API Gateway est démarré ou arrêté.
  - Policy violation (violation de la politique) Se produit chaque fois qu'une invocation de l'API viole l'application de la politique définie pour l'API.
- Données sur les indicateurs de performance. Pour publier vers la destination spécifiée.
  Dans le champ Intervalle de publication des données de mesure des performances, entrez un intervalle de temps (en minutes) pour spécifier la fréquence de publication des données de mesure des performances webMethods API Gateway doit publier les mesures de performance. Indiquez une valeur comprise entre 1 et 60. La valeur par défaut est de 60 minutes.
- et les événements organisés. webMethods API Gateway les modules pour lesquels les journaux d'audit sont publiés vers la destination spécifiée.
Cliquez sur Ajouter.

La destination personnalisée est créée avec succès et apparaît dans la page Destinations personnalisées. Les événements configurés sont publiés dans la destination spécifiée.

Remarque : pour modifier une destination personnalisée, vous pouvez cliquer sur la destination personnalisée, apporter des modifications, puis cliquer sur Mettre à jour. Pour supprimer une destination personnalisée, cliquez sur l'icône Supprimer en regard de la destination personnalisée. Vous ne pouvez pas supprimer une destination personnalisée associée à une API.

Etape suivante

Vous pouvez voir une référence de destination du portail du développeur obsolète dans une API publiée.

Une ancienne référence de destination du portail des développeurs est associée à toutes les API. Toutefois, cette ancienne référence n'est plus disponible. Il est toujours associé à toutes les API. Ainsi, toutes les API ont deux destinations associées au portail du développeur, l'une correcte et l'autre obsolète.

Supprimer la référence obsolète comme suit

Récupérez les détails de l'API en utilisant l'appel GET REST suivant : http://localhost:5555/rest/apigateway/apis/apiId
Récupérez les informations associées au portail en utilisant l'appel GET REST suivant : http://localhost:5555/rest/apigateway/portalGateways
Récupérez l'association webMethods API Gateway à l'association du portail du développeur en utilisant l'appel GET REST suivant : http://localhost:9240/gateway_default/deploymentmap/_search

Pour chaque API, deux entrées sont affichées : une pour la référence actuelle du portail et une autre pour la référence périmée. Vous pouvez supprimer les documents de référence périmés du magasin de données.

Vous pouvez supprimer la référence périmée en utilisant la requête REST suivante.

SUPPRIMER http://localhost:9240/gateway_default/deploymentmap/id

L'ID que vous fournissez est l'ID correspondant aux détails de la référence périmée que vous voyez dans la réponse à l'étape 3.

Vous ne pouvez pas publier une API sur le portail des développeurs.

L'échec de la publication des API sur le portail du développeur est dû à une mauvaise configuration de la destination pour le portail du développeur.

Résolution Allez dans le menu Utilisateur > Administration > Destinations > Portail du développeur. Assurez-vous que tous les détails de la configuration de la destination sont fournis correctement. Si vous apportez des modifications, vous devez republier la configuration pour qu'elles prennent effet. Vous voyez des applications périmées dans le portail du développeur.

Lorsqu'un consommateur s'abonne à un plan ou à un paquet, une application est créée à la fois dans webMethods API Gateway et dans le portail du développeur. Par erreur, lorsque vous supprimez une application de Gateway, l'application dans le portail du développeur devient obsolète.

Pour supprimer les applications périmées du portail du développeur, dépubliez le paquet associé à l'application et republiez-le. Cela déclenche le nettoyage de l'application périmée dans le portail du développeur.