Extension Google Cloud Functions

Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X. info

Version 2.0.0

Appelez des fonctions Cloud déployées via votre projet Google Cloud.

Actuellement, cette extension permet d'appeler des fonctions de déclencheur HTTP.

Prérequis

Ce contenu fournit une documentation de référence pour configurer et utiliser cette extension. Avant d'utiliser l'extension à partir d'un proxy d'API à l'aide de la règle ExtensionCallout, vous devez:

1. Activez l'API Cloud Functions.

2. Définir et deploy des fonctions dans Cloud Functions pour votre projet Google Cloud

3. Accordez un accès utilisateur via IAM pour le niveau d'accès souhaité pour la fonction. Par exemple, vous pouvez limiter l'accès à la fonction au seul compte de service que vous utilisez pour configurer l'extension.

4. Générez une clé pour le compte de service à l'aide de la console GCP.

5. Utilisez le contenu du fichier JSON de clé généré lorsque vous ajoutez et configurez l'extension à l'aide de la référence de configuration.

À propos de Cloud Functions

Avec Google Cloud Functions, vous pouvez créer et déployer des fonctions sur Google Cloud, puis les appeler à partir d'un autre code. Pour découvrir Cloud Functions, suivez l'un des guides de démarrage rapide.

Exemples

L'exemple suivant montre comment appeler des fonctions dans Cloud Functions à l'aide de la règle ExtensionCallout.

/**
 * Responds to any HTTP request.
 *
 * @param {!express:Request} req HTTP request context.
 * @param {!express:Response} res HTTP response context.
 */
exports.helloWorld = (req, res) => {
  let message = req.query.message || req.body.message || 'Hello World!';
  res.status(200).send(message);
};

<Action>invoke</Action>
<Input><![CDATA[
  {
    "region" : "us-central1",
    "projectId" : "my-project",
    "functionName" : "hello-world",
    "method" : "POST",
    "payload" : { "message" : "Hello yourself!" }
  }
]]></Input>
<Output parsed="false">function.response</Output>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Get-Function-Response">
    <DisplayName>Get Function Response</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{function.response}</Payload>
    </Set>
</AssignMessage>

Hello yourself!

Actions

appeler

Invoque une fonction Cloud.

Actuellement, cette extension permet d'appeler des fonctions de déclencheur HTTP.

<Action>invoke</Action>
<Input><![CDATA[
  {
    "region" : "deployment-region",
    "projectId" : "project-id",
    "functionName" : "function-name",
    "method" : "http-method",
    "payload" : { json-payload }
  }
]]></Input>
<Output>function.response</Output>

<Action>invoke</Action>
<Input><![CDATA[
  {
    "region" : "us-central1",
    "projectId" : "my-project",
    "functionName" : "hello-world",
    "method" : "POST",
    "payload" : { "message" : "Hello yourself!" }
  }
]]></Input>
<Output>function.response</Output>

Paramètres de requête

Réponse

Valeur de réponse de la fonction spécifiée, le cas échéant.

Propriétés de réponse

Aucune.

Documentation de référence sur la configuration

Utilisez les éléments suivants lorsque vous configurez et déployez cette extension pour l'utiliser dans des proxys d'API. Pour savoir comment configurer une extension à l'aide de la console Apigee, consultez Ajouter et configurer une extension.

Propriétés d'extension courantes

Les propriétés suivantes sont présentes pour chaque extension.

Propriétés de ce package d'extension

Spécifiez les valeurs des propriétés de configuration suivantes spécifiques à cette extension.