תוסף AWSda - AWS

מוצג המסמך של Apigee Edge.
עוברים אל מסמכי תיעוד של Apigee X.
מידע

גרסה: 1.1.2

להפעיל פונקציות שנפרסו ב-AWS Lambda. התוסף הזה מאפשר להציג ברשימה את הפונקציות הזמינות בחשבון AWS שלכם, ולאחר מכן להפעיל פונקציות ספציפיות.

דרישות מוקדמות

לפני שמשתמשים בתוסף משרת proxy ל-API באמצעות המדיניות בנושא תוספי יתרונות מרכזיים, צריך:

מידע על 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 של המפתח.
ללא. כן.