Prasyarat Menggunakan konsol Menggunakan AWS CLI Menggunakan SDKs Apa selanjutnya?

Memulai dengan EventBridge Scheduler

Topik ini menjelaskan pembuatan EventBridge jadwal Scheduler baru. Anda menggunakan konsol EventBridge Scheduler, AWS Command Line Interface (AWS CLI), atau AWS SDK untuk membuat jadwal dengan target Amazon SQS template. Kemudian, Anda akan mengatur logging, mengonfigurasi percobaan ulang, dan menetapkan waktu retensi maksimum untuk tugas yang gagal. Setelah membuat jadwal, Anda akan memverifikasi bahwa jadwal Anda berhasil memanggil target dan mengirim pesan ke antrean target.

catatan

Untuk mengikuti panduan ini, kami sarankan Anda mengatur pengguna IAM dengan izin minimum yang diperlukan yang dijelaskan dalam. Menggunakan kebijakan berbasis identitas Setelah Anda membuat dan mengkonfigurasi pengguna, jalankan perintah berikut untuk mengatur kredensi akses Anda. Anda akan memerlukan ID kunci akses dan kunci akses rahasia untuk mengonfigurasi fileAWS CLI.


$ aws configure
AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Default region name [None]: us-west-2
Default output format [None]: json

Untuk informasi selengkapnya tentang berbagai cara mengatur kredensialnya, lihat Pengaturan dan prioritas konfigurasi di Panduan AWS Command Line Interface Pengguna untuk Versi 2.

Topik

Prasyarat
Buat jadwal menggunakan konsol EventBridge Scheduler
Buat jadwal menggunakan AWS CLI
Buat jadwal menggunakan SDK EventBridge Scheduler
Apa selanjutnya?

Prasyarat

Sebelum mencoba langkah-langkah di bagian ini, Anda harus melakukan hal berikut:

Selesaikan tugas yang dijelaskan di Menyiapkan Amazon EventBridge Scheduler

Buat jadwal menggunakan konsol EventBridge Scheduler

Untuk membuat jadwal baru menggunakan konsol

Masuk keAWS Management Console, lalu pilih tautan berikut untuk membuka bagian EventBridge Scheduler di EventBridge konsol: https://us-west-2.console.aws.amazon.com/scheduler/home?region=us-west-2#home

catatan
Anda dapat beralih Wilayah AWS dengan menggunakan pemilih Wilayah. AWS Management Console
Pada halaman Jadwal, pilih Buat jadwal.
Pada halaman Tentukan detail jadwal, di bagian Nama jadwal dan deskripsi, lakukan hal berikut:
1. Untuk nama Jadwal, masukkan nama untuk jadwal Anda. Misalnya, MyTestSchedule
2. Untuk Deskripsi - opsional, masukkan deskripsi untuk jadwal Anda. Sebagai contoh, My first schedule.
3. Untuk grup Jadwal, pilih grup jadwal dari opsi drop-down. Jika sebelumnya Anda belum membuat grup jadwal, Anda dapat memilih default grup untuk jadwal Anda. Untuk membuat grup jadwal baru, pilih tautan buat jadwal Anda sendiri di deskripsi konsol. Anda menggunakan grup jadwal untuk menambahkan tag ke grup jadwal.
Di bagian Pola Jadwal, lakukan hal berikut:
1. Untuk Kejadian, pilih salah satu opsi pola berikut. Opsi konfigurasi berubah tergantung pada pola mana yang Anda pilih.
  - Jadwal satu kali — Jadwal satu kali memanggil target hanya sekali pada tanggal dan waktu yang Anda tentukan.
    
    Untuk Tanggal dan waktu, masukkan tanggal yang valid dalam YYYY/MM/DD format. Kemudian, tentukan stempel waktu dalam format 24 jamhh:mm. Terakhir, pilih zona waktu dari opsi drop-down.
  - Jadwal berulang — Jadwal berulang memanggil target pada tingkat yang Anda tentukan menggunakan cron ekspresi atau ekspresi tingkat.
    
    Pilih jadwal berbasis Cron untuk mengonfigurasi jadwal dengan menggunakan cron ekspresi. o gunakan ekspresi laju, pilih Jadwal berbasis tarif dan masukkan angka positif untuk Nilai, lalu pilih Unit dari opsi tarik-turun.
  Untuk informasi selengkapnya tentang penggunaan ekspresi cron dan rate, lihatJenis jadwal pada EventBridge Scheduler.
2. Untuk jendela waktu Fleksibel, pilih Nonaktif untuk mematikan opsi, atau pilih salah satu jendela waktu yang telah ditentukan sebelumnya dari daftar drop-down. Misalnya, jika Anda memilih 15 menit dan Anda menetapkan jadwal berulang untuk memanggil targetnya setiap jam sekali, jadwal berjalan dalam 15 menit setelah dimulainya setiap jam.
catatan
Fitur jendela waktu Fleksibel tidak tersedia dengan jadwal satu kali.

