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

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

הדוגמה הבאה כוללת מדיניות של תוספי יתרונות מרכזיים שמפעילה תוסף של Google Cloud Functions. התוסף מפעיל את פונקציית ברירת המחדל "hello world" כשמפעילים את 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. קוד ההגדרה הבא של מדיניות ExtensionCallout משתמש בשם הזה, לצד ערכים של אזור ומזהה פרויקט שתואמים לפרטים של סביבת 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>