Rozszerzenie Google Cloud Functions

Wywołaj funkcję Node.js

Poniższy przykład przedstawia zasadę ExtensionCallout wywołującą rozszerzenie Google Cloud Functions. Rozszerzenie wywołuje domyślną funkcję „hello world” dostępną po włączeniu interfejsu Cloud Functions API.

Poniższy kod JavaScript Node.js jest wdrożony w Cloud Functions na koncie GCP. Jeśli żądanie zawiera właściwość wiadomości, kod ją zwraca. W przeciwnym razie zwraca w odpowiedzi „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);
};

Ten przykład obejmuje skonfigurowane rozszerzenie Google Cloud Functions za pomocą danych logowania potrzebnych do uwierzytelnienia i uzyskania autoryzacji do wywoływania kodu w Cloud Functions.

Poprzedni kod funkcji jest zapisywany w Cloud Functions jako po prostu helloWorld. Następujący kod konfiguracji zasady ExtensionCallout używa tej nazwy, a także wartości regionu i identyfikatora projektu pasujące do specyfiki środowiska Cloud Functions, w którym ta funkcja jest wdrożona.

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

Ta zasada AssignMessage przechwytuje wartość odpowiedzi na potrzeby debugowania.

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

Odpowiedź na powyższą prośbę wyglądałaby w następujący sposób:

Hello yourself!

Wartością domyślną parsed jest true. W tym przykładzie ustawia się parsed="false" w tagu <Output> zasady, co uniemożliwia zasadę przeanalizowanie odpowiedzi JSON. W większości przypadków podczas korzystania z rozszerzenia Cloud Functions ustawiasz parsed="false". Więcej informacji znajdziesz w sekcji Element<output>.

Jeśli funkcja w Cloud Functions zwraca odpowiedź JSON, a Ty ustawisz parsed="true", odpowiedź z rozszerzenia jest odwołaniem do obiektu. Aby wyodrębnić odpowiedź z pliku referencyjnego, użyj tej składni: {objectName}.{jsonKey}. Na przykład:

function.response.message

Składnia

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

Przykład

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