Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Target bus acara di Amazon EventBridge
*Target* adalah sumber daya atau titik akhir yang EventBridge mengirimkan [peristiwa](eb-events.md) ke saat acara cocok dengan pola acara yang ditentukan untuk [aturan](eb-rules.md). **Aturan memproses data [peristiwa](eb-events.md) 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:
+ Tujuan API
Tujuan API adalah titik akhir HTTPS yang dapat Anda panggil sebagai target aturan bus acara. Saat Anda menentukan tujuan API sebagai target aturan, EventBridge memanggil titik akhir HTTPS untuk setiap peristiwa yang cocok dengan pola peristiwa yang ditentukan dalam aturan, lalu mengirimkan informasi peristiwa dengan permintaan tersebut. Untuk informasi selengkapnya, lihat [Tujuan API](eb-api-destinations.md).
+ Bus acara
Anda dapat menentukan bus acara lain sebagai target aturan. Ini termasuk bus acara di AWS akun yang sama atau berbeda.
+ [Bus acara lintas akun sebagai target](eb-cross-account.md)
+ [Bus acara akun yang sama dengan target](eb-bus-to-bus.md)
+ AWS layanan
Anda dapat EventBridge mengirim acara ke sejumlah sumber daya AWS layanan. Ini termasuk:
+ [API Gateway](eb-api-gateway-target.md)
+ [AWS AppSync](target-appsync.md)
+ [Antrian pekerjaan batch](#targets-specifics-batch)
+ [CloudWatch grup log](#targets-specifics-cwl)
+ [CodeBuild proyek](#targets-specifics-codebuild)
+ CodePipeline
+ Panggilan `CreateSnapshot` API Amazon EBS
+ EC2 Image Builder
+ Panggilan `RebootInstances` API EC2
+ Panggilan `StopInstances` API EC2
+ Panggilan `TerminateInstances` API EC2
+ [Tugas ECS](#targets-specifics-ecs-task)
+ Aliran pengiriman Firehose
+ Alur kerja Glue
+ [Rencana respons Manajer Insiden](https://docs.aws.amazon.com//incident-manager/latest/userguide/incident-creation.html#incident-tracking-auto-eventbridge)
+ Templat penilaian Inspector
+ Aliran kinesis
+ Fungsi Lambda (ASYNC)
+ [Kueri API data klaster Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/data-api-calling-event-bridge.html)
+ [Kueri API data grup kerja Amazon Redshift Tanpa Server](https://docs.aws.amazon.com/redshift/latest/mgmt/data-api-calling-event-bridge.html)
+ SageMaker Pipa AI
+ Topik Amazon SNS
+ [Antrian standar, adil, dan FIFO Amazon SQS](#targets-specifics-sqs)
+ Mesin status Step Functions (ASYNC)
+ Otomatisasi Systems Manager
+ Systems Manager OpsItem
+ Run Command Systems Manager
## 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](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_Target.html) 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. Gunakan [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html)objek untuk memastikan data terstruktur dengan benar. Jika Anda ingin memasukkan muatan acara asli, rujuk di. [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html)
+ API Gateway
Data yang dikirim ke API Gateway harus sesuai dengan struktur API. Gunakan [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html)objek untuk memastikan data terstruktur dengan benar. Jika Anda ingin memasukkan muatan acara asli, rujuk di. [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html)
+ EC2 Image Builder Amazon
+ Cluster API Data Amazon Redshift
Gunakan [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RedshiftDataParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RedshiftDataParameters.html).
+ Pipa Pembuatan Model SageMaker Runtime Amazon
Gunakan [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SageMakerPipelineParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SageMakerPipelineParameters.html).
+ Pameran Amazon SQS dan antrian FIFO
Gunakan [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SqsParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SqsParameters.html)untuk menentukan grup pesan yang akan digunakan sebagai target.
+ Run Command Systems Manager
Gunakan [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RunCommandParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RunCommandParameters.html)untuk menentukan dokumen SSM dan instance target. Untuk informasi selengkapnya, lihat [Systems Manager Run Command sebagai target](#targets-specifics-ssm-run-command).
**catatan**
EventBridge tidak mendukung semua sintaks JSON Path dan mengevaluasinya saat runtime. Sintaks yang didukung meliputi:
notasi titik (misalnya,`$.detail`)
garis putus-putus
menggarisbawahi
karakter alfanumerik
indeks array
wildcard (\*)
garis miring ke depan
### Parameter jalur dinamis
Parameter jalur dinamis memungkinkan Anda menggunakan sintaks jalur JSON untuk mereferensikan data peristiwa saat runtime, bukan 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 sebagian saja. Contoh:
+ ✓ Benar: `RedshiftParameters.Sql` bisa `$.detail.state`
+ ✗ Salah: `RedshiftParameters.Sql` tidak bisa `"SELECT * FROM $.detail.state"`
EventBridge menggantikan jalur ini saat runtime dengan data dari payload acara di jalur yang ditentukan.
#### Batasan
Parameter jalur dinamis tidak dapat mereferensikan nilai baru atau yang diubah dari transformasi input. Sintaks jalur JSON sama dengan sintaks transformasi input. Untuk informasi selengkapnya, lihat [Transformasi EventBridge input Amazon](eb-transform-target-input.md).
#### Parameter yang didukung
Anda dapat menggunakan sintaks dinamis pada semua string, bidang non-enum dari parameter ini:
+ [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_EcsParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_EcsParameters.html)
+ [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_HttpParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_HttpParameters.html)(kecuali `HeaderParameters` kunci)
+ [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RedshiftDataParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RedshiftDataParameters.html)
+ [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SageMakerPipelineParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SageMakerPipelineParameters.html)
+ [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SqsParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SqsParameters.html)
## Izin
Untuk melakukan panggilan API pada sumber daya yang Anda miliki, EventBridge perlu izin yang sesuai. Tentukan peran eksekusi IAM [menggunakan EventBridge konsol](eb-create-rule-wizard.md#eb-create-rule-target), atau dengan menyetel `RoleARN` parameter di [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html).
Misalnya, kebijakan berikut menetapkan izin untuk mengirim pesan ke antrean Amazon SQS:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"sqs:SendMessage"
],
"Resource": [
"arn:aws:sqs:{{us-east-1}}:{{111122223333}}:{{sqs-queue-name}}"
]
}
]
}
```
------
Dan kebijakan kepercayaan berikut memungkinkan EventBridge untuk mengambil peran:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "events.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
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](eb-iam.md).
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 antar AWS akun di Amazon EventBridge](eb-cross-account.md).
Jika target Anda, seperti antrean 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](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_BatchParameters.html).
Lainnya dapat ditentukan dalam muatan acara. Jika payload peristiwa (melewati atau melalui [InputTransformers](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-transform-target-input.html)) berisi kunci berikut, mereka dipetakan untuk `submitJob` [meminta](https://docs.aws.amazon.com/batch/latest/APIReference/API_SubmitJob.html#API_SubmitJob_RequestSyntax) parameter:
+ `ContainerOverrides: containerOverrides`
**catatan**
Ini hanya mencakup perintah, lingkungan, memori, dan vcpus
+ `DependsOn: dependsOn`
**catatan**
Ini termasuk hanya JoBid
+ `Parameters: parameters`
## CloudWatch Log grup sebagai target
Jika Anda tidak menggunakan target [InputTransformer](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-transform-target-input.html)with a CloudWatch Logs, payload peristiwa akan digunakan sebagai pesan log, dan sumber acara sebagai stempel waktu. Jika Anda menggunakan InputTransformer, template harus:
`{"timestamp":,"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 sebagai target
EventBridge mendukung build standar dan batch sebagai target.
Jika Anda menggunakan [transformator input](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-transform-target-input.html) untuk membentuk peristiwa sumber agar sesuai dengan [StartBuildRequest](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuild.html#API_StartBuild_RequestSyntax)struktur sebelum dikirim ke CodeBuild target, parameter akan dipetakan 1-ke-1 dan diteruskan ke `codeBuild.StartBuild` secara default.
`codeBuild.StartBuildBatch`Sebagai gantinya, untuk meneruskan parameter, ubah peristiwa sumber agar sesuai dengan [StartBuildBatchRequest](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuildBatch.html#API_StartBuildBatch_RequestSyntax)struktur, dan tambahkan key/value pasangan berikut ke akar peristiwa yang diubah:
`"buildType": "BATCH"`
## Amazon ECS berfungsi sebagai target
Jika Anda menggunakan [InputTransformers](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-transform-target-input.html)untuk membentuk peristiwa input ke Target agar sesuai dengan RunTask [TaskOverride](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TaskOverride.html)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 detail pemicu StartIncidentRequest panggilan ke Manajer Insiden.
## Systems Manager Jalankan Command sebagai target
Saat Anda menentukan Systems Manager Run Command sebagai target, EventBridge panggil [https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_SendCommand.html](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_SendCommand.html)API atas nama Anda. Konfigurasikan target menggunakan [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RunCommandParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RunCommandParameters.html), yang menentukan dokumen SSM untuk dijalankan dan instance atau tag target.
`RunCommandParameters`berisi bidang-bidang berikut:
+ `RunCommandTargets`— (Wajib) Daftar pasangan kunci-nilai yang menentukan instance target. Gunakan `Key` set to `InstanceIds` dengan daftar instance IDs, atau `Key` atur `tag:{{tag-name}}` dengan nilai tag untuk menargetkan instance berdasarkan tag. Anda dapat menentukan antara 1 dan 5 menjalankan target perintah.
Untuk menentukan dokumen SSM mana yang akan dijalankan dan meneruskan parameter ke sana, gunakan `Input` bidang pada [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_Target.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_Target.html)objek. `Input`Nilai harus berupa objek JSON dengan struktur berikut:
```
{
"DocumentName": "{{document-name}}",
"DocumentVersion": "{{version}}",
"Parameters": {
"{{parameter-key}}": ["{{parameter-value}}"]
}
}
```
Di mana:
+ `DocumentName`— Nama atau ARN dari dokumen SSM yang akan dijalankan.
+ `DocumentVersion`— (Opsional) Versi dokumen. Jika dihilangkan, versi default digunakan.
+ `Parameters`— (Opsional) Peta nama parameter untuk menilai array, cocok dengan parameter yang ditentukan dalam dokumen SSM.
Misalnya, AWS CLI perintah berikut membuat aturan yang menjalankan `AWS-RunShellScript` dokumen pada instance tertentu saat 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}}"]
}]
}
}]'
```
**catatan**
`Input`Bidang pada `Target` objek digunakan untuk meneruskan nama dokumen dan parameter ke Systems Manager Run Command. Ini berbeda dari [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html), yang mengubah payload acara. Saat menggunakan Systems Manager Run Command sebagai target, atur parameter dokumen `Input` dan tentukan instance target di`RunCommandParameters`.
## Antrian Amazon SQS sebagai target
EventBridge tidak mendukung penggunaan antrian Amazon SQS yang dienkripsi dengan file. Kunci milik AWS Ini termasuk target, serta antrian Amazon SQS yang ditentukan sebagai antrian huruf mati untuk target. Untuk informasi selengkapnya Kunci milik AWS, lihat [kunci yang AWS dimiliki](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-owned-cmk) di *Panduan AWS Key Management Service Pengembang*.