תוסף AWSda - AWS

אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X. info

גרסה: 2.0.0

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

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

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

מידע על 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 אפשר לציין אם להחזיר את 4KB האחרונים של נתוני היומן. מחרוזת ללא. לא.
מגדיר הגרסה של הכינוי של פונקציית Lambda שפורסמה. מחרוזת ללא. לא.
מטען ייעודי (payload) JSON כקלט לפונקציית Lambda. מחרוזת ללא. לא.

תשובה

מערך של פונקציות שמכיל פרטי גרסה ספציפיים. דוגמה:

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

מאפייני התשובה

נכס תיאור סוג ברירת מחדל
StatusCode . מספר שלם ללא.
מטען ייעודי 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"
  }
]

מאפייני התשובה

נכס תיאור סוג ברירת מחדל
תיאור תיאור הפונקציה. מחרוזת. ללא.
Handler הפונקציה ש-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"
}

כששולחים אותו דרך ה-API לניהול, הוא ערך בקידוד base64 שנוצר מקובץ ה-JSON של המפתח.		 ללא. כן.