Google Cloud Functions 扩展程序

调用 Node.js 函数

以下示例展示了调用 Google Cloud Functions 扩展程序的 ExtensionCallout 政策。此扩展程序会调用您启用 Cloud Functions API 时包含的默认“hello world”函数。

在 Cloud Functions 中为 GCP 帐号部署了以下 Node.js JavaScript。如果请求包含消息属性，代码会返回该属性。否则，它会返回“Hello World!”作为响应。

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

此示例包含一个 Google Cloud Functions 扩展程序，该扩展程序配置了进行身份验证和获得在 Cloud Functions 上调用代码的授权所需的凭据。

上述函数代码以 helloWorld 的形式保存在 Cloud Functions 中。以下 ExtensionCallout 政策配置代码会使用此名称，以及与部署该函数的 Cloud Functions 环境的具体情况相匹配的区域和项目 ID 值。

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

以下 assignMessage 政策会捕获响应值，以便进行调试。

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

parsed 的默认值为 true。此示例在政策的 <Output> 标记中设置 parsed="false"，这会阻止政策解析 JSON 响应。在使用 Cloud Functions 扩展程序的大多数情况下，您可以设置 parsed="false"。如需了解详情，请参阅 <Output> 元素。

如果 Cloud Functions 函数返回 JSON 响应，并且您设置了 parsed="true"，则扩展程序的响应是一个对象引用。如需从引用中提取响应，请使用以下语法：{objectName}.{jsonKey}。例如：

function.response.message

语法

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