إضافة Amazon S3

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

الإصدار: 1.1.1

إدارة الملفات في حزمة Amazon S3 باستخدام هذه الإضافة، يمكنك إدراج الملفات وتنزيلها وحذفها. يمكنك أيضًا إنشاء عنوان URL موقَّع لتنزيل ملف.

يعمل كل مثيل تم إعداده لهذه الإضافة مع حزمة محدّدة. بالنسبة إلى مجموعات البيانات المتعددة، يمكنك استخدام مثيل تم إعداده لهذه الإضافة لكل حزمة.

المتطلبات الأساسية

قبل استخدام الإضافة من خادم وكيل لواجهة برمجة التطبيقات باستخدام سياسة ExtensionCallout، يجب عليك:

• احصل على رقم تعريف مفتاح الوصول ومفتاح الوصول السري لحزمة Amazon S3 التي ستستخدمها.

  ستحتاج إلى هذه الإضافة، بالإضافة إلى اسم حزمة AWS ومنطقة AWS، من أجل configure هذه الإضافة.

لمحة عن 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>

يجب تحديد parsed="false" على العنصر <Output> إذا كنت تريد أن يتضمّن المتغيّر تنسيق JSON الأولي. وإلا، فإن المتغير غير قابل للاستخدام.

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

مَعلمات الطلب

بلا عُري

الإجابة

مصفوفة من أسماء الملفات S3.

["hello_world.txt"]

خصائص الاستجابة

بلا عُري

مرجع التكوين

استخدِم ما يلي عند ضبط هذه الإضافة ونشرها للاستخدام في الخوادم الوكيلة لواجهة برمجة التطبيقات. لمعرفة خطوات إعداد إضافة باستخدام وحدة تحكُّم Apigee، يُرجى الاطّلاع على إضافة إضافة وضبطها.

خصائص الإضافات الشائعة

السمات التالية متاحة لكل إضافة.

الخصائص لحزمة الإضافات هذه

يمكنك تحديد قيم لخصائص الإعداد التالية الخاصة بهذه الإضافة.