תוסף Amazon S3

מוצג המסמך של Apigee Edge.
כניסה למסמכי העזרה של Apigee X. info

גרסה: 1.1.0

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

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

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

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

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

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

מידע על 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.

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

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

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

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