AWS S3

  # AWS S3 التكامل لـ Botpress

استفد من قوة AWS S3 مباشرةً من Botpress chatbot . يتيح لك هذا التكامل إدارة دلاء وكائنات S3، وإجراء عمليات مثل إنشاء الدلاء وحذفها، وتحميل الملفات واسترجاعها، وغير ذلك.

## جدول المحتويات
- [مقدمة](#مقدمة)
- [AWS S3 الإعداد والتهيئة](# الإعداد والتكوين)(#aws-s3-s3-setup--التكوين)
  - [المتطلبات الأساسية](#المتطلبات الأساسية)
  - [تمكين التكامل](# تمكين التكامل)
- [الإجراءات](#إجراءات)
  - [إنشاء دلو](#إنشاء دلو)
  - [حذف دلو](#حذف دلو)
  - [نسخ كائن](#نسخ-كائن)
  - [حذف سياسة الدلو](#حذف-سياسة-الدلو)
  - [حذف موقع الويب الخاص بالدلو](#حذف-حذف-موقع-الدلو-موقع الويب)
  - [حذف كائن](#حذف-كائن-حذف-حذف-كائن)
  - [حذف كائنات متعددة](#حذف-كائنات-متعددة-حذف-كائنات)
  - [الحصول على كائن](#الحصول على-كائن)
  - [سرد الكائنات V2](#قائمة-الكائنات-v2)
  - [تحميل كائن](#تحميل-كائن)
  - [دلاء القائمة](#قائمة-دلاء القائمة)
- [حالات الاستخدام](#حالات الاستخدام)
- [أحداث مدعومة](#أحداث مدعومة)

## مقدمة
يعمل تكامل AWS S3 لـ Botpress على تمكين chatbot الخاص بك من إدارة التخزين السحابي. يمكنك إنشاء دلاء S3 وإدراجها وحذفها، والتعامل مع الملفات مباشرةً من خلال chatbot. هذا التكامل مثالي لأتمتة مهام سير العمل السحابية.

## AWS S3 الإعداد والتكوين
### المتطلبات الأساسية
قبل تمكين التكامل Botpress AWS S3  ، يُرجى التأكد من أن لديك ما يلي:

- إعداد مثيل خادم Botpress إما محليًا أو في السحابة.
- بيانات اعتماد AWS مع أذونات للوصول إلى خدمات S3.

### تمكين التكامل
لتمكين التكامل AWS S3 في Botpress ، اتبع الخطوات التالية:

1. قم بالوصول إلى لوحة الإدارة Botpress .
2. انتقل إلى قسم "التكاملات".
3. حدد موقع التكامل AWS S3 وانقر على "تمكين" أو "تكوين".
4. أدخل "مفتاح الوصول" و"مفتاح الوصول السري" و"المنطقة" المطلوبة.
5. احفظ التكوين.

#الإجراءات
فيما يلي الإجراءات التي يدعمها التكامل AWS S3 :

### إنشاء دلو
إنشاء دلو S3 جديد.

### حذف دلو
حذف دلو S3 موجود.

### نسخ كائن
نسخ كائن من دلو S3 إلى دلو S3 آخر.

### حذف نهج الدلو
حذف النهج المقترن بدلو S3.

### حذف موقع الويب الخاص بالدلو
حذف تكوين موقع الويب الخاص بدلو S3.

### حذف كائن
حذف كائن معين من دلو S3.

### حذف كائنات متعددة
حذف جماعي لكائنات متعددة من دلو S3.

### الحصول على كائن
استرداد كائن معين من دلو S3.

### سرد الكائنات V2
سرد الكائنات في دلو S3 (الإصدار 2 من عملية القائمة).

### تحميل كائن
تحميل ملف/كائن إلى دلو S3. *ملاحظة: هذه الميزة قيد التطوير حاليًا. يمكننا إرجاع عنوان URL موقّع مسبقًا يمكن للمستخدم استخدامه مع أمر curl لإرسال ملف إلى AWS S3. نحن في انتظار Botpress للسماح بتحميل الملفات، وبمجرد تنفيذ هذه الميزة ستكون هذه الميزة قابلة للاستخدام بالكامل.*

### قائمة الدلاء
سرد جميع دلاء S3 المتاحة.

## حالات الاستخدام
فيما يلي بعض حالات الاستخدام الشائعة لتكامل AWS S3 :

1. استرجاع البيانات
   - السماح للمستخدمين باسترداد ملفات محددة مخزنة في دلو S3.
   - استخدم إجراء الحصول على كائن لاسترداد الملفات بناءً على مدخلات المستخدم.
   - استخدم إجراء سرد الكائنات V2 لعرض الملفات المتاحة للمستخدمين للاختيار من بينها.

2. إدارة الدلو
   - تمكين المستخدمين من إنشاء دلاء وحذفها من خلال واجهة chatbot .
   - استخدم الإجراء إنشاء دلو لإنشاء مواقع تخزين جديدة.
   - استخدم الإجراء حذف دلو لإزالة الدلاء غير المستخدمة أو الفارغة.
   - استخدم إجراء سرد الدلاء لعرض جميع الدلاء المتاحة للإدارة.

3. حذف الكائنات
   - إدارة وحذف كائنات محددة أو متعددة من دلو S3.
   - استخدم إجراء حذف كائن لحذف ملفات فردية بناءً على إدخال المستخدم.
   - استخدم إجراء حذف كائنات متعددة لتنفيذ عمليات حذف مجمعة لعمليات التنظيف.

4. ترحيل البيانات
   - انسخ الكائنات من دلو إلى آخر لأغراض ترحيل البيانات.
   - استخدم الإجراء نسخ كائن لنسخ الملفات من دلو مصدر إلى دلو وجهة.
   - استخدم الإجراءين قائمة الجداول وقائمة الكائنات V2 للتحقق من الترحيل.

5. عمليات التنظيف
   - نظف بانتظام كائنات محددة أو دلاء كاملة.
   - استخدم إجراء سرد الكائنات V2 لتحديد الكائنات للحذف.
   - استخدم الإجراء حذف كائن أو حذف كائنات متعددة لإزالة الملفات غير المرغوب فيها.
   - استخدم إجراء حذف الدلو لإزالة الدلاء الفارغة.

## الأحداث المدعومة
لا يتضمن هذا التكامل حاليًا الأحداث التي يتم تشغيلها استنادًا إلى أنشطة AWS S3 . ومع ذلك، يمكنك تخصيص التكامل للاستماع إلى إشعارات أحداث S3 المحددة عبر AWS SNS (خدمة الإشعارات البسيطة) أو خدمات AWS الأخرى التي تقوم بتشغيل مهام سير العمل في Botpress.