Google Cloud Functions-Erweiterung

Node.js-Funktion aufrufen

Das folgende Beispiel enthält eine ExtensionCallout-Richtlinie zum Aufrufen einer Google Cloud Functions-Erweiterung. Die Erweiterung nennt die Standardeinstellung „Hello World“. die beim Aktivieren der Cloud Functions API enthalten ist.

Der folgende Node.js-JavaScript-Code wird in Cloud Functions für ein GCP-Konto bereitgestellt. Wenn die Anfrage ein Nachrichtenattribut enthält, gibt der Code dies zurück. Andernfalls wird „Hello World!“ zurückgegeben. als Antwort geben.

/**
 * 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);
};

Dieses Beispiel enthält eine Google Cloud Functions-Erweiterung, die mit Anmeldedaten konfiguriert ist, die zur Authentifizierung und Autorisierung zum Aufrufen von Code in Cloud Functions erforderlich sind.

Der vorherige Funktionscode wird in Cloud Functions einfach als helloWorld gespeichert. Der folgende ExtensionCallout-Richtlinienkonfigurationscode verwendet diesen Namen zusammen mit den Regions- und Projekt-ID-Werten, die den Angaben der Cloud Functions-Umgebung entsprechen, in der die Funktion bereitgestellt wird.

<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>

Die folgende AssignMessage-Richtlinie erfasst den Antwortwert zu Fehlerbehebungszwecken.

<?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>

Die Antwort auf die obige Anfrage sieht so aus:

Hello yourself!

Der Standardwert von parsed ist true. In diesem Beispiel wird parsed="false" im <Output>-Tag der Richtlinie festgelegt. Dadurch wird verhindert, dass die Richtlinie die JSON-Antwort parst. Für die meisten Situationen bei Verwendung der Cloud Functions-Erweiterung legen Sie parsed="false" fest. Siehe <Output> .

Wenn die Cloud Functions-Funktion eine JSON-Antwort zurückgibt und Sie parsed="true" festlegen, ist die Antwort der Erweiterung eine Objektreferenz. Verwende die folgende Syntax, um die Antwort aus der Referenz zu extrahieren: {objectName}.{jsonKey}. Beispiel:

function.response.message

Syntax

<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>

Beispiel

<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>