Google Cloud Functions 拡張機能

Node.js 関数を呼び出す

次の例は Google Cloud Functions 拡張機能を呼び出す ExtensionCallout ポリシーについて説明しています。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);
};

この例には、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 Function が 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>