AWS S3

  # AWS S3 için Entegrasyon Botpress

Doğrudan Botpress sohbet botunuzdan AWS S3 'un gücünden yararlanın. Bu entegrasyon, S3 kovalarını ve nesnelerini yönetmenize, kova oluşturma ve silme, dosya yükleme ve alma gibi işlemleri gerçekleştirmenize ve daha fazlasını yapmanıza olanak tanır.

## İçindekiler
- Giriş](#introduction)
- [AWS S3 Kurulum ve Yapılandırma](#aws-s3-setup--configuration)
  - Önkoşullar](#prerequisites)
  - Entegrasyonu Etkinleştir](#enable-integration)
- [Eylemler](#eylemler)
  - [Kova Oluştur](#create-bucket)
  - Kovayı Sil](#delete-bucket)
  - Nesne Kopyala](#copy-object)
  - [Kova İlkesini Sil](#delete-bucket-policy)
  - [Kova Web Sitesini Sil](#delete-bucket-website)
  - Nesne Sil](#nesne-sil)
  - Birden Fazla Nesneyi Sil](#delete-multiple-objects)
  - Nesne Al](#get-object)
  - Nesneleri Listele V2](#list-objects-v2)
  - Nesne Yükle](#upload-object)
  - [Kovaları Listele](#list-buckets)
- [Kullanım Örnekleri](#use-cases)
- Desteklenen Etkinlikler](#supported-events)

## Giriş
 Botpress için AWS S3 entegrasyonu, bulut depolamayı yönetmek için sohbet botunuzu güçlendirir. S3 kovaları oluşturun, listeleyin ve silin ve dosyaları doğrudan sohbet botunuz aracılığıyla işleyin. Bu entegrasyon, bulut iş akışlarını otomatikleştirmek için idealdir.

## AWS S3 Kurulum ve Yapılandırma
### Önkoşullar
 Botpress AWS S3  Entegrasyonunu etkinleştirmeden önce, lütfen aşağıdakilere sahip olduğunuzdan emin olun:

- Yerel olarak veya bulutta kurulmuş bir Botpress sunucu örneği.
- S3 hizmetlerine erişim izinlerine sahip AWS kimlik bilgileri.

### Entegrasyonu Etkinleştir
 AWS S3 entegrasyonunu Botpress adresinde etkinleştirmek için aşağıdaki adımları izleyin:

1. Botpress  yönetici panelinize erişin.
2. "Entegrasyonlar" bölümüne gidin.
3. AWS S3  entegrasyonunu bulun ve "Etkinleştir" veya "Yapılandır "a tıklayın.
4. Gerekli `accessKeyId`, `secretAccessKey` ve `region` değerlerini girin.
5. Yapılandırmayı kaydedin.

## Eylemler
İşte AWS S3 entegrasyonu tarafından desteklenen eylemler:

### Kova Oluştur
Yeni bir S3 kovası oluşturun.

### Kovayı Sil
Mevcut bir S3 kovasını silin.

### Nesneyi Kopyala
Bir nesneyi bir S3 kovasından diğerine kopyalayın.

### Kova Politikasını Sil
Bir S3 kovası ile ilişkili ilkeyi silin.

### Kova Web Sitesini Sil
Bir S3 kovasının web sitesi yapılandırmasını silin.

### Nesneyi Sil
Bir S3 kovasından belirli bir nesneyi silin.

### Birden Fazla Nesneyi Silme
Bir S3 kovasından birden fazla nesneyi toplu olarak silin.

### Nesne Al
Bir S3 kovasından belirli bir nesneyi alın.

### Liste Nesneleri V2
Bir S3 kovasındaki nesneleri listeleyin (liste işleminin 2. sürümü).

### Nesne Yükle
Bir S3 kovasına dosya/nesne yükleyin. *Not: Şu anda bu özellik geliştirme aşamasındadır. Kullanıcının AWS S3 adresine bir dosya göndermek için curl komutuyla kullanabileceği önceden imzalanmış bir URL döndürebiliriz. Botpress adresinin dosya yüklemelerine izin vermesini bekliyoruz ve uygulandığında bu özellik tamamen kullanılabilir olacaktır.*

### Liste Kovaları
Kullanılabilir tüm S3 kovalarını listeleyin.

## Kullanım Örnekleri
İşte AWS S3 entegrasyonu için bazı yaygın kullanım durumları:

1. Veri Alma
   - Kullanıcıların bir S3 kovasında depolanan belirli dosyaları almasına izin verin.
   - Kullanıcı girişine göre dosyaları almak için Nesne Al eylemini kullanın.
   - Kullanıcıların aralarından seçim yapabileceği kullanılabilir dosyaları görüntülemek için Nesneleri Listele V2 eylemini kullanın.

2. Kova Yönetimi
   - Kullanıcıların chatbot arayüzü üzerinden kova oluşturmasını ve silmesini sağlayın.
   - Yeni depolama konumları oluşturmak için Kova Oluştur eylemini kullanın.
   - Kullanılmayan veya boş kovaları kaldırmak için Kova Sil eylemini kullanın.
   - Yönetim için mevcut tüm kovaları görüntülemek için Kovaları Listele eylemini kullanın.

3. Nesne Silme
   - Bir S3 kovasından belirli veya birden çok nesneyi yönetin ve silin.
   - Kullanıcı girdisine dayalı olarak dosyaları tek tek silmek için Nesneyi Sil eylemini kullanın.
   - Temizleme işlemleri için toplu silme gerçekleştirmek üzere Birden Çok Nesneyi Sil eylemini kullanın.

4. Veri Geçişi
   - Veri taşıma amacıyla nesneleri bir kovadan diğerine kopyalayın.
   - Dosyaları bir kaynak kovadan bir hedef kovaya kopyalamak için Nesne Kopyala eylemini kullanın.
   - Geçişi doğrulamak için Kovaları Listele ve Nesneleri Listele V2 eylemlerini kullanın.

5. Temizleme Operasyonları
   - Belirli nesneleri veya tüm kovaları düzenli olarak temizleyin.
   - Silinecek nesneleri belirlemek için Nesneleri Listele V2 eylemini kullanın.
   - İstenmeyen dosyaları kaldırmak için Nesneyi Sil veya Birden Fazla Nesneyi Sil eylemlerini kullanın.
   - Boş kovaları kaldırmak için Kovayı Sil eylemini kullanın.

## Desteklenen Etkinlikler
Bu entegrasyon şu anda AWS S3 etkinliklerine dayalı olarak tetiklenen olayları içermemektedir. Ancak entegrasyonu, AWS SNS (Basit Bildirim Hizmeti) veya Botpress adresindeki iş akışlarını tetikleyen diğer AWS hizmetleri aracılığıyla belirli S3 olay bildirimlerini dinleyecek şekilde özelleştirebilirsiniz.