يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات
Apigee X. المعلومات
الإصدار: 1.0.0
تنفيذ الدوالّ المنشورة في AWS Lambda استخدِم هذه الإضافة لسرد الوظائف المتاحة في حسابك على AWS، ثم استدعاء دوال محددة.
المتطلبات الأساسية
قبل استخدام الإضافة من خادم وكيل لواجهة برمجة التطبيقات باستخدام سياسة ExtensionCallout، يجب عليك:
احصل على رقم تعريف مفتاح الوصول ومفتاح الوصول السري الخاص بـ Amazon.
ستحتاج إلى هذه الإضافة، إلى جانب اسم المنطقة التي يتمّ نشر الدوالّ فيها، configure هذه الإضافة.
انشر دالة Lambda. لكي تتمكن الإضافة من الوصول إلى دالة Lambda، يجب أن تكون:
- تم النشر في سحابة VPC عامة.
- تم النشر في سحابة VPC خاصة باستخدام بوابة NAT العامة
راجِع ضبط دالة Lambda للوصول إلى الموارد في سحابة VPC في Amazon لمزيد من المعلومات.
لمحة عن 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 هذا للمفتاح. |
بلا عُري | نعم. |