Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Memulai alur kerja Step Functions dalam menanggapi peristiwa
<a name="tutorial-cloudwatch-events-s3"></a>

Anda dapat menjalankan mesin AWS Step Functions status sebagai respons terhadap peristiwa yang dirutekan oleh EventBridge aturan Amazon ke Step Functions sebagai target. 

Tutorial berikut menunjukkan cara mengkonfigurasi mesin status sebagai target EventBridge aturan Amazon. Setiap kali file ditambahkan ke bucket Amazon Simple Storage Service (Amazon S3), EventBridge aturan akan memulai mesin status.

Contoh praktis dari pendekatan ini adalah mesin status yang menjalankan analisis Amazon Rekognition pada file gambar yang ditambahkan ke bucket untuk mengkategorikan dan menetapkan kata kunci.

Dalam tutorial ini, Anda memulai eksekusi mesin `Helloworld` status dengan mengunggah file ke bucket Amazon S3. Kemudian Anda meninjau contoh input eksekusi tersebut untuk mengidentifikasi informasi yang disertakan dalam input dari notifikasi peristiwa Amazon S3 yang dikirimkan ke. EventBridge

## Prasyarat: Buat Mesin Status
<a name="tutorial-cloudwatch-events-s3-prereqs"></a>

Sebelum Anda dapat mengonfigurasi mesin status sebagai EventBridge target Amazon, Anda harus membuat mesin status.
+ Untuk membuat mesin state dasar, gunakan mesin [Creating state yang menggunakan tutorial fungsi Lambda](tutorial-creating-lambda-state-machine.md).
+ Jika Anda sudah memiliki mesin `Helloworld` negara, lanjutkan ke langkah berikutnya.

## Langkah 1: Buat Bucket di Amazon S3
<a name="tutorial-cloudwatch-events-s3-bucket"></a>

Sekarang setelah Anda memiliki mesin `Helloworld` negara, Anda perlu membuat bucket Amazon S3 yang menyimpan file Anda. Pada Langkah 3 tutorial ini, Anda menyiapkan aturan sehingga ketika file diunggah ke bucket ini, EventBridge memicu eksekusi mesin status Anda.

1. Arahkan ke [konsol Amazon S3](https://console.aws.amazon.com/s3/), lalu pilih **Buat bucket** untuk membuat bucket tempat Anda ingin menyimpan file dan memicu aturan acara Amazon S3.

1. Masukkan **Nama bucket**, seperti `{{username}}-sfn-tutorial`.
**catatan**  
Nama bucket harus unik di semua nama bucket yang ada di semua AWS Wilayah di Amazon S3. Gunakan nama Anda sendiri {{username}} untuk membuat nama ini unik. Anda perlu membuat semua sumber daya di AWS Wilayah yang sama.

1. Simpan semua pilihan default di halaman, dan pilih **Buat ember**.

## Langkah 2: Aktifkan Pemberitahuan Acara Amazon S3 dengan EventBridge
<a name="tutorial-cloudwatch-events-s3-eb-notification"></a>

Setelah Anda membuat bucket Amazon S3, konfigurasikan bucket tersebut untuk mengirim peristiwa ke EventBridge setiap kali peristiwa tertentu terjadi di bucket S3 Anda, seperti unggahan file.

1. Arahkan ke [konsol Amazon S3](https://console.aws.amazon.com/s3/).

1. Di **Bucket** pilih nama bucket yang ingin Anda aktifkan untuk peristiwa.

1. Pilih **Properti**.

1. Gulir ke bawah halaman untuk melihat bagian **Pemberitahuan Acara**, lalu pilih **Edit** di EventBridge subbagian **Amazon**.

1. Di bawah **Kirim notifikasi ke Amazon EventBridge untuk semua acara di bucket ini**, pilih **Aktif**.

1. Pilih **Simpan perubahan**.
**catatan**  
Setelah Anda mengaktifkan EventBridge, dibutuhkan sekitar lima menit agar perubahan diterapkan.

## Langkah 3: Buat EventBridge Aturan Amazon
<a name="tutorial-cloudwatch-events-s3-cwe"></a>

Setelah Anda memiliki mesin status, dan telah membuat bucket Amazon S3 dan mengonfigurasinya untuk mengirim pemberitahuan acara EventBridge, buat aturan. EventBridge 

**catatan**  
Anda harus mengonfigurasi EventBridge aturan di AWS Wilayah yang sama dengan bucket Amazon S3.

### Untuk membuat aturan
<a name="tutorial-cloudwatch-events-s3-create-rule"></a>

1. Arahkan ke [ EventBridge konsol Amazon](https://console.aws.amazon.com/events/), pilih **Buat aturan**.
**Tip**  
Atau, di panel navigasi di EventBridge konsol, pilih **Aturan** di bawah **Bus**, lalu pilih **Buat aturan**.

1. Masukkan **Nama** untuk aturan Anda (misalnya,`{{S3Step Functions}}`) dan secara opsional masukkan **Deskripsi** untuk aturan tersebut.

1. Untuk **bus Acara** dan **tipe Aturan**, pertahankan pilihan default.

1. Pilih **Berikutnya**. Ini membuka halaman **pola acara Build**.

1. Gulir ke bawah ke bagian **Pola acara**, dan lakukan hal berikut:

   1. Untuk **sumber Acara**, pertahankan pilihan default **AWS acara atau acara EventBridge mitra**.

   1. Untuk **AWS layanan**, pilih **Simple Storage Service (S3).**

   1. Untuk **jenis Acara**, pilih **Pemberitahuan Acara Amazon S3**.

   1. Pilih **peristiwa tertentu**, lalu pilih **Object Created**.

   1. Pilih **Bucket spesifik berdasarkan nama** dan masukkan nama bucket yang Anda buat di [Langkah 1](#tutorial-cloudwatch-events-s3-bucket) (`{{username}}-sfn-tutorial`) untuk menyimpan file Anda.

   1. Pilih **Berikutnya**. Ini membuka halaman **Select target (s)**.

### Untuk membuat target
<a name="tutorial-cloudwatch-events-s3-create-rule2"></a>

1. Di **Target 1**, pertahankan pilihan **AWS layanan** default.

1. Dalam daftar tarik-turun **Pilih target**, pilih mesin **status Step Functions**.

1. Dalam daftar **mesin Negara**, pilih mesin status yang Anda [buat sebelumnya](#tutorial-cloudwatch-events-s3-prereqs) (misalnya,`Helloworld`).

1. Simpan semua pilihan default di halaman, dan pilih **Berikutnya**. Ini membuka halaman **Konfigurasi tag**.

1. Pilih **Selanjutnya** sekali lagi. Ini membuka halaman **Review dan create**.

1. Tinjau detail aturan dan pilih **Buat aturan**.

   Aturan dibuat dan halaman **Aturan** ditampilkan, mencantumkan semua EventBridge aturan Amazon Anda.

## Langkah 4: Uji Aturan
<a name="tutorial-cloudwatch-events-test-rule"></a>

Sekarang semua sudah berada di tempatnya, uji penambahan file ke bucket Amazon S3, lalu lihat input eksekusi mesin status yang dihasilkan.

1. Tambahkan file ke bucket Amazon S3.

   **Arahkan ke [konsol Amazon S3](https://console.aws.amazon.com/s3/), pilih bucket yang Anda buat untuk menyimpan file (`{{username}}-sfn-tutorial`), lalu pilih Unggah.**

1. Tambahkan file, misalnya`{{test.png}}`, lalu pilih **Unggah**.

   Tindakan ini meluncurkan eksekusi mesin status Anda, meneruskan informasi dari AWS CloudTrail sebagai input.

1. Periksa eksekusi untuk mesin status Anda.

   Arahkan ke [konsol Step Functions dan pilih mesin status yang digunakan dalam EventBridge aturan Amazon Anda (`Helloworld`)](https://console.aws.amazon.com/states/).

1. Pilih eksekusi terbaru dari mesin status itu dan perluas bagian **Input Eksekusi**.

   Input ini mencakup informasi seperti nama bucket dan nama objek. Dalam kasus penggunaan dunia nyata, mesin status dapat menggunakan input ini untuk melakukan tindakan pada objek tersebut.

## Contoh Input Eksekusi
<a name="tutorial-cloudwatch-events-example"></a>

Contoh berikut menunjukkan masukan khas untuk eksekusi mesin negara.

```
{
    "version": "0",
    "id": "6c540ad4-0671-9974-6511-756fbd7771c3",
    "detail-type": "Object Created",
    "source": "aws.s3",
    "account": "123456789012",
    "time": "2023-06-23T23:45:48Z",
    "region": "us-east-2",
    "resources": [
      "arn:aws:s3:::{{username}}-sfn-tutorial"
    ],
    "detail": {
      "version": "0",
      "bucket": {
        "name": "{{username}}-sfn-tutorial"
      },
      "object": {
        "key": "test.png",
        "size": 800704,
        "etag": "f31d8546bb67845b4d3048cde533b937",
        "sequencer": "00621049BA9A8C712B"
      },
      "request-id": "79104EXAMPLEB723",
      "requester": "123456789012",
      "source-ip-address": "200.0.100.11",
      "reason": "PutObject"
    }
  }
```