תוסף לפונקציות של Google Cloud

הפעלה של הפונקציה Node.js

הדוגמה הבאה כוללת מדיניות יתרונות מרכזיים של תוסף שמפעילה תוסף Google Cloud Functions. התוסף קורא לברירת המחדל "שלום עולם" שכלולה כשמפעילים את Cloud Functions API.

קוד ה-JavaScript הבא של Node.js נפרס ב-Cloud Functions עבור חשבון GCP. אם הבקשה כוללת מאפיין הודעה, הקוד יחזיר אותו. אחרת, היא מחזירה '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);
};

הדוגמה הזו כוללת תוסף של Google Cloud Functions שהוגדר עם פרטי כניסה לצורך אימות וקבלת הרשאה להפעלת קוד ב-Cloud Functions.

קוד הפונקציה הקודם נשמר ב-Cloud Functions כ-helloWorld. קוד ההגדרה הבא של מדיניות תוסף היתרונות המרכזיים משתמש בשם הזה, יחד עם ערכי אזור ומזהה פרויקט שתואמים לפרטים של סביבת Cloud Functions שבה הפונקציה פרוסה.

<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. בדוגמה הזו מוגדר parsed="false" בתג <Output> של המדיניות, שמונע מהמדיניות לנתח את תגובת ה-JSON. ברוב המקרים, כשמגדירים תוסף של Cloud Functions, מגדירים את parsed="false". ראו <Output> של הרכיב.

אם הפונקציה של Cloud Functions מחזירה תגובת 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>