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

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

نسخه: ۲.۰.۲

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

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

پیش‌نیازها

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

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

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

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

سرویس ذخیره‌سازی ساده آمازون (Amazon Simple Storage Service) یا به اختصار 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"
}

خواص پاسخ

لیست فایل‌ها

اجرای یک تابع AWS Lambda را فراخوانی می‌کند.

<Action>listFiles</Action>
<Input><![CDATA[{}]]></Input>
<Output>flow-variable</Output>

اگر می‌خواهید متغیر شامل JSON خام باشد، باید در عنصر <Output> parsed="false" استفاده کنید. در غیر این صورت، متغیر قابل استفاده نخواهد بود.

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

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

هیچ کدام.

پاسخ

آرایه‌ای از نام فایل‌های S3.

["hello_world.txt"]

خواص پاسخ

هیچ کدام.

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

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

ویژگی‌های افزونه‌های رایج

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

ویژگی‌های این بسته الحاقی

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