EventBridge Target Amazon - Amazon EventBridge

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

EventBridge Target Amazon

Target adalah sumber daya atau titik akhir yang EventBridge mengirimkan peristiwa ke saat acara cocok dengan pola acara yang ditentukan untuk aturan. Aturan memproses data peristiwa dan mengirimkan informasi yang berkaitan ke target. Untuk mengirimkan data peristiwa ke target, EventBridge perlu izin untuk mengakses sumber daya target. Anda dapat menentukan hingga lima target untuk setiap aturan.

Ketika Anda menambahkan target ke aturan dan aturan tersebut berjalan segera setelah itu, setiap target baru atau diperbarui mungkin tidak segera dipanggil. Berikan waktu yang singkat agar perubahan diterapkan.

Video berikut mencakup dasar-dasar target:

Target tersedia di EventBridge konsol

Anda dapat mengonfigurasi target berikut untuk acara di EventBridge konsol:

Parameter terget

Beberapa target tidak mengirim informasi dalam muatan acara ke target, sebaliknya, mereka memperlakukan peristiwa sebagai pemicu untuk menjalankan API tertentu. EventBridge menggunakan parameter Target untuk menentukan apa yang terjadi dengan target itu. Sumber daya yang dimaksud meliputi:

  • Tujuan API (Data yang dikirim ke tujuan API harus sesuai dengan struktur API. Anda harus menggunakan InputTransformerobjek untuk memastikan data terstruktur dengan benar. Jika Anda ingin memasukkan muatan acara asli, rujuk di InputTransformer.)

  • API Gateway (Data yang dikirim ke API Gateway harus sesuai dengan struktur API. Anda harus menggunakan InputTransformerobjek untuk memastikan data terstruktur dengan benar. Jika Anda ingin memasukkan muatan acara asli, rujuk di InputTransformer.)

  • EC2 Image Builder Amazon

  • RedshiftDataParameters(Cluster API Data Amazon Redshift)

  • SageMakerPipelineParameters(Pipa Pembuatan Model SageMaker Runtime Amazon)

catatan

EventBridge tidak mendukung semua sintaks JSON Path dan mengevaluasinya saat runtime. Sintaks yang didukung meliputi:

  • notasi titik (misalnya,$.detail)

  • tanda hubung

  • menggarisbawahi

  • karakter alfanumerik

  • indeks array

  • wildcard (*)

Parameter jalur dinamis

Beberapa parameter target mendukung sintaks jalur JSON dinamis opsional. Sintaks ini memungkinkan Anda untuk menentukan jalur JSON bukan nilai statis (misalnya$.detail.state). Seluruh nilai harus berupa jalur JSON, bukan hanya bagian darinya. Misalnya, RedshiftParameters.Sql bisa $.detail.state tetapi tidak bisa"SELECT * FROM $.detail.state". Jalur ini diganti secara dinamis saat runtime dengan data dari payload acara itu sendiri di jalur yang ditentukan. Parameter jalur dinamis tidak dapat mereferensikan nilai baru atau yang diubah yang dihasilkan dari transformasi input. Sintaks yang didukung untuk jalur JSON parameter dinamis sama seperti saat mengubah input. Lihat informasi yang lebih lengkap di Transformasi EventBridge masukan Amazon

Sintaks dinamis dapat digunakan pada semua string, bidang non-enum dari parameter ini:

Izin

Untuk melakukan panggilan API pada sumber daya yang Anda miliki, EventBridge perlu izin yang sesuai. Untuk AWS Lambda dan sumber daya Amazon SNS, EventBridge menggunakan kebijakan berbasis sumber daya. Untuk instans EC2, aliran data Kinesis, dan mesin status Step Functions, EventBridge menggunakan peran IAM yang Anda tentukan dalam parameter. RoleARN PutTargets Anda dapat memanggil titik akhir API Gateway dengan otorisasi IAM yang dikonfigurasi, tetapi peran tersebut bersifat opsional jika Anda belum mengonfigurasi otorisasi. Untuk informasi selengkapnya, lihat Amazon EventBridge dan AWS Identity and Access Management.

Jika akun lainnya berada di Wilayah yang sama dan telah memberikan izin kepada Anda, maka Anda dapat mengirim peristiwa ke akun tersebut. Untuk informasi selengkapnya, lihat Mengirim dan menerima EventBridge acara Amazon antar AWS akun.

Jika target Anda dienkripsi, Anda harus menyertakan bagian berikut dalam kebijakan kunci KMS Anda.

{ "Sid": "Allow EventBridge to use the key", "Effect": "Allow", "Principal": { "Service": "events.amazonaws.com" }, "Action": [ "kms:Decrypt", "kms:GenerateDataKey" ], "Resource": "*" }

EventBridge spesifik target

AWS Batch antrian pekerjaan

Parameter tertentu AWS Batch submitJob dapat dikonfigurasi melalui BatchParameters.

Lainnya dapat ditentukan dalam muatan acara. Jika payload peristiwa (melewati atau melalui InputTransformers) berisi kunci berikut, mereka dipetakan untuk submitJob meminta parameter:

  • ContainerOverrides: containerOverrides

    catatan

    Ini hanya mencakup perintah, lingkungan, memori, dan vcpus

  • DependsOn: dependsOn

    catatan

    Ini termasuk hanya JoBid

  • Parameters: parameters

CloudWatch Grup log

Jika Anda tidak menggunakan target InputTransformerwith a CloudWatch Logs, payload peristiwa akan digunakan sebagai pesan log, dan sumber acara sebagai stempel waktu. Jika Anda menggunakan InputTransformer, template harus:

{"timestamp":<timestamp>,"message":<message>}

EventBridge batch entri yang dikirim ke aliran log; oleh karena itu, EventBridge dapat mengirimkan satu atau beberapa peristiwa ke aliran log, tergantung pada lalu lintas.

CodeBuild proyek

Jika Anda menggunakan InputTransformersuntuk membentuk peristiwa input ke Target agar sesuai dengan CodeBuild StartBuildRequeststruktur, parameter akan dipetakan 1-ke-1 dan diteruskan ke. codeBuild.StartBuild

Tugas Amazon ECS

Jika Anda menggunakan InputTransformersuntuk membentuk peristiwa input ke Target agar sesuai dengan RunTask TaskOverridestruktur Amazon ECS, parameter akan dipetakan 1-ke-1 dan diteruskan ke. ecs.RunTask

Rencana Respons Manajer Insiden

Jika peristiwa yang cocok berasal dari CloudWatch Alarm, detail perubahan status alarm diisi ke detail pemicu StartIncidentRequest panggilan ke Manajer Insiden.