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 ruft die Standardfunktion „Hello World“ auf, 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 dieses zurück. Andernfalls wird „Hello World!“ als Antwort zurückgegeben.

/**
 * 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 wird, die für die 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 Regions- und Projekt-ID-Werten, die mit den Angaben der Cloud Functions-Umgebung übereinstimmen, 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 Debugging-Zwecken.

<?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 würde so aussehen:

Hello yourself!

Der Standardwert von parsed ist true. In diesem Beispiel wird parsed="false" im Tag <Output> der Richtlinie festgelegt, wodurch verhindert wird, dass die Richtlinie die JSON-Antwort parst. In den meisten Situationen, in denen die Cloud Functions-Erweiterung verwendet wird, legen Sie parsed="false" fest. Weitere Informationen finden Sie unter <Output>-Element.

Wenn die Cloud Functions-Funktion eine JSON-Antwort zurückgibt und Sie parsed="true" festlegen, ist die Antwort der Erweiterung ein Objektverweis. Verwenden Sie 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>