כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של
Apigee X. מידע
גרסה: 1.1.1
הפעלת פונקציות שנפרסות ב-AWS Lambda. אפשר להשתמש בתוסף הזה כדי להציג רשימה של הפונקציות הזמינות בחשבון AWS, ולאחר מכן להפעיל פונקציות ספציפיות.
דרישות מוקדמות
לפני שמשתמשים בתוסף משרת proxy של API באמצעות המדיניות בנושא יתרונות מרכזיים של תוסף, צריך:
מקבלים מזהה מפתח גישה ומפתח גישה סודי של Amazon.
כדי configure את התוסף הזה, תצטרכו את ההרשאות האלה, וגם את שם האזור שבו הפונקציות נפרסות.
פריסת פונקציית 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 Resource Name של הפונקציה ב-Amazon. | מחרוזת. | ללא. |
FunctionName | שם הפונקציה. | מחרוזת. | ללא. |
תפקיד | תפקיד ביצוע של הפונקציה. | מחרוזת. | ללא. |
זמן ריצה | סביבת זמן הריצה של הפונקציה. | מחרוזת. | ללא. |
גרסה | גרסת הפונקציה. | מחרוזת. | ללא. |
סימוכין לתצורה
במהלך ההגדרה והפריסה של התוסף הזה לשימוש בשרתי proxy של API, צריך להשתמש בהגדרות הבאות. לשלבים להגדרת תוסף באמצעות מסוף Apigee, אפשר לעיין במאמר הוספה והגדרה של תוסף.
מאפיינים נפוצים של תוספים
המאפיינים הבאים קיימים בכל תוסף.
נכס | תיאור | ברירת המחדל | נדרש |
---|---|---|---|
name |
השם שבחרת לתצורה הזו של התוסף. | ללא | כן |
packageName |
השם של חבילת התוסף כפי שהוא סופק על ידי Apigee Edge. | ללא | כן |
version |
מספר הגרסה של חבילת התוסף שממנה מגדירים את התוסף. | ללא | כן |
configuration |
ערך הגדרה ספציפי לתוסף שרוצים להוסיף. מאפיינים לחבילת תוספים זו | ללא | כן |
המאפיינים של חבילת התוספים הזו
מציינים ערכים למאפייני ההגדרה הבאים שספציפיים לתוסף הזה.
נכס | התיאור | ברירת המחדל | נדרש |
---|---|---|---|
אזור למבדא ב-AWS | שם האזור שבו הפונקציות נפרסות. לדוגמה: us-east-1 |
ללא. | כן. |
פרטי כניסה | כשמזינים אותו במסוף Apigee Edge, זהו קובץ JSON שמכיל את מזהה מפתח הגישה ומפתח הגישה של Amazon בפורמט הבא:{ "accessKeyId" : "access-key-ID", "secretAccessKey" : "secret-access-key" } כששולחים את הקובץ דרך ממשק ה-API לניהול, זהו ערך בקידוד base64 שנוצר מקובץ JSON מפתח זה. |
ללא. | כן. |