תוסף Amazon S3

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

גרסה: 1.1.1

ניהול קבצים בקטגוריה של Amazon S3. בעזרת התוסף הזה אפשר להציג, להוריד ולמחוק קבצים. אפשר גם ליצור כתובת URL חתומה להורדת קובץ.

כל מופע שהוגדר של התוסף הזה עובד עם קטגוריה ספציפית. עבור קטגוריות מרובות, יש להשתמש במופע שהוגדר של התוסף הזה לכל קטגוריה.

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

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

• משיגים את מזהה מפתח הגישה ומפתח הגישה הסודי של קטגוריית Amazon S3 שבה אתם עובדים.

  הם נדרשים, יחד עם שם הקטגוריה של AWS ואזור AWS, כדי configure את התוסף הזה.

מידע על Amazon S3

Amazon Simple Storage Service (Amazon S3) הוא שירות אחסון אובייקטים.

פעולות

deleteFile

מחיקת הקובץ שצוין מקטגוריה של S3.

<Action>deleteFile</Action>
<Input><![CDATA[
{
  "fileName" : "name-of-file-to-delete"
}
]]>
</Input>

<Action>deleteFile</Action>
<Input><![CDATA[
{
  "fileName" : "names.tmp"
}
]]>
</Input>

פרמטרים של בקשה

תשובה

ללא.

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

ללא.

downloadFile

הורדת הקובץ שצוין מקטגוריה של S3.

<Action>downloadFile</Action>
<Input><![CDATA[
{
  "fileName" : "filename"
}
]]>
</Input>
<Output>flow-variable</Output>

<Action>downloadFile</Action>
<Input><![CDATA[
{
  "fileName" : "product-sheet.pdf"
}
]]>
</Input>
<Output>downloaded.file</Output>

פרמטרים של בקשה

תשובה

JSON עם המאפיין content שמכיל את תוכן הקובץ.

{
  "content":"Hello World!"
}

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

generateSignedURL

הפונקציה יוצרת כתובת URL חתומה להורדת הקובץ שצוין מקטגוריה של S3.

<Action>generateSignedURL</Action>
<Input><![CDATA[
{
  "fileName": "filename",
  "expiresIn": duration-in-seconds
}
]]>
</Input>
<Output>flow-variable</Output>

<Action>generateSignedURL</Action>
<Input><![CDATA[
{
  "fileName": "product-info.pdf",
  "expiresIn": 3600
}
]]>
</Input>
<Output>download.url</Output>

פרמטרים של בקשה

תשובה

קובץ JSON עם נכס של מחרוזת url שמכיל את כתובת ה-URL שנוצרה.

{
  "url":"https://fake.s3.amazonaws.com/hello_world.txt?AWSAccessKeyId=123&Expires=1542753572&Signature=ABC"
}

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

listFiles

מפעילה את הביצוע של פונקציית AWS Lambda.

<Action>listFiles</Action>
<Input><![CDATA[{}]]></Input>
<Output>flow-variable</Output>

צריך לציין parsed="false" ברכיב <Output> אם רוצים שהמשתנה יכיל את קובץ ה-JSON הגולמי. אחרת, לא ניתן להשתמש במשתנה.

<Action>listFiles</Action>
<Input><![CDATA[{}]]></Input>
<Output parsed="false">listFilesOutput</Output>

פרמטרים של בקשה

ללא.

תשובה

מערך של שמות קובצי S3.

["hello_world.txt"]

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

ללא.

סימוכין לתצורה

במהלך ההגדרה והפריסה של התוסף הזה לשימוש בשרתי proxy של API, צריך להשתמש בהגדרות הבאות. לשלבים להגדרת תוסף באמצעות מסוף Apigee, אפשר לעיין במאמר הוספה והגדרה של תוסף.

מאפיינים נפוצים של תוספים

המאפיינים הבאים קיימים בכל תוסף.

המאפיינים של חבילת התוספים הזו

מציינים ערכים למאפייני ההגדרה הבאים שספציפיים לתוסף הזה.