תוסף Amazon S3

אתם קוראים את מאמרי העזרה של Apigee Edge.
כדאי לעיין במסמכי העזרה בנושא Apigee X. מידע

גרסה: 2.0.1

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

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

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

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

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