תוסף Amazon S3

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

גרסה: 2.0.2

ניהול קבצים בקטגוריה של 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>

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

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

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

ללא.

תשובה

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

["hello_world.txt"]

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

ללא.

הסבר על ההגדרות

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

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

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

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

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