إضافة Amazon S3

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

الإصدار: 1.1.1

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

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

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

قبل استخدام الإضافة من خادم وكيل لواجهة برمجة التطبيقات باستخدام سياسة 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

يتم إنشاء عنوان 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، يُرجى الاطّلاع على إضافة إضافة وضبطها.

سمات الإضافات الشائعة

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

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

حدِّد قيمًا لخصائص الضبط التالية الخاصة بهذه الإضافة.