Jika Anda memilih Jadwal berulang pada langkah sebelumnya, di bagian Jangka waktu, tentukan zona waktu, dan secara opsional tetapkan tanggal dan waktu mulai, serta tanggal dan waktu akhir untuk jadwal tersebut. Jadwal berulang tanpa tanggal mulai akan dimulai segera setelah dibuat dan tersedia. Jadwal berulang tanpa tanggal akhir akan terus memanggil targetnya tanpa batas waktu.
Pilih Selanjutnya.
Pada halaman Pilih target, lakukan hal berikut:
1. Pilih target Templated dan pilih API target. Untuk contoh ini, kita akan memilih target SendMessage template Amazon SQS.
2. Pada SendMessagebagian ini, untuk antrian SQS, pilih ARN antrian Amazon SQS yang ada arn:aws:sqs:us-west-2:123456789012:TestQueue seperti dari daftar drop-down. Untuk membuat antrean baru, pilih Buat antrean SQS baru untuk menavigasi ke konsol Amazon SQS. Setelah selesai membuat antrian, kembali ke konsol EventBridge Scheduler dan segarkan drop-down. ARN antrian baru Anda muncul dan dapat dipilih.
3. Untuk Target, masukkan payload yang ingin Anda kirimkan EventBridge Scheduler ke target. Untuk contoh ini, kami akan mengirim pesan berikut ke antrean target: Hello, it's EventBridge Scheduler.
Pilih Berikutnya, lalu pada halaman Pengaturan - opsional, lakukan hal berikut:
1. Di bagian Status jadwal, untuk Aktifkan jadwal, aktifkan atau nonaktifkan fitur menggunakan sakelar. Secara default, EventBridge Scheduler memungkinkan jadwal Anda.
2. Di bagian Tindakan setelah jadwal selesai, konfigurasikan tindakan yang dilakukan EventBridge Penjadwal setelah jadwal selesai:
  - Pilih HAPUS jika Anda ingin jadwal dihapus secara otomatis. Untuk jadwal satu kali, ini terjadi setelah jadwal memanggil target satu kali. Untuk jadwal berulang, ini terjadi setelah pemanggilan terakhir jadwal yang direncanakan. Untuk informasi selengkapnya tentang penghapusan otomatis, lihat. Penghapusan setelah jadwal selesai
  - Pilih NONE, atau jangan pilih nilai, jika Anda tidak ingin EventBridge Scheduler mengambil tindakan apa pun setelah jadwal selesai.
3. Di bagian Coba lagi kebijakan dan antrean huruf mati (DLQ), untuk kebijakan Coba lagi, aktifkan Coba lagi untuk mengonfigurasi kebijakan coba lagi untuk jadwal Anda. Dengan kebijakan coba lagi, jika jadwal gagal memanggil targetnya, EventBridge Scheduler menjalankan kembali jadwal. Jika dikonfigurasi, Anda harus mengatur waktu retensi maksimum dan mencoba ulang untuk jadwal.
4. Untuk Usia maksimum acara - opsional, masukkan jam maksimum dan min yang harus disimpan oleh EventBridge Scheduler untuk menyimpan acara yang belum diproses.
  
  catatan
  Nilai maksimumnya adalah 24 jam.
5. Untuk percobaan ulang Maksimum, masukkan jumlah maksimum kali EventBridge Scheduler mencoba ulang jadwal jika target mengembalikan kesalahan.
  
  catatan
  Nilai maksimumnya adalah 185 percobaan ulang.
6. Untuk antrian Dead-letter (DLQ), pilih dari opsi berikut:
  - Tidak ada - Pilih opsi ini jika Anda tidak ingin mengkonfigurasi DLQ.
  - Pilih antrian Amazon SQS di AWS akun saya sebagai DLQ — Pilih opsi ini, lalu pilih ARN antrian dari daftar drop-down, konfigurasikan DLQ sama Akun AWS dengan yang Anda buat jadwal.
  - Tentukan antrean Amazon SQS di AWS akun lain sebagai DLQ — Pilih opsi ini, lalu masukkan ARN antrian konfigurasi sebagai DLQ, jika antreannya ada di yang lain. Akun AWS Anda harus memasukkan ARN yang tepat untuk antrian untuk menggunakan opsi ini.
7. Di bagian Enkripsi, pilih Sesuaikan pengaturan enkripsi (lanjutan) untuk menggunakan kunci KMS yang dikelola pelanggan untuk mengenkripsi input target Anda. Jika Anda memilih opsi ini, masukkan ARN kunci KMS yang ada atau pilih Buat AWS tombol KMS untuk menavigasi ke konsol. AWS KMS Untuk informasi selengkapnya tentang cara EventBridge Scheduler mengenkripsi data Anda saat istirahat, lihat. Enkripsi diam
8. Untuk Izin, pilih Gunakan peran yang ada, lalu pilih peran yang Anda buat selama prosedur penyiapan dari daftar drop-down. Anda juga dapat memilih Pergi ke konsol IAM untuk membuat peran baru.
  
  Jika Anda ingin EventBridge Scheduler membuat peran eksekusi baru untuk Anda, pilih Buat peran baru untuk jadwal ini. Kemudian, masukkan nama untuk nama Peran. Jika Anda memilih opsi ini, EventBridge Scheduler menambahkan izin yang diperlukan untuk target template Anda ke peran.
