Target bus acara di Amazon EventBridge

Target adalah sumber daya atau titik akhir yang EventBridge mengirimkan peristiwa ke saat peristiwa cocok dengan pola peristiwa 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.

Target bus acara tersedia di EventBridge konsol

Anda dapat mengonfigurasi jenis target berikut untuk aturan di EventBridge konsol:

Parameter terget

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

Parameter jalur dinamis

Parameter jalur dinamis memungkinkan Anda menggunakan sintaks jalur JSON untuk mereferensikan data peristiwa saat runtime alih-alih nilai statis.

Anda dapat menggunakan sintaks jalur JSON dinamis dengan parameter target untuk menentukan jalur JSON alih-alih nilai statis (misalnya,$.detail.state).

Persyaratan

Seluruh nilai harus berupa jalur JSON, bukan hanya bagian darinya. Contoh:

EventBridge menggantikan jalur ini saat runtime dengan data dari muatan peristiwa di jalur yang ditentukan.

Batasan

Parameter jalur dinamis tidak dapat mereferensikan nilai baru atau diubah dari transformasi input. Sintaks jalur JSON sama dengan sintaks transformasi input. Untuk informasi selengkapnya, lihat Transformasi EventBridge masukan Amazon.

Parameter yang didukung

Anda dapat menggunakan sintaks dinamis 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. Tentukan peran eksekusi IAM menggunakan EventBridge konsol, atau dengan menyetel RoleARN parameter di PutTargets.

Misalnya, kebijakan berikut mendefinisikan izin untuk mengirim pesan ke antrian Amazon SQS:

Dan kebijakan kepercayaan berikut memungkinkan EventBridge untuk mengambil peran:

Anda dapat memanggil titik akhir API Gateway dengan otorisasi IAM yang dikonfigurasi, tetapi peran tersebut 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 acara antara AWS akun di Amazon EventBridge.

Jika target Anda, seperti antrian Amazon SQS, menggunakan enkripsi AWS Key Management Service (AWS KMS), 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": "*"
}

AWS Batch antrian pekerjaan sebagai target

Parameter tertentu AWS Batch submitJob dapat dikonfigurasi melalui BatchParameters.

Lainnya dapat ditentukan dalam muatan acara. Jika muatan peristiwa (dilewatkan atau melalui InputTransformers) berisi kunci berikut, kunci tersebut dipetakan ke parameter submitJob permintaan:

CloudWatch Log grup sebagai target

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

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

EventBridge menggabungkan 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 Sebagai Target

EventBridge mendukung build standar dan batch sebagai target.

Jika Anda menggunakan transformator input untuk membentuk peristiwa sumber agar sesuai dengan StartBuildRequest struktur sebelum dikirim ke CodeBuild target, parameter akan dipetakan 1-ke-1 dan dilewatkan ke codeBuild.StartBuild secara default.

Untuk meneruskan parameter ke codeBuild.StartBuildBatch sebagai gantinya, ubah peristiwa sumber agar StartBuildBatchRequest sesuai dengan struktur, dan tambahkan key/value pasangan berikut ke root peristiwa yang diubah:

"buildType": "BATCH"

Tugas Amazon ECS sebagai target

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

Rencana respons Manajer Insiden sebagai target

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

Manajer Sistem Jalankan Perintah sebagai target

Saat Anda menentukan System Manager Run Command sebagai target, EventBridge memanggil SendCommand API atas nama Anda. Konfigurasikan target menggunakan RunCommandParameters, yang menentukan dokumen SSM untuk dijalankan dan instance atau tag target.

RunCommandParametersberisi bidang berikut:

Untuk menentukan dokumen SSM mana yang akan dijalankan dan meneruskan parameter ke sana, gunakan Input bidang pada Target objek. InputNilai harus berupa objek JSON dengan struktur berikut:

{
  "DocumentName": "document-name",
  "DocumentVersion": "version",
  "Parameters": {
    "parameter-key": ["parameter-value"]
  }
}

Di mana:

Misalnya, AWS CLI perintah berikut membuat aturan yang menjalankan AWS-RunShellScript dokumen pada instance tertentu ketika EventBridge acara cocok:

aws events put-targets --rule "my-rule" --targets '[{
  "Id": "ssm-target-1",
  "Arn": "arn:aws:ssm:region:account-id:document/AWS-RunShellScript",
  "RoleArn": "arn:aws:iam::account-id:role/EventBridgeSSMRole",
  "Input": "{\\"Parameters\\":{\\"commands\\":[\\"echo Hello from EventBridge\\"]}}",
  "RunCommandParameters": {
    "RunCommandTargets": [{
      "Key": "InstanceIds",
      "Values": ["i-0123456789abcdef0"]
    }]
  }
}]'

Antrian Amazon SQS sebagai target

EventBridge tidak mendukung penggunaan antrian Amazon SQS yang dienkripsi dengan. Kunci milik AWS Ini termasuk target, serta antrian Amazon SQS yang ditentukan sebagai antrian surat mati untuk target. Untuk informasi selengkapnya Kunci milik AWS, lihat kunci yang AWS dimiliki di Panduan AWS Key Management Service Pengembang.