شما در حال مشاهده اسناد Apigee Edge هستید.
به مستندات Apigee X بروید . اطلاعات
نسخه: 1.1.1
فایل ها را در سطل آمازون 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>
درخواست پارامترها
پارامتر | توضیحات | تایپ کنید | پیش فرض | مورد نیاز |
---|---|---|---|---|
نام فایل | نام فایل برای دانلود. | رشته | هیچ کدام. | بله. |
منقضی می شود | مدت زمان بر حسب ثانیه تا زمانی که URL منقضی شود. | عدد صحیح | 86400 | خیر |
پاسخ
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، به افزودن و پیکربندی یک برنامه افزودنی مراجعه کنید.
ویژگی های رایج پسوند
ویژگی های زیر برای هر افزونه وجود دارد.
ویژگی | شرح | پیش فرض | ضروری |
---|---|---|---|
name | نامی که به این پیکربندی افزونه میدهید. | هیچ یک | آره |
packageName | نام بسته افزودنی همانطور که توسط Apigee Edge داده شده است. | هیچ یک | آره |
version | شماره نسخه بسته برنامه افزودنی که از آن یک برنامه افزودنی را پیکربندی می کنید. | هیچ یک | آره |
configuration | مقدار پیکربندی مخصوص افزونه ای که اضافه می کنید. به ویژگی های این بسته برنامه افزودنی مراجعه کنید | هیچ یک | آره |
ویژگی های این بسته افزونه
مقادیری را برای خصوصیات پیکربندی زیر مخصوص این افزونه مشخص کنید.
اموال | توضیحات | پیش فرض | مورد نیاز |
---|---|---|---|
پیکربندی | نام سطل آمازون S3 را برای استفاده وارد کنید، مانند sample-bucket . | هیچ کدام. | بله. |
پیکربندی | نام منطقه AWS مورد استفاده را وارد کنید، مانند us-east-2 . | هیچ کدام. | بله. |
اعتبارنامه | هنگامی که در کنسول Apigee Edge وارد میشوید، این یک فایل JSON است که شامل شناسه کلید دسترسی آمازون و کلید دسترسی شما به شکل زیر است:{ "accessKeyId" : access-key-ID, "secretAccessKey" : secret-access-key } هنگامی که از طریق API مدیریت ارسال می شود، یک مقدار کدگذاری شده با base64 است که از آن فایل کلید JSON تولید می شود. | هیچ کدام. | بله. |