Google Cloud Functions 扩展程序

调用 Node.js 函数

以下示例展示了调用 Google Cloud Functions 扩展程序的 ExtensionCallout 政策。该扩展程序会调用默认的“hello world”函数。

以下 Node.js JavaScript 已在 Cloud Functions 中针对一个 GCP 账号部署。如果请求包含 message 属性，则代码会返回该属性。否则，它会返回“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 上的代码所需的凭据。

上述函数代码在 Cloud Functions 中保存为 helloWorld。以下 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>