إضافة AWS Lambda

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

الإصدار: 1.1.1

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

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

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

لمحة عن AWS Lambda

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

المهام

استدعاء

لاستدعاء دالة على AWS Lambda

لمزيد من التفاصيل حول المعلَمات، يُرجى الاطّلاع على مستندات AAWS Lambda Invoke.

البنية

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

مَعلمات الطلب

لمزيد من التفاصيل حول المعلَمات، يُرجى الاطّلاع على مستندات AAWS Lambda Invoke.

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

الإجابة

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

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

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

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

listFunctions

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

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

البنية

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

مَعلمات الطلب

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

المَعلمة الوصف Type تلقائي مطلوبة
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"
  }
]

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

الموقع الوصف Type القيمة التلقائية
الوصف وصف الدالة. سلسلة. بلا عُري
المعالِج الدالة التي تستدعيها لامدا لبدء تنفيذ الدالة. سلسلة. بلا عُري
FunctionArn اسم مورد Amazon الخاص بالدالة سلسلة. بلا عُري
FunctionName اسم الدالة. سلسلة. بلا عُري
Role دور تنفيذ الدالة. سلسلة. بلا عُري
وقت التشغيل بيئة وقت تشغيل الدالة. سلسلة. بلا عُري
الإصدار إصدار الدالة. سلسلة. بلا عُري

مرجع التكوين

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

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

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

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

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

يمكنك تحديد قيم لخصائص الإعداد التالية الخاصة بهذه الإضافة.

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

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

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