`. Anda dapat mereferensikan variabel tersebut saat Anda membuat *Templat Masukan*.
**catatan**
CloudWatch Log Amazon dan target SSM tidak mendukung penggunaan `Input` dan `InputPath` dalam transformator inputnya.
### Template masukan
*Templat Masukan* adalah templat untuk informasi yang ingin Anda lewatkan ke target Anda. Anda dapat membuat templat yang melewati baik string maupun JSON ke target. Dengan menggunakan peristiwa sebelumnya dan *Jalur Masukan*, contoh *Templat Masukan* berikut ini akan mengubah peristiwa untuk keluaran contoh sebelum merutekan ke target.
| Deskripsi | Templat | Output |
| --- | --- | --- |
| String sederhana | "instance is in "
| "instance i-0123456789 is in RUNNING"
|
| **String dengan tanda kutip lolos** | "instance \"\" is in "
| "instance \"i-0123456789\" is in RUNNING"
Perhatikan bahwa ini adalah perilaku di EventBridge konsol. AWS CLI keluar dari karakter garis miring dan hasilnya adalah `"instance "i-0123456789" is in RUNNING"`. |
| **JSON sederhana** | {
"instance" : ,
"state":
} | {
"instance" : "i-0123456789",
"state": "RUNNING"
} |
| **JSON dengan string dan variabel** | {
"instance" : ,
"state": "",
"instanceStatus": "instance \"\" is in "
} | {
"instance" : "i-0123456789",
"state": "RUNNING",
"instanceStatus": "instance \"i-0123456789\" is in RUNNING"
} |
| **JSON dengan campuran variabel dan informasi statis** | {
"instance" : ,
"state": [ 9, , true ],
"Transformed" : "Yes"
}
| {
"instance" : "i-0123456789",
"state": [
9,
"RUNNING",
true
],
"Transformed" : "Yes"
} |
| **Termasuk variabel cadangan di JSON** | {
"instance" : ,
"state": ,
"ruleArn" : ,
"ruleName" : ,
"originalEvent" :
} | {
"instance" : "i-0123456789",
"state": "RUNNING",
"ruleArn" : "arn:aws:events:us-east-2:123456789012:rule/example",
"ruleName" : "example",
"originalEvent" : {
... // commented for brevity
}
} |
| **Termasuk variabel cadangan dalam string** | " triggered"
| "example triggered"
|
| **Grup CloudWatch log Amazon** | {
"timestamp" : ,
"message": "instance \"\" is in "
} | {
"timestamp" : 2015-11-11T21:29:54Z,
"message": "instance "i-0123456789" is in RUNNING
} |
## Mengubah input dengan menggunakan API EventBridge
Untuk informasi tentang penggunaan EventBridge API untuk mengubah input, lihat [Menggunakan Input Transformer untuk mengekstrak data dari suatu peristiwa dan memasukkan data tersebut ke target](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html#API_PutTargets_Example_2).
## Mengubah masukan dengan menggunakan AWS CloudFormation
Untuk informasi tentang menggunakan AWS CloudFormation untuk mengubah input, lihat [AWS::Events::Rule InputTransformer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-inputtransformer.html).
## Masalah Umum dengan mengubah input
Ini adalah beberapa masalah umum saat mengubah input di EventBridge:
+ Untuk String, tanda kutip diperlukan.
+ Tidak ada validasi saat membuat jalur JSON untuk templat Anda.
+ Jika Anda menentukan variabel untuk mencocokkan jalur JSON yang tidak ada dalam peristiwa, variabel tersebut tidak dibuat dan tidak akan muncul dalam keluaran.
+ Properti JSON seperti hanya `aws.events.event.json` dapat digunakan sebagai nilai bidang JSON, tidak sebaris di string lain.
+ EventBridge tidak lolos dari nilai yang diekstraksi oleh *Jalur Input*, saat mengisi *Template Input* untuk target.
+ Jika jalur JSON mereferensikan objek atau array JSON, tetapi variabel direferensikan dalam string, EventBridge menghapus tanda kutip internal untuk memastikan string yang valid. Misalnya, untuk variabel yang `` ditunjuk`$.detail`, “Detail is” akan mengakibatkan EventBridge penghapusan tanda kutip dari objek.
Oleh karena itu, jika Anda ingin menampilkan objek JSON berdasarkan variabel jalur JSON tunggal, Anda harus menempatkannya sebagai kunci. Dalam contoh ini,`{"detail": }`.
+ Kutipan tidak diperlukan untuk variabel yang mewakili string. Mereka diizinkan, tetapi EventBridge secara otomatis menambahkan tanda kutip ke nilai variabel string selama transformasi, untuk memastikan output transformasi adalah JSON yang valid. EventBridge tidak menambahkan tanda kutip ke variabel yang mewakili objek atau array JSON. Jangan menambahkan tanda kutip untuk variabel yang mewakili objek JSON atau array.
Misalnya, template input berikut mencakup variabel yang mewakili string dan objek JSON:
```
{
"ruleArn" : ,
"ruleName" : ,
"originalEvent" :
}
```
Menghasilkan JSON yang valid dengan kutipan yang tepat:
```
{
"ruleArn" : "arn:aws:events:us-east-2:123456789012:rule/example",
"ruleName" : "example",
"originalEvent" : {
... // commented for brevity
}
}
```
+ Untuk output teks (non-JSON) sebagai string multi-baris, bungkus setiap baris terpisah di template input Anda dalam tanda kutip ganda.
Misalnya, jika Anda mencocokkan [Amazon Inspector Finding](https://docs.aws.amazon.com/inspector/latest/user/eventbridge-integration.html#event-finding) event dengan pola event berikut:
```
{
"detail": {
"severity": ["HIGH"],
"status": ["ACTIVE"]
},
"detail-type": ["Inspector2 Finding"],
"source": ["inspector2"]
}
```
Dan menggunakan jalur input berikut:
```
{
"account": "$.detail.awsAccountId",
"ami": "$.detail.resources[0].details.awsEc2Instance.imageId",
"arn": "$.detail.findingArn",
"description": "$.detail.description",
"instance": "$.detail.resources[0].id",
"platform": "$.detail.resources[0].details.awsEc2Instance.platform",
"region": "$.detail.resources[0].region",
"severity": "$.detail.severity",
"time": "$.time",
"title": "$.detail.title",
"type": "$.detail.type"
}
```
Anda dapat menggunakan template input di bawah ini untuk menghasilkan output string multi-baris:
```
" severity finding "
"Description: <description>"
"ARN: \"<arn>\""
"Type: <type>"
"AWS Account: <account>"
"Region: <region>"
"EC2 Instance: <instance>"
"Platform: <platform>"
"AMI: <ami>"
```
# Mengkonfigurasi transformator input saat membuat aturan di EventBridge
<a name="eb-transform-input-rule"></a>
Sebagai bagian dari pembuatan aturan, Anda dapat menentukan transformator input EventBridge untuk digunakan untuk memproses peristiwa pencocokan sebelum mengirim peristiwa tersebut ke target yang ditentukan. Anda dapat mengonfigurasi transformator input untuk target yang merupakan AWS layanan atau tujuan API.
**Untuk membuat transformator input target sebagai bagian dari aturan**
1. Ikuti langkah-langkah untuk membuat aturan seperti yang dijelaskan dalam[Membuat aturan di Amazon EventBridge](eb-create-rule-visual.md).
1. Di **Langkah 3 - Pilih target**, perluas **Pengaturan tambahan**.
1. Untuk **Konfigurasi input target**, pilih **Input transformator** di dropdown.
Klik **Konfigurasi transformator input**.
EventBridge menampilkan kotak dialog **Configure input transformator**.
1. Di bagian **Contoh peristiwa**, pilih **jenis acara Contoh** yang ingin Anda uji pola acara Anda. Anda dapat memilih AWS acara, acara mitra, atau memasukkan acara khusus Anda sendiri.
------
#### [ AWS events ]
Pilih dari peristiwa yang dipancarkan dari yang didukung. Layanan AWS
1. Pilih **AWS acara**.
1. Di bawah **Contoh peristiwa**, pilih AWS acara yang diinginkan. Acara diselenggarakan oleh AWS layanan.
Saat Anda memilih acara, EventBridge mengisi contoh acara.
Misalnya, jika Anda memilih **S3 Object Created**, EventBridge menampilkan contoh acara S3 Object Created.
1. (Opsional) Anda juga dapat memilih **Salin** untuk menyalin contoh peristiwa ke clipboard perangkat Anda.
------
#### [ Partner events ]
Pilih dari peristiwa yang dipancarkan dari layanan pihak ketiga yang mendukung EventBridge, seperti Salesforce.
1. Pilih **acara EventBridge mitra**.
1. Di bawah **Contoh acara**, pilih acara mitra yang diinginkan. Acara diselenggarakan oleh mitra.
Saat Anda memilih acara, EventBridge mengisi contoh acara.
1. (Opsional) Anda juga dapat memilih **Salin** untuk menyalin contoh peristiwa ke clipboard perangkat Anda.
------
#### [ Enter your own ]
Masukkan acara Anda sendiri dalam teks JSON.
1. Pilih **Masukkan milik Anda sendiri**.
1. EventBridge mengisi acara sampel dengan template atribut acara yang diperlukan.
1. Edit dan tambahkan ke acara sampel sesuai keinginan. Contoh acara harus JSON yang valid.
1. (Opsional) Anda juga dapat memilih salah satu opsi berikut:
+ **Salin** - Salin contoh acara ke clipboard perangkat Anda.
+ **Prettify** - Membuat teks JSON lebih mudah dibaca dengan menambahkan jeda baris, tab, dan spasi.
------
1. (Opsional) Perluas **jalur masukan Contoh, Template dan Output** bagian untuk melihat contoh:
+ Bagaimana jalur JSON digunakan untuk mendefinisikan variabel yang mewakili data peristiwa
+ Bagaimana variabel-variabel tersebut dapat digunakan dalam template transformator input
+ Output yang dihasilkan yang EventBridge mengirim ke target
Untuk contoh transformasi input yang lebih rinci, lihat[Contoh transformasi masukan](eb-transform-target-input.md#eb-transform-input-examples).
1. Di bagian **Transformator input target**, tentukan variabel apa pun yang ingin Anda gunakan dalam template input.
Variabel menggunakan jalur JSON untuk mereferensikan nilai di sumber acara asli. Anda kemudian dapat mereferensikan variabel-variabel tersebut dalam template input untuk memasukkan data dari peristiwa sumber asli dalam peristiwa yang diubah yang EventBridge lolos ke target. Anda dapat menentukan hingga 100 variabel. Trafo input harus JSON yang valid.
Misalnya, Anda telah memilih AWS acara **S3 Object Created** sebagai contoh acara Anda untuk transformator input ini. Anda kemudian dapat menentukan variabel berikut untuk digunakan dalam template Anda:
```
{
"requester": "$.detail.requester",
"key": "$.detail.object.key",
"bucket": "$.detail.bucket.name"
}
```
(Opsional) Anda juga dapat memilih **Salin** untuk menyalin transformator input ke clipboard perangkat Anda.
1. Di bagian **Template**, tulis template yang ingin Anda gunakan untuk menentukan apa yang EventBridge lolos ke target.
Anda dapat menggunakan JSON, string, informasi statis, variabel yang telah Anda definisikan serta variabel cadangan. Untuk contoh transformasi input yang lebih rinci, lihat[Contoh transformasi masukan](eb-transform-target-input.md#eb-transform-input-examples).
Misalnya, Anda telah mendefinisikan variabel dalam contoh sebelumnya. Anda kemudian dapat membuat template berikut, yang mereferensikan variabel-variabel tersebut, serta variabel cadangan, dan informasi statis.
```
{
"message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"",
"RuleName": <aws.events.rule-name>,
"ruleArn" : <aws.events.rule-arn>,
"Transformed": "Yes"
}
```
(Opsional) Anda juga dapat memilih **Salin** untuk menyalin template ke clipboard perangkat Anda.
1. Untuk menguji template Anda, pilih **Hasilkan output**.
EventBridge memproses peristiwa sampel berdasarkan template input, dan menampilkan output yang diubah yang dihasilkan di bawah **Output**. Ini adalah informasi yang EventBridge akan diteruskan ke target di tempat acara sumber asli.
Output yang dihasilkan untuk contoh template input yang dijelaskan di atas adalah sebagai berikut:
```
{
"message": "123456789012 has created the object "example-key" in the bucket "amzn-s3-demo-bucket"",
"RuleName": rule-name,
"ruleArn" : arn:aws:events:us-east-1:123456789012:rule/rule-name,
"Transformed": "Yes"
}
```
(Opsional) Anda juga dapat memilih **Salin** untuk menyalin output yang dihasilkan ke clipboard perangkat Anda.
1. Pilih **Konfirmasi**
1. Ikuti langkah-langkah lainnya untuk membuat aturan seperti yang dijelaskan dalam[Membuat aturan di Amazon EventBridge](eb-create-rule-visual.md).
# Menguji transformator input target menggunakan EventBridge Sandbox
<a name="eb-sandbox-input-trans"></a>
[Anda dapat menggunakan transformator input untuk menyesuaikan teks dari suatu [peristiwa](eb-events.md) sebelum EventBridge meneruskan informasi ke [target](eb-targets.md) aturan.](eb-rules.md)
Mengkonfigurasi transformator input biasanya merupakan bagian dari proses yang lebih besar dalam menentukan target sambil [membuat aturan baru](eb-create-rule-visual.md) atau mengedit yang sudah ada. Namun EventBridge, dengan menggunakan Sandbox, Anda dapat dengan cepat mengonfigurasi transformator input dan menggunakan contoh peristiwa untuk mengonfirmasi bahwa Anda mendapatkan output yang diinginkan, tanpa harus membuat atau mengedit aturan.
Untuk informasi lebih lanjut tentang transformasi input, lihat[Transformasi EventBridge masukan Amazon](eb-transform-target-input.md).
**Untuk menguji transformator input target**
1. Buka EventBridge konsol Amazon di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Di bawah **Sumber daya Pengembang**, pilih **Sandbox**, dan pada halaman **Sandbox** pilih tab **Transformator input target**.
1. Di bagian **Contoh peristiwa**, pilih **jenis acara Contoh** yang ingin Anda uji pola acara Anda. Anda dapat memilih AWS acara, acara mitra, atau memasukkan acara khusus Anda sendiri.
------
#### [ AWS events ]
Pilih dari peristiwa yang dipancarkan dari yang didukung. Layanan AWS
1. Pilih **AWS acara**.
1. Di bawah **Contoh peristiwa**, pilih AWS acara yang diinginkan. Acara diselenggarakan oleh AWS layanan.
Saat Anda memilih acara, EventBridge mengisi contoh acara.
Misalnya, jika Anda memilih **S3 Object Created**, EventBridge menampilkan contoh acara S3 Object Created.
1. (Opsional) Anda juga dapat memilih **Salin** untuk menyalin contoh peristiwa ke clipboard perangkat Anda.
------
#### [ Partner events ]
Pilih dari peristiwa yang dipancarkan dari layanan pihak ketiga yang mendukung EventBridge, seperti Salesforce.
1. Pilih **acara EventBridge mitra**.
1. Di bawah **Contoh acara**, pilih acara mitra yang diinginkan. Acara diselenggarakan oleh mitra.
Saat Anda memilih acara, EventBridge mengisi contoh acara.
1. (Opsional) Anda juga dapat memilih **Salin** untuk menyalin contoh peristiwa ke clipboard perangkat Anda.
------
#### [ Enter your own ]
Masukkan acara Anda sendiri dalam teks JSON.
1. Pilih **Masukkan milik Anda sendiri**.
1. EventBridge mengisi acara sampel dengan template atribut acara yang diperlukan.
1. Edit dan tambahkan ke acara sampel sesuai keinginan. Contoh acara harus JSON yang valid.
1. (Opsional) Anda juga dapat memilih salah satu opsi berikut:
+ **Salin** - Salin contoh acara ke clipboard perangkat Anda.
+ **Prettify** - Membuat teks JSON lebih mudah dibaca dengan menambahkan jeda baris, tab, dan spasi.
------
1. (Opsional) Perluas **jalur masukan Contoh, Template dan Output** bagian untuk melihat contoh:
+ Bagaimana jalur JSON digunakan untuk mendefinisikan variabel yang mewakili data peristiwa
+ Bagaimana variabel-variabel tersebut dapat digunakan dalam template transformator input
+ Output yang dihasilkan yang EventBridge mengirim ke target
Untuk contoh transformasi input yang lebih rinci, lihat[Contoh transformasi masukan](eb-transform-target-input.md#eb-transform-input-examples).
1. Di bagian **Transformator input target**, tentukan variabel apa pun yang ingin Anda gunakan dalam template input.
Variabel menggunakan jalur JSON untuk mereferensikan nilai di sumber acara asli. Anda kemudian dapat mereferensikan variabel-variabel tersebut dalam template input untuk memasukkan data dari peristiwa sumber asli dalam peristiwa yang diubah yang EventBridge lolos ke target. Anda dapat menentukan hingga 100 variabel. Trafo input harus JSON yang valid.
Misalnya, Anda telah memilih AWS acara **S3 Object Created** sebagai contoh acara Anda untuk transformator input ini. Anda kemudian dapat menentukan variabel berikut untuk digunakan dalam template Anda:
```
{
"requester": "$.detail.requester",
"key": "$.detail.object.key",
"bucket": "$.detail.bucket.name"
}
```
(Opsional) Anda juga dapat memilih **Salin** untuk menyalin transformator input ke clipboard perangkat Anda.
1. Di bagian **Template**, tulis template yang ingin Anda gunakan untuk menentukan apa yang EventBridge lolos ke target.
Anda dapat menggunakan JSON, string, informasi statis, variabel yang telah Anda definisikan serta variabel cadangan. Untuk contoh transformasi input yang lebih rinci, lihat[Contoh transformasi masukan](eb-transform-target-input.md#eb-transform-input-examples).
Misalnya, Anda telah mendefinisikan variabel dalam contoh sebelumnya. Anda kemudian dapat membuat template berikut, yang mereferensikan variabel-variabel tersebut, serta variabel cadangan, dan informasi statis.
```
{
"message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"",
"RuleName": <aws.events.rule-name>,
"ruleArn" : <aws.events.rule-arn>,
"Transformed": "Yes"
}
```
(Opsional) Anda juga dapat memilih **Salin** untuk menyalin template ke clipboard perangkat Anda.
1. Untuk menguji template Anda, pilih **Hasilkan output**.
EventBridge memproses peristiwa sampel berdasarkan template input, dan menampilkan output yang diubah yang dihasilkan di bawah **Output**. Ini adalah informasi yang EventBridge akan diteruskan ke target di tempat acara sumber asli.
Output yang dihasilkan untuk contoh template input yang dijelaskan di atas adalah sebagai berikut:
```
{
"message": "123456789012 has created the object "example-key" in the bucket "amzn-s3-demo-bucket"",
"RuleName": rule-name,
"ruleArn" : arn:aws:events:us-east-1:123456789012:rule/rule-name,
"Transformed": "Yes"
}
```
(Opsional) Anda juga dapat memilih **Salin** untuk menyalin output yang dihasilkan ke clipboard perangkat Anda.