Extension Google Cloud Functions

Appeler une fonction Node.js

L'exemple suivant présente une règle ExtensionCallout qui appelle une extension Google Cloud Functions. L'extension appelle la fonction "hello world" par défaut 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 le message "Hello World!" en tant que 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 ExtensionCallout utilise ce nom, ainsi que les valeurs de région et d'ID de projet correspondant aux caractéristiques 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ègleAssignMessage 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 requête ci-dessus se présente comme suit:

Hello yourself!

La valeur par défaut de parsed est true. Cet exemple définit parsed="false" dans le tag <Output> de la stratégie, ce qui empêche celle-ci d'analyser la réponse JSON. Dans la plupart des cas, lorsque vous utilisez l'extension Cloud Functions, vous devez définir parsed="false". Consultez la section Élément<Output> pour en savoir plus.

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>