Extensión de Google Cloud Functions

Invoca la función de Node.js

En el siguiente ejemplo, se presenta una política de ExtensionExtension 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 de 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 mostrará. De lo contrario, muestra “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 como helloWorld. El siguiente código de configuración de la política ExtensionExtension usa este nombre, junto con los valores de ID del proyecto y región 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 deAssignMessage 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 como la siguiente:

Hello yourself!

El valor predeterminado de parsed es true. En este ejemplo, se configura parsed="false" en la etiqueta <Output> de la política, lo que evita que la política analice la respuesta JSON. En la mayoría de las situaciones, cuando usas la extensión de Cloud Functions, debes configurar parsed="false". Consulta Elemento<Output> para obtener más información.

Si la Cloud Function muestra una respuesta JSON y configuras parsed="true", la respuesta de la extensión es 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>