Pilih Selanjutnya.
Di halaman Tinjau dan buat jadwal, tinjau detail jadwal Anda. Di setiap bagian, pilih Edit untuk kembali ke langkah itu dan mengedit detailnya.
Pilih Buat jadwal untuk menyelesaikan pembuatan jadwal baru Anda. Anda dapat melihat daftar jadwal baru dan yang sudah ada di halaman Jadwal. Di bawah kolom Status, verifikasi bahwa jadwal baru Anda Diaktifkan.
Untuk memverifikasi bahwa jadwal Anda memanggil target Amazon SQS, buka konsol Amazon SQS dan lakukan hal berikut:
1. Pilih antrian target dari daftar Antrian.
2. Pilih Kirim dan terima pesan.
3. Pada halaman Kirim dan terima pesan, di bawah Menerima pesan, pilih Poll untuk pesan untuk mengambil pesan uji yang dikirim oleh jadwal Anda ke antrean target.

Buat jadwal menggunakan AWS CLI

Contoh berikut menunjukkan cara menggunakan AWS CLI perintah create-scheduleuntuk membuat jadwal EventBridge Scheduler dengan target Amazon SQS template. Ganti nilai placeholder untuk parameter berikut dengan informasi Anda:

--name — Masukkan nama untuk jadwal.
RoleArn— Masukkan ARN untuk peran eksekusi yang ingin Anda kaitkan dengan jadwal.
Arn — Masukkan ARN untuk target. Dalam hal ini, targetnya adalah antrian Amazon SQS.
Input — Masukkan pesan yang EventBridge Scheduler kirimkan ke antrean target.


$ aws scheduler create-schedule --name sqs-templated-schedule --schedule-expression 'rate(5 minutes)' \
--target '{"RoleArn": "ROLE_ARN", "Arn": "QUEUE_ARN", "Input": "TEST_PAYLOAD" }' \
--flexible-time-window '{ "Mode": "OFF"}'

Buat jadwal menggunakan SDK EventBridge Scheduler

Dalam contoh berikut, Anda menggunakan SDK EventBridge Scheduler untuk membuat jadwal EventBridge Scheduler dengan target Amazon SQS template.

contoh SDK Python


import boto3
scheduler = boto3.client('scheduler')

flex_window = { "Mode": "OFF" }

sqs_templated = {
    "RoleArn": "<ROLE_ARN>",
    "Arn": "<QUEUE_ARN>",
    "Input": "Message for scheduleArn: '<aws.scheduler.schedule-arn>', scheduledTime: '<aws.scheduler.scheduled-time>'"
}

scheduler.create_schedule(
    Name="sqs-python-templated",
    ScheduleExpression="rate(5 minutes)",
    Target=sqs_templated,
    FlexibleTimeWindow=flex_window)

contoh SDK Java


package com.example;

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.scheduler.SchedulerClient;
import software.amazon.awssdk.services.scheduler.model.*;


public class MySchedulerApp {

    public static void main(String[] args) {
        
        final SchedulerClient client = SchedulerClient.builder()
                .region(Region.US_WEST_2)
                .build();
        
        Target sqsTarget = Target.builder()
                .roleArn("<ROLE_ARN>")
                .arn("<QUEUE_ARN>")
                .input("Message for scheduleArn: '<aws.scheduler.schedule-arn>', scheduledTime: '<aws.scheduler.scheduled-time>'")
                .build();
        
        CreateScheduleRequest createScheduleRequest = CreateScheduleRequest.builder()
                .name("<SCHEDULE NAME>")
                .scheduleExpression("rate(10 minutes)")
                .target(sqsTarget)
                .flexibleTimeWindow(FlexibleTimeWindow.builder()
                        .mode(FlexibleTimeWindowMode.OFF)
                        .build())
                .build();
                
        client.createSchedule(createScheduleRequest);
        System.out.println("Created schedule with rate expression and an Amazon SQS templated target");
    }
}

Apa selanjutnya?

Untuk informasi selengkapnya tentang mengelola jadwal menggunakan konsolAWS CLI, atau SDK EventBridge Penjadwal, lihat. Mengelola jadwal
Untuk informasi selengkapnya tentang cara mengonfigurasi target template dan mempelajari cara menggunakan parameter target universal, lihatMengelola target.
Untuk informasi selengkapnya tentang tipe data EventBridge Scheduler dan operasi API, lihat Referensi API EventBridge Scheduler.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Pengaturan

Jenis jadwal