Ekstensi Google Cloud Functions

Memanggil fungsi Node.js

Contoh berikut menampilkan kebijakan Extensioncallout yang memanggil ekstensi Google Cloud Functions. Ekstensi memanggil "hello world" default disertakan saat Anda mengaktifkan Cloud Functions API.

Node.js JavaScript berikut di-deploy di Cloud Functions untuk akun GCP. Jika permintaan menyertakan properti pesan, kode akan menampilkan properti tersebut. Jika tidak, kueri akan menampilkan "Hello World!" (Halo Dunia) sebagai responsnya.

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

Contoh ini mencakup ekstensi Google Cloud Functions yang dikonfigurasi dengan kredensial yang diperlukan untuk mengautentikasi dan memperoleh otorisasi untuk memanggil kode di Cloud Functions.

Kode fungsi sebelumnya disimpan di Cloud Functions hanya sebagai helloWorld. Kode konfigurasi kebijakan Extensioncallout berikut menggunakan nama ini, beserta nilai region dan project ID yang cocok dengan detail lingkungan Cloud Functions tempat fungsi di-deploy.

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

Kebijakan MenetapkanMessage berikut merekam nilai respons untuk tujuan proses debug.

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

Respons terhadap permintaan di atas adalah seperti berikut:

Hello yourself!

Nilai default parsed adalah true. Contoh ini menetapkan parsed="false" dalam tag <Output> kebijakan, yang mencegah kebijakan mengurai respons JSON. Untuk sebagian besar situasi saat menggunakan ekstensi Cloud Functions, Anda menetapkan parsed="false". Lihat <Output> elemen untuk informasi selengkapnya.

Jika Cloud Function menampilkan respons JSON dan Anda menetapkan parsed="true", respons dari ekstensi tersebut adalah referensi objek. Untuk mengekstrak respons dari referensi, gunakan sintaksis berikut: {objectName}.{jsonKey}. Contoh:

function.response.message

Sintaksis

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

Contoh

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