برنامه افزودنی آمازون S3

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

نسخه: 1.0.0

فایل ها را در سطل آمازون S3 مدیریت کنید. با این پسوند می توانید فایل ها را فهرست، دانلود و حذف کنید. همچنین می توانید یک URL امضا شده برای دانلود یک فایل ایجاد کنید.

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

پیش نیازها

قبل از استفاده از برنامه افزودنی از یک پروکسی API با استفاده از خط مشی ExtensionCallout ، باید:

• شناسه کلید دسترسی و کلید دسترسی مخفی را برای سطل آمازون S3 که با آن کار خواهید کرد، دریافت کنید.

  برای پیکربندی این افزونه به اینها، همراه با نام سطل AWS و منطقه AWS نیاز دارید.

درباره آمازون S3

سرویس ذخیره سازی ساده آمازون (Amazon S3) یک سرویس ذخیره سازی اشیا است.

اقدامات

حذف فایل

فایل مشخص شده را از یک سطل S3 حذف می کند.

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

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

درخواست پارامترها

پاسخ

هیچ کدام.

ویژگی های پاسخگویی

هیچ کدام.

دانلود فایل

فایل مشخص شده را از یک سطل 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"]

ویژگی های پاسخگویی

هیچ کدام.

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

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

ویژگی های رایج پسوند

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

ویژگی های این بسته افزونه

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