Google Cloud Functions 拡張機能

Node.js 関数を呼び出す

次の例は、Google Cloud Functions 拡張機能を呼び出す ExtensionCallout ポリシーを示しています。この拡張機能ではデフォルトの「hello world」がCloud Functions API を有効にするときに含める必要があります。

次の Node.js JavaScript が、GCP アカウントの Cloud Functions にデプロイされます。リクエストに 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);
};

この例には、Cloud Functions のコードを呼び出すための認証と認可に必要な認証情報が構成された Google Cloud Functions 拡張機能が含まれています。

上の関数コードは、単純に helloWorld として Cloud Functions に保存されます。次の ExtensionCallout ポリシー構成コードでは、この名前と、関数がデプロイされる Cloud Functions 環境の詳細に一致するリージョン ID とプロジェクト 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>