إضافة AWS Lambda

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X.
معلومات

الإصدار: 1.0.0

تنفيذ الدوال المنشورة على AWS Lambda يمكنك استخدام هذه الإضافة لإدراج الدوال المتاحة في حسابك على AWS، ثم استدعاء وظائف محدَّدة.

المتطلبات الأساسية

قبل استخدام الإضافة من خادم وكيل لواجهة برمجة التطبيقات باستخدام سياسة ExtensionCallout، عليك إجراء ما يلي:

لمحة عن AWS Lambda

يوفر AWS Lambda بيئات حوسبة يمكنك من خلالها تنفيذ الدوال بإحدى اللغات المتاحة.

المهام

استدعاء

لاستدعاء دالة في AWS Lambda.

لمزيد من التفاصيل عن المَعلمات، اطّلِع على مستندات استدعاء AWSS Lambda.

البنية

<Action>invoke</Action>
<Input><![CDATA[
{
  "functionName" : "function-on-lambda",
  "invocationType" : "RequestResponse | Event | DryRun",
  "logType" : "None | Tail",
  "qualifier" : "Version-or-alias",
  "payload" : "Escaped-JSON-string"
}
]]>
</Input>
<Output>flow-variable</Output>

مثال

<Action>invoke</Action>
<Input><![CDATA[
{
  "functionName" : "helloWorld",
  "invocationType" : "RequestResponse",
  "logType" : "None",
  "qualifier" : "$LATEST",
  "payload" : "{ \"key\": \"val\" }"
}
]]>
</Input>
<Output>function.response.value</Output>

معلمات الطلب

لمزيد من التفاصيل عن المَعلمات، اطّلِع على مستندات استدعاء AWSS Lambda.

المعلمة الوصف النوع تلقائي مطلوب
functionName اسم الدالة المطلوب استدعاؤها. سلسلة. بلا عُري نعم.
invocationType تحدِّد هذه السياسة ما إذا كان سيتم استدعاء الدالة بشكل متزامن أو غير متزامن أو التحقّق من صحة قيم المَعلمات. سلسلة. بلا عُري لا.
logType تحدّد هذه السياسة بشكل اختياري ما إذا كان سيتم عرض آخر 4 كيلوبايت من بيانات السجلّ. سلسلة بلا عُري لا.
مؤهِّل تمثّل هذه السمة إصدار الاسم المستعار لدالة لامدا منشورة. سلسلة بلا عُري لا.
حمولة البيانات JSON كإدخال في دالة lambda. سلسلة بلا عُري لا.

الرد

يشير ذلك المصطلح إلى مصفوفة من الدوال التي تحتوي على تفاصيل إصدار معيّن. فيما يلي مثال:

{
  "StatusCode" : 200,
  "Payload" : "{\"statusCode\":200,\"body\":\"\\\"Hello World!\\\"\"}"
}

خصائص الاستجابة

الموقع الوصف النوع تلقائي
StatusCode رمز حالة HTTP‬. عدد صحيح بلا عُري
الحمولة ملف JSON الذي يمثل الكائن الذي تعرضه الدالة لا تتم مشاركة العرض إلا إذا كان نوع الاستدعاء هو RequestResponse. بالنسبة لخطأ دالة، يحتوي هذا على رسالة وصف الخطأ. سلسلة بلا عُري

listFunctions

يسرد دوال AWS Lambda المتاحة.

للحصول على مزيد من التفاصيل عن المَعلمات، يمكنك الاطّلاع على مستندات دوال ListFunctions في AWS.

البنية

<Action>listFunctions</Action>
<Input><![CDATA[
{
  "masterRegion" : "ALL | [a-z]{2}(-gov)?-[a-z]+-\d{1}",
  "functionVersion" : "ALL",
  "maxItems" : 1 - 10000
}
]]>
</Input>
<Output>flow-variable</Output>

مثال

<Action>listFunctions</Action>
<Input><![CDATA[
{
  "masterRegion" : "ALL",
  "functionVersion" : "ALL",
  "maxItems" : 50
}
]]>
</Input>
<Output>function.list</Output>

معلمات الطلب

للحصول على مزيد من التفاصيل عن المَعلمات، يمكنك الاطّلاع على مستندات دوال ListFunctions في AWS.

المعلمة الوصف النوع تلقائي مطلوب
masterRegion المنطقة (مثل us-east-2) التي يجب إدراج وظائفها. ALL لتضمين الدوال من أي منطقة. وإذا تم تحديدها، يجب أيضًا تحديد functionVersion. سلسلة بلا عُري لا.
functionVersion حدِّد ALL لإدراج جميع النُسخ المنشورة. في حال عدم تحديد قيمة، لن يتم عرض سوى آخر إصدار ARN لم يتم نشره. سلسلة بلا عُري لا.
maxItems الحد الأقصى لعدد الدوال المطلوب عرضها استجابةً للدالة. يجب أن تكون القيمة أكبر من 0. الحد الأقصى المطلق الذي يمكن إرجاعه هو 50. عدد صحيح بلا عُري لا.

الرد

JSON يمثل مجموعة من الدوال التي تحتوي على تفاصيل إصدار محددة.

[
  {
    "FunctionName": "helloWorld",
    "FunctionArn": "arn:aws:lambda:fake-region:012345:function:helloWorld",
    "Runtime": "nodejs",
    "Role": "arn:aws:iam::012345:role/service-role/fakeRole",
    "Handler": "index.handler",
    "Description": "A Hello World lambda function.",
    "Version": "$LATEST"
  },
  {
    "FunctionName": "helloWorld",
    "FunctionArn": "arn:aws:lambda:fake-region:012345:function:helloWorld",
    "Runtime": "nodejs",
    "Role": "arn:aws:iam::012345:role/service-role/fakeRole",
    "Handler": "index.handler",
    "Description": "A Hello World lambda function.",
    "Version": "1"
  }
]

خصائص الاستجابة

الموقع الوصف النوع القيمة التلقائية
الوصف تمثّل هذه السمة وصفًا للدالة. سلسلة. بلا عُري
المعالج الدالة التي تستدعيها لامدا لبدء تنفيذ الدالة. سلسلة. بلا عُري
FunctionArn اسم مورد Amazon الخاص بالدالة. سلسلة. بلا عُري
FunctionName تمثّل هذه السمة اسم الدالة. سلسلة. بلا عُري
الدور يشير ذلك المصطلح إلى دور تنفيذ الدالة. سلسلة. بلا عُري
وقت التشغيل بيئة وقت تشغيل الدالة سلسلة. بلا عُري
الإصدار إصدار الدالة. سلسلة. بلا عُري

مرجع الإعداد

يمكنك استخدام ما يلي عند إعداد هذه الإضافة ونشرها للاستخدام في الخوادم الوكيلة لواجهة برمجة التطبيقات. لمعرفة خطوات إعداد إضافة باستخدام وحدة تحكُّم Apigee، يُرجى الاطّلاع على إضافة إضافة وضبطها.

خصائص الإضافات الشائعة

السمات التالية متاحة لكل إضافة.

الموقع الوصف تلقائي عنصر مطلوب
name الاسم الذي تُعطِه هذه الإضافة من الإضافات. لا ينطبق متوافق
packageName اسم حزمة الإضافة كما هو مُوضَّح من Apigee Edge. لا ينطبق متوافق
version رقم إصدار حزمة الإضافة التي تجري عملية إعداد الإضافة منها. لا ينطبق متوافق
configuration قيمة الإعداد المتعلقة بالإضافة التي تدرجها الاطّلاع على خصائص حزمة الإضافات هذه لا ينطبق متوافق

خصائص حزمة الإضافات هذه

حدِّد قيمًا لخصائص الضبط التالية الخاصة بهذه الإضافة.

الموقع الوصف تلقائي مطلوب
منطقة لامدا AWS اسم المنطقة التي تم نشر الدوال بها. مثلاً: us-east-1 بلا عُري نعم.
بيانات الاعتماد ويكون هذا الملف عند إدخاله في وحدة تحكُّم Apigee Edge، وهو ملف JSON يحتوي على رقم تعريف مفتاح الوصول إلى Amazon ومفتاح الوصول إليه بالصيغة التالية:

{
"accessKeyId" : "access-key-ID",
"secretAccessKey" : "secret-access-key"
}

عند إرسال هذا الملف عبر واجهة برمجة تطبيقات الإدارة، يتم إنشاء قيمة بترميز base64 يتم إنشاؤها من ملف JSON للمفتاح هذا.
بلا عُري نعم.