Extensión de Google Cloud Functions

Invoca la función de Node.js

En el siguiente ejemplo, se muestra una política de ExtensionCallout que llama a una extensión de Google Cloud Functions. La extensión llama a la función predeterminada "hello world" que se incluye cuando habilitas la API de Cloud Functions.

El siguiente código JavaScript de Node.js se implementa en Cloud Functions para una cuenta de GCP. Si la solicitud incluye una propiedad de mensaje, el código la devuelve. De lo contrario, devuelve "Hello World!" como respuesta.

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

Este ejemplo incluye una extensión de Google Cloud Functions configurada con las credenciales necesarias para autenticarse y obtener autorización para invocar código en Cloud Functions.

El código de la función anterior se guarda en Cloud Functions simplemente como helloWorld. El siguiente código de configuración de la política de ExtensionCallout usa este nombre, junto con los valores de región y el ID del proyecto que coinciden con los detalles del entorno de Cloud Functions en el que se implementa la función.

<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 siguiente política AssignMessage captura el valor de respuesta para fines de depuración.

<?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 respuesta a la solicitud anterior sería similar a la siguiente:

Hello yourself!

El valor predeterminado de parsed es true. En este ejemplo, se establece parsed="false" en la etiqueta <Output> de la política, lo que impide que la política analice la respuesta JSON. En la mayoría de las situaciones en las que se usa la extensión de Cloud Functions, se establece parsed="false". Consulta el elemento<Output> para obtener más información.

Si la función de Cloud Functions devuelve una respuesta JSON y configuras parsed="true", la respuesta de la extensión será una referencia de objeto. Para extraer la respuesta de la referencia, usa la siguiente sintaxis: {objectName}.{jsonKey}. Por ejemplo:

function.response.message

Sintaxis

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

Ejemplo

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