Extension Google Cloud Functions

Vous consultez la documentation Apigee Edge.
Accédez à la documentation Apigee X.

Version 2.0.2

Appelez les fonctions Cloud déployées dans votre projet Google Cloud.

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

Prérequis

Ce contenu fournit des informations 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éfinissez et déployez des fonctions dans Cloud Functions pour votre projet Google Cloud.

3. Accordez l'accès aux utilisateurs 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. Utilisez la console GCP pour générer une clé pour le compte de service.

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

À propos de Cloud Functions

Google Cloud Functions vous permet de créer et de déployer des fonctions sur Google Cloud, puis de les appeler à partir d'un autre code. Pour une introduction à Cloud Functions, essayez 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

Appelle 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 la 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 propres à cette extension.