Google Cloud Functions 擴充功能

叫用 Node.js 函式

下例示範的是呼叫 Google Cloud Functions 擴充功能的擴充功能摘要政策。擴充功能呼叫了預設的「hello world」函式。

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