إضافة Amazon S3

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلىمستندات Apigee X. info

الإصدار: 2.0.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، يُرجى الرجوع إلى مقالة إضافة إضافة وضبطها.

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

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

سمات حزمة هذه الإضافة

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