برنامه افزودنی Google Cloud Functions

تابع Node.js را فراخوانی کنید

مثال زیر دارای یک خط مشی ExtensionCallout است که یک برنامه افزودنی Google Cloud Functions را فراخوانی می کند. برنامه افزودنی تابع پیش‌فرض «Hello world» را که در هنگام فعال کردن Cloud Functions API گنجانده شده است، فراخوانی می‌کند.

جاوا اسکریپت Node.js زیر در توابع Cloud برای یک حساب GCP مستقر شده است. اگر درخواست شامل ویژگی پیام باشد، کد آن را برمی گرداند. در غیر این صورت، "سلام جهان!" به عنوان پاسخ آن

/**
 * 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 است که با اعتبارنامه های مورد نیاز برای احراز هویت و دریافت مجوز برای فراخوانی کد در توابع ابری پیکربندی شده است .

کد تابع قبلی در توابع ابری به سادگی به عنوان 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 پاسخ 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>