תוסף AWSda - AWS

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X.
מידע

גרסה: 1.1.1

הפעלת פונקציות שנפרסות ב-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 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 מפתח זה.
ללא. כן.