Membuat EventBridge aturan Amazon yang berjalan sesuai jadwal - Amazon EventBridge
Buat aturan yang berjalan sesuai jadwal

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

Membuat EventBridge aturan Amazon yang berjalan sesuai jadwal

Aturan dapat berjalan sebagai respons terhadap suatu peristiwa, atau pada interval waktu tertentu. Sebagai contoh, untuk menjalankan AWS Lambdafungsi secara berkala, Anda dapat membuat aturan untuk berjalan sesuai jadwal.

catatan

EventBridge menawarkan Amazon EventBridge Scheduler, penjadwal tanpa server yang memungkinkan Anda membuat, menjalankan, dan mengelola tugas dari satu layanan terpusat dan terkelola. EventBridge Scheduler sangat dapat disesuaikan, dan menawarkan skalabilitas yang ditingkatkan dibandingkan aturan EventBridge terjadwal, dengan serangkaian operasi dan layanan API target yang lebih luas. AWS

Kami menyarankan Anda menggunakan EventBridge Scheduler untuk memanggil target pada jadwal. Untuk informasi selengkapnya, lihat Menggunakan Amazon EventBridge Scheduler dengan Amazon EventBridge.

Di EventBridge, Anda dapat membuat dua jenis aturan terjadwal:

  • Aturan yang berjalan pada tingkat reguler

    EventBridge menjalankan aturan ini secara berkala; misalnya, setiap 20 menit.

    Untuk menentukan tingkat untuk aturan terjadwal, Anda menentukan ekspresi tingkat.

  • Aturan yang berjalan pada waktu tertentu

    EventBridge menjalankan aturan ini pada waktu dan tanggal tertentu; misalnya, 8:00 a.m. PST pada hari Senin pertama setiap bulan.

    Untuk menentukan waktu dan tanggal aturan terjadwal berjalan, Anda menentukan ekspresi cron.

Ekspresi tingkat lebih sederhana untuk didefinisikan, sementara ekspresi cron menawarkan kontrol jadwal terperinci. Sebagai contoh, dengan ekspresi cron, Anda dapat menentukan aturan yang berjalan pada waktu tertentu pada hari tertentu setiap minggu atau bulan. Sebaliknya, ekspresi tingkat menjalankan aturan pada tingkat reguler, seperti sekali setiap jam atau sekali setiap hari.

Semua acara yang dijadwalkan menggunakan zona waktu UTC+0, dan presisi minimum untuk jadwal adalah satu menit.

catatan

EventBridge tidak memberikan presisi tingkat kedua dalam ekspresi jadwal. Resolusi terbaik yang menggunakan ekspresi cron adalah satu menit. Karena sifat terdistribusi EventBridge dan layanan target, mungkin ada penundaan beberapa detik antara waktu aturan terjadwal dipicu dan waktu layanan target menjalankan sumber daya target.

Video berikut memberikan ikhtisar tugas penjadwalan:

Topik

Buat aturan yang berjalan sesuai jadwal

Langkah-langkah berikut memandu Anda melalui cara membuat EventBridge aturan yang berjalan pada jadwal reguler.

catatan

Anda hanya dapat membuat aturan terjadwal dengan menggunakan bus peristiwa default.

Tentukan aturannya

Pertama, masukkan nama dan deskripsi untuk aturan Anda untuk mengidentifikasinya.

Untuk menentukan detail aturan

  1. Buka EventBridge konsol Amazon di https://console.aws.amazon.com/events/.

  2. Di panel navigasi, pilih Aturan.

  3. Pilih Buat aturan.

  4. Masukkan Nama dan, secara opsional, Deskripsi untuk aturan.

    Aturan tidak boleh memiliki nama yang sama dengan aturan lain di Wilayah AWS yang sama dan di bus peristiwa yang sama.

  5. Untuk bus acara, pilih bus acara default. Anda hanya dapat membuat aturan terjadwal dengan menggunakan bus peristiwa default.

  6. Agar aturan berlaku segera setelah Anda membuatnya, pastikan opsi Aktifkan aturan pada bus acara yang dipilih diaktifkan.

  7. Untuk jenis Aturan, pilih Jadwal.

    Pada titik ini, Anda dapat memilih untuk melanjutkan dengan membuat aturan yang berjalan sesuai jadwal, atau menggunakan Amazon EventBridge Scheduler.

  8. Pilih bagaimana Anda ingin melanjutkan:

    • Gunakan EventBridge Scheduler untuk membuat jadwal Anda

      catatan

      EventBridge Scheduler adalah penjadwal tanpa server yang memungkinkan Anda membuat, menjalankan, dan mengelola tugas dari satu layanan terpusat yang dikelola. Ini menyediakan fungsionalitas penjadwalan satu kali dan berulang yang independen dari bus dan aturan acara. EventBridge Scheduler sangat dapat disesuaikan, dan menawarkan skalabilitas yang ditingkatkan dibandingkan aturan EventBridge terjadwal, dengan serangkaian operasi dan layanan API target yang lebih luas. AWS

      Kami menyarankan Anda menggunakan EventBridge Scheduler untuk memanggil target pada jadwal. Untuk informasi selengkapnya, lihat Apa itu Amazon EventBridge Scheduler? di Panduan Pengguna EventBridge Penjadwal Amazon.

      1. Pilih Lanjutkan di EventBridge Scheduler

        EventBridge membuka konsol EventBridge Scheduler ke halaman Buat jadwal.

      2. Buat jadwal di konsol EventBridge Scheduler.

    • Lanjutkan menggunakan EventBridge untuk membuat aturan terjadwal untuk bus acara default

      1. Pilih Lanjutkan untuk membuat aturan.

Tentukan jadwal

Selanjutnya, tentukan pola jadwal.

Untuk menentukan pola jadwal

  1. Untuk pola Jadwal, pilih apakah Anda ingin jadwal berjalan pada waktu tertentu, atau dengan tarif reguler:

    Specific time

    1. Pilih Jadwal berbutir halus yang berjalan pada waktu tertentu, seperti pukul 8:00 pagi. PST pada hari Senin pertama setiap bulan.

    2. Untuk ekspresi Cron, tentukan bidang untuk menentukan ekspresi cron yang EventBridge harus digunakan untuk menentukan kapan harus menjalankan aturan terjadwal ini.

      Setelah Anda menentukan semua bidang, EventBridge menampilkan sepuluh tanggal berikutnya kapan EventBridge akan mengeksekusi aturan terjadwal ini. Anda dapat memilih apakah akan menampilkan tanggal tersebut di UTC atau zona waktu lokal.

      Untuk informasi lebih lanjut tentang membangun ekspresi cron, lihat. Referensi ekspresi cron

    Regular rate

    1. Pilih jadwal yang berjalan dengan tarif reguler, seperti setiap 10 menit.

    2. Untuk ekspresi Rate, tentukan bidang Nilai dan Unit untuk menentukan tingkat di mana EventBridge harus menjalankan aturan terjadwal ini.

      Untuk informasi lebih lanjut tentang membangun ekspresi laju, lihatReferensi ekspresi nilai.

  2. Pilih Selanjutnya.

Pilih target

Pilih satu atau beberapa target untuk menerima peristiwa yang cocok dengan pola yang ditentukan. Target dapat mencakup bus EventBridge acara, tujuan EventBridge API, termasuk mitra SaaS seperti Salesforce, atau lainnya. Layanan AWS

Untuk memilih target

  1. Untuk jenis Target, pilih salah satu jenis target berikut:

    Event bus

    Untuk memilih bus EventBridge acara, pilih bus EventBridge acara, lalu lakukan hal berikut:

    API destination

    Untuk menggunakan tujuan EventBridge API, pilih tujuan EventBridge API, lalu lakukan salah satu hal berikut:

    • Untuk menggunakan tujuan API yang ada, pilih Gunakan tujuan API yang ada. Kemudian pilih tujuan API dari daftar dropdown.

    • Untuk membuat tujuan API baru, pilih Buat tujuan API baru. Kemudian, berikan rincian berikut untuk tujuan:

      • Nama — Masukkan nama untuk tujuan.

        Nama harus unik di dalam diri AndaAkun AWS. Nama dapat memiliki hingga 64 karakter. Karakter yang valid adalah A-Z, a-z, 0-9, dan. _ - (tanda hubung).

      • (Opsional) Deskripsi — Masukkan deskripsi untuk tujuan.

        Deskripsi dapat memiliki hingga 512 karakter.

      • Titik akhir tujuan API — Titik akhir URL untuk target.

        URL endpoint harus dimulai denganhttps. Anda dapat menyertakan wildcard * sebagai parameter jalur. Anda dapat mengatur parameter jalur dari HttpParameters atribut target.

      • Metode HTTP - Pilih metode HTTP yang digunakan saat Anda memanggil titik akhir.

      • (Opsional) Batas tingkat pemanggilan per detik - Masukkan jumlah maksimum pemanggilan yang diterima untuk setiap detik untuk tujuan ini.

        Nilai ini harus lebih besar dari nol. Secara default, nilai ini diatur ke 300.

      • Koneksi — Pilih untuk menggunakan koneksi baru atau yang sudah ada:

        • Untuk menggunakan koneksi yang ada, pilih Gunakan koneksi yang ada dan pilih koneksi dari daftar tarik-turun.

        • Untuk membuat koneksi baru untuk tujuan ini pilih Buat koneksi baru, lalu tentukan Nama koneksi, tipe Tujuan, dan jenis Otorisasi. Anda juga dapat menambahkan Deskripsi opsional untuk koneksi ini.

    Untuk informasi selengkapnya, lihat Tujuan API.

    Layanan AWS

    Untuk menggunakanLayanan AWS, pilih Layanan AWS, lalu lakukan hal berikut:

    1. Untuk Pilih target, pilih Layanan AWS untuk digunakan sebagai target. Berikan informasi yang diminta untuk layanan yang Anda pilih.

      catatan

      Bidang yang ditampilkan bervariasi tergantung pada layanan yang dipilih. Untuk informasi selengkapnya tentang target yang tersedia, lihatTarget tersedia di EventBridge konsol.

  2. Untuk sebagian besar tipe target, EventBridge membutuhkan izin untuk mengirim kejadian ke target. Dalam kasus ini, EventBridge dapat membuat peran IAM yang diperlukan agar aturan Anda berjalan.

    Untuk peran Eksekusi, lakukan salah satu hal berikut:

    • Untuk membuat peran eksekusi baru untuk aturan ini:

      1. Pilih Buat peran baru untuk sumber daya khusus ini.

      2. Masukkan nama untuk peran eksekusi ini, atau gunakan nama yang dihasilkan oleh EventBridge.

    • Untuk menggunakan peran eksekusi yang ada untuk aturan ini:

      1. Pilih Gunakan peran yang ada.

      2. Masukkan atau pilih nama peran eksekusi yang akan digunakan dari daftar dropdown.

  3. (Opsional) Untuk pengaturan Tambahan, tentukan salah satu pengaturan opsional yang tersedia untuk jenis target Anda:

    Event bus

    (Opsional) Untuk antrian Dead-letter, pilih apakah akan menggunakan antrian Amazon SQS standar sebagai antrian huruf mati. EventBridge mengirimkan peristiwa yang cocok dengan aturan ini ke antrian huruf mati jika tidak berhasil dikirim ke target. Lakukan salah satu dari berikut:

    • Pilih Tidak ada untuk tidak menggunakan antrean surat mati.

    • Pilih Pilihan antrean Amazon SQS di akun AWS saat ini untuk digunakan sebagai antrean surat mati kemudian pilih antrean yang akan digunakan dari daftar menurun.

    • Pilih Pilihan antrean Amazon SQS di akun AWS lainnya sebagai antrean surat mati dan kemudian masukkan ARN antrean untuk menggunakannya. Anda harus melampirkan kebijakan berbasis sumber daya ke antrean yang memberikan izin EventBridge untuk mengirim pesan padanya.

      Untuk informasi selengkapnya, lihat Memberikan izin untuk antrean surat mati.

    API destination

    1. (Opsional) Untuk Konfigurasi input target, pilih bagaimana Anda ingin menyesuaikan teks yang dikirim ke target untuk acara yang cocok. Pilih salah satu dari berikut:

      • Peristiwa yang cocok - EventBridge mengirimkan seluruh acara sumber asli ke target. Ini adalah default.

      • Bagian dari peristiwa yang cocok - EventBridge hanya mengirimkan bagian tertentu dari peristiwa sumber asli ke target.

        Di bawah Tentukan bagian dari peristiwa yang cocok, tentukan jalur JSON yang menentukan bagian acara yang ingin Anda kirim EventBridge ke target.

      • Konstan (teks JSON) - hanya EventBridge mengirimkan teks JSON yang ditentukan ke target. Tidak ada bagian dari acara sumber asli yang dikirim.

        Di bawah Tentukan konstanta di JSON, tentukan teks JSON yang EventBridge ingin Anda kirim ke target alih-alih acara.

      • Transformator input - Konfigurasikan transformator input untuk menyesuaikan teks yang ingin Anda EventBridge kirim ke target. Untuk informasi selengkapnya, lihat Transformasi EventBridge masukan Amazon.

        1. Pilih Konfigurasikan transformator input.

        2. Konfigurasikan transformator input mengikuti langkah-langkah masukMengkonfigurasi transformator input sebagai bagian dari pembuatan aturan.

    2. (Opsional) Di bawah kebijakan Coba lagi, tentukan cara EventBridge mencoba lagi mengirim peristiwa ke target setelah terjadi kesalahan.

      • Usia maksimum acara - Masukkan jumlah waktu maksimum (dalam jam, menit, dan detik) EventBridge untuk mempertahankan acara yang belum diproses. Defaultnya adalah 24 jam.

      • Coba lagi — Masukkan jumlah maksimum kali EventBridge harus mencoba mengirim peristiwa ke target setelah terjadi kesalahan. Defaultnya adalah 185 kali.

    3. (Opsional) Untuk antrian Dead-letter, pilih apakah akan menggunakan antrian Amazon SQS standar sebagai antrian huruf mati. EventBridge mengirimkan peristiwa yang cocok dengan aturan ini ke antrian huruf mati jika tidak berhasil dikirim ke target. Lakukan salah satu dari berikut:

      • Pilih Tidak ada untuk tidak menggunakan antrean surat mati.

      • Pilih Pilihan antrean Amazon SQS di akun AWS saat ini untuk digunakan sebagai antrean surat mati kemudian pilih antrean yang akan digunakan dari daftar menurun.

      • Pilih Pilihan antrean Amazon SQS di akun AWS lainnya sebagai antrean surat mati dan kemudian masukkan ARN antrean untuk menggunakannya. Anda harus melampirkan kebijakan berbasis sumber daya ke antrian yang memberikan EventBridge izin untuk mengirim pesan ke sana.

        Untuk informasi selengkapnya, lihat Memberikan izin untuk antrean surat mati.

    AWS service

    Perhatikan bahwa EventBridge mungkin tidak menampilkan semua bidang berikut untuk AWS layanan tertentu.

    1. (Opsional) Untuk Konfigurasi input target, pilih bagaimana Anda ingin menyesuaikan teks yang dikirim ke target untuk acara yang cocok. Pilih salah satu dari berikut:

      • Peristiwa yang cocok - EventBridge mengirimkan seluruh acara sumber asli ke target. Ini adalah default.

      • Bagian dari peristiwa yang cocok - EventBridge hanya mengirimkan bagian tertentu dari peristiwa sumber asli ke target.

        Di bawah Tentukan bagian dari peristiwa yang cocok, tentukan jalur JSON yang menentukan bagian acara yang ingin Anda kirim EventBridge ke target.

      • Konstan (teks JSON) - hanya EventBridge mengirimkan teks JSON yang ditentukan ke target. Tidak ada bagian dari acara sumber asli yang dikirim.

        Di bawah Tentukan konstanta di JSON, tentukan teks JSON yang EventBridge ingin Anda kirim ke target alih-alih acara.

      • Transformator input - Konfigurasikan transformator input untuk menyesuaikan teks yang ingin Anda EventBridge kirim ke target. Untuk informasi selengkapnya, lihat Transformasi EventBridge masukan Amazon.

        1. Pilih Konfigurasikan transformator input.

        2. Konfigurasikan transformator input mengikuti langkah-langkah masukMengkonfigurasi transformator input sebagai bagian dari pembuatan aturan.

    2. (Opsional) Di bawah kebijakan Coba lagi, tentukan cara EventBridge mencoba lagi mengirim peristiwa ke target setelah terjadi kesalahan.

      • Usia maksimum acara - Masukkan jumlah waktu maksimum (dalam jam, menit, dan detik) EventBridge untuk mempertahankan acara yang belum diproses. Defaultnya adalah 24 jam.

      • Coba lagi — Masukkan jumlah maksimum kali EventBridge harus mencoba mengirim peristiwa ke target setelah terjadi kesalahan. Defaultnya adalah 185 kali.

    3. (Opsional) Untuk antrian Dead-letter, pilih apakah akan menggunakan antrian Amazon SQS standar sebagai antrian huruf mati. EventBridge mengirimkan peristiwa yang cocok dengan aturan ini ke antrian huruf mati jika tidak berhasil dikirim ke target. Lakukan salah satu dari berikut:

      • Pilih Tidak ada untuk tidak menggunakan antrean surat mati.

      • Pilih Pilihan antrean Amazon SQS di akun AWS saat ini untuk digunakan sebagai antrean surat mati kemudian pilih antrean yang akan digunakan dari daftar menurun.

      • Pilih Pilihan antrean Amazon SQS di akun AWS lainnya sebagai antrean surat mati dan kemudian masukkan ARN antrean untuk menggunakannya. Anda harus melampirkan kebijakan berbasis sumber daya ke antrian yang memberikan EventBridge izin untuk mengirim pesan ke sana.

        Untuk informasi selengkapnya, lihat Memberikan izin untuk antrean surat mati.

  4. (Opsional) Pilih Tambahkan target lain untuk menambahkan target lain untuk aturan ini.

  5. Pilih Selanjutnya.

Konfigurasikan tag dan aturan ulasan

Terakhir, masukkan tag yang diinginkan untuk aturan tersebut, lalu tinjau dan buat aturannya.

Untuk mengkonfigurasi tag, dan meninjau dan membuat aturan

  1. (Opsional) Masukkan satu atau lebih tanda untuk aturan. Untuk informasi selengkapnya, lihat EventBridge Tag Amazon.

  2. Pilih Next (Berikutnya).

  3. Tinjau detail untuk aturan baru. Untuk membuat perubahan pada bagian mana pun, pilih tombol Edit di sebelah bagian itu.

    Saat puas dengan detail aturan, pilih Buat aturan.