מוצג המסמך של Apigee Edge.
עוברים אל
מסמכי תיעוד של Apigee X. מידע
גרסה: 1.1.2
להפעיל פונקציות שנפרסו ב-AWS Lambda. התוסף הזה מאפשר להציג ברשימה את הפונקציות הזמינות בחשבון AWS שלכם, ולאחר מכן להפעיל פונקציות ספציפיות.
דרישות מוקדמות
לפני שמשתמשים בתוסף משרת proxy ל-API באמצעות המדיניות בנושא תוספי יתרונות מרכזיים, צריך:
מקבלים את מזהה מפתח הגישה ומפתח הגישה הסודי של Amazon.
אתם צריכים את הנתונים האלה ואת שם האזור שבו הפונקציות פרוסות, כדי להגדיר את התוסף הזה.
פורסים את פונקציית Lambda. כדי שלתוסף תהיה גישה לפונקציית Lambda, הוא צריך להיות:
- פריסה ב-VPC ציבורי
- פרוסות ב-VPC פרטי עם שער NAT ציבורי
מידע נוסף זמין במאמר הגדרת פונקציה של Lambda לצורך גישה למשאבים ב-Amazon VPC.
מידע על AWS Lambda
AWS Lambda מספק סביבות מחשוב שבהן אפשר להפעיל פונקציות באחת מהשפות הנתמכות.
פעולות
להפעיל
הפעלת פונקציה ב-AWS Lambda.
פרטים נוספים על פרמטרים זמינים במסמכי התיעוד של AWS 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>
פרמטרים של בקשה
פרטים נוספים על פרמטרים זמינים במסמכי התיעוד של AWS Lambda Invoke.
פרמטר | תיאור | סוג | ברירת מחדל | חובה |
---|---|---|---|---|
functionName | שם הפונקציה שרוצים להפעיל. | מחרוזת. | ללא. | כן. |
invocationType | המדיניות קובעת אם להפעיל את הפונקציה באופן סינכרוני, אסינכרוני או לאמת ערכי פרמטרים. | מחרוזת. | ללא. | לא. |
logType | אפשרות זו מציינת אם להחזיר את 4 ה-KB האחרונים של נתוני היומן. | מחרוזת | ללא. | לא. |
מגדיר | גרסת הכינוי של פונקציית Lambda שפורסמה. | מחרוזת | ללא. | לא. |
מטען ייעודי (payload) | JSON כקלט לפונקציית Lambda. | מחרוזת | ללא. | לא. |
תשובה
מערך פונקציות של פרטי גרסה ספציפית. לדוגמה:
{
"StatusCode" : 200,
"Payload" : "{\"statusCode\":200,\"body\":\"\\\"Hello World!\\\"\"}"
}
מאפייני תגובה
נכס | תיאור | סוג | ברירת מחדל |
---|---|---|---|
StatusCode | . | מספר שלם | ללא. |
מטען ייעודי (payload) | JSON שמייצג את האובייקט שהפונקציה מחזירה. הצגה רק אם סוג ההפעלה הוא RequestResponse. אם מופיעה שגיאה בפונקציה, תופיע הודעת תיאור שגיאה. | מחרוזת | ללא. |
listFunctions
רשימה של פונקציות AWS Lambda הזמינות.
פרטים נוספים על פרמטרים זמינים במאמרי העזרה של AWS 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>
פרמטרים של בקשה
פרטים נוספים על פרמטרים זמינים במאמרי העזרה של AWS Lambda ListFunctions.
פרמטר | תיאור | סוג | ברירת מחדל | חובה |
---|---|---|---|---|
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"
}
]
מאפייני תגובה
נכס | תיאור | סוג | ברירת מחדל |
---|---|---|---|
תיאור | תיאור של הפונקציה. | מחרוזת. | ללא. |
מטפל | הפונקציה ש-Lambda קוראת לה כדי להתחיל לבצע את הפונקציה. | מחרוזת. | ללא. |
FunctionArn | שם המשאב ב-Amazon של הפונקציה. | מחרוזת. | ללא. |
FunctionName | שם הפונקציה. | מחרוזת. | ללא. |
תפקיד | תפקיד הביצוע של הפונקציה. | מחרוזת. | ללא. |
זמן ריצה | סביבת זמן הריצה של הפונקציה. | מחרוזת. | ללא. |
גרסה | הגרסה של הפונקציה. | מחרוזת. | ללא. |
חומר עזר על הגדרות אישיות
כשאתם מגדירים ופורסים את התוסף הזה לשימוש בשרתי proxy ל-API, יש להשתמש באפשרויות הבאות. להוראות להגדרת תוסף באמצעות מסוף Apigee, ראו הוספה והגדרה של תוסף.
מאפייני תוספים נפוצים
המאפיינים הבאים קיימים בכל תוסף.
נכס | תיאור | ברירת המחדל | נדרש |
---|---|---|---|
name |
השם שבחרת לתצורה הזו של התוסף. | ללא | כן |
packageName |
השם של חבילת התוסף כפי שהוא סופק על ידי Apigee Edge. | ללא | כן |
version |
מספר הגרסה של חבילת התוסף שממנה מגדירים את התוסף. | ללא | כן |
configuration |
ערך הגדרה ספציפי לתוסף שרוצים להוסיף. מאפיינים לחבילת תוספים זו | ללא | כן |
מאפיינים של חבילת התוספים הזו
יש לציין ערכים למאפיינים הבאים של הגדרות אישיות שספציפיים לתוסף הזה.
נכס | תיאור | ברירת מחדל | חובה |
---|---|---|---|
אזור AWS Lambda | שם האזור שבו הפונקציות פרוסות. לדוגמה: us-east-1 . |
ללא. | כן. |
פרטי כניסה | אם מזינים אותו במסוף Apigee Edge, זהו קובץ JSON שמכיל את מזהה מפתח הגישה ומפתח הגישה של Amazon בפורמט הבא:{ "accessKeyId" : "access-key-ID", "secretAccessKey" : "secret-access-key" } אם הוא נשלח באמצעות Management API, הוא נוצר בקידוד base64 שנוצר מקובץ ה-JSON של המפתח. |
ללא. | כן. |