افزونه Amazon S3

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید. اطلاعات

نسخه: 1.1.1

فایل‌ها را در مخزن Amazon S3 مدیریت کنید. با این افزونه می‌توانید فایل‌ها را فهرست کنید، بارگیری کنید، و حذف کنید. همچنین می‌توانید نشانی وب امضاشده‌ای برای بارگیری فایل تولید کنید.

هر نمونه پیکربندی‌شده از این افزونه با یک مخزن خاص کار می‌کند. برای چند مخزن، برای هر مخزن از نمونه پیکربندی‌شده این افزونه استفاده کنید.

پیش‌نیازها

قبل‌از استفاده از افزونه از یک پراکسی 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

نشانی وب امضاشده‌ای برای بارگیری فایل مشخص‌شده از باکت 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":"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"]

خصوصیت‌های پاسخ

هیچ‌کدام.

مرجع پیکربندی

هنگام پیکربندی و استقرار این افزونه برای استفاده در پراکسی‌های API، از موارد زیر استفاده کنید. برای مراحل پیکربندی افزونه بااستفاده از کنسول Apigee، به افزودن و پیکربندی افزونه مراجعه کنید.

دارایی‌های افزونه مشترک

ویژگی های زیر برای هر افزونه وجود دارد.

دارایی‌های این بسته افزونه

مقادیر مشخصه‌های پیکربندی زیر را که مختص این افزونه است مشخص کنید.