Google Cloud Functions 擴充功能

叫用 Node.js 函式

以下範例是呼叫 Google Cloud Functions 擴充功能的 Extension callout 政策。這個擴充功能會呼叫 Cloud Functions API 啟用的預設「hello world」函式。

下列 Node.js JavaScript 是在 GCP 帳戶的 Cloud Functions 中部署。如果要求包含訊息屬性，程式碼就會傳回該屬性。否則，則會傳回「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 中。下列 Extension callout 政策設定程式碼會使用這個名稱，以及與部署函式所在 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 函式傳回 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>