Extension Google Cloud Functions

Appeler la fonction Node.js

L'exemple suivant présente une règle ExtensionAccroche qui appelle une extension Google Cloud Functions. L'extension appelle la version par défaut "hello world" est incluse lorsque vous activez l'API Cloud Functions.

Le code JavaScript Node.js suivant est déployé dans Cloud Functions pour un compte GCP. Si la requête inclut une propriété de message, le code la renvoie. Sinon, il renvoie "Hello World!" comme réponse.

/**
 * 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);
};

Cet exemple inclut une extension Google Cloud Functions configurée avec les identifiants nécessaires pour s'authentifier et obtenir l'autorisation d'appeler du code sur Cloud Functions.

Le code de fonction précédent est enregistré dans Cloud Functions sous le nom simplement helloWorld. Le code de configuration de la règle ExtensionAccroche suivant utilise ce nom, ainsi que les valeurs de région et d'ID de projet correspondant aux spécificités de l'environnement Cloud Functions dans lequel la fonction est déployée.

<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>

La règle AssignMessage suivante capture la valeur de la réponse à des fins de débogage.

<?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>

La réponse à la demande ci-dessus ressemblerait à ceci:

Hello yourself!

La valeur par défaut de parsed est true. Cet exemple définit parsed="false" dans la balise <Output> de la stratégie, ce qui empêche la stratégie d'analyser la réponse JSON. Dans la plupart des cas, vous devez définir parsed="false" lorsque vous utilisez l'extension Cloud Functions. Voir <Sortie> .

Si la fonction Cloud renvoie une réponse JSON et que vous définissez parsed="true", la réponse de l'extension est une référence d'objet. Pour extraire la réponse de la référence, utilisez la syntaxe suivante: {objectName}.{jsonKey}. Exemple :

function.response.message

Syntaxe

<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>

Exemple

<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>