Topik ini menjelaskan cara membuat sumber acara kustom tipe HTTP/HTTPS Events di konsol EventBridge.
Informasi latar belakang
Setelah sumber acara kustom tipe HTTP/HTTPS Event dibuat, URL webhook akan dihasilkan untuk menerima permintaan. Jika terjadi suatu peristiwa di server yang dikonfigurasi dengan URL webhook, pesan akan dikirim melalui URL ke EventBridge. Kemudian, EventBridge menentukan apakah akan mengonversi pesan tersebut menjadi sebuah acara dan mendorong acara tersebut ke target acara.
Prasyarat
Prosedur
- Masuk ke Konsol EventBridge.
- Di panel navigasi sebelah kiri, klik Event Buses.
- Di bilah navigasi atas, pilih wilayah.
Pada halaman Event Buses, klik nama bus acara yang ingin Anda kelola.
Di panel navigasi sebelah kiri, klik Event Sources.
Pada halaman Event Source, klik Add Event Source.
Di panel Add Custom Event Source, tentukan parameter Name dan Description serta atur parameter Event Provider ke HTTP/HTTPS Events. Atur parameter yang dijelaskan dalam tabel berikut dan klik OK.
Parameter
Deskripsi
Request Type
Pilih HTTPS, HTTP, atau HTTP&HTTPS.
Request Method
Pilih satu atau lebih metode permintaan HTTP yang didukung. Nilai valid:
GET
POST
PUT
DELETE
HEAD
PATCH
Security Settings
Pilih tipe pengaturan keamanan. Nilai valid:
Opsional: Tidak ada pengaturan keamanan yang dikonfigurasi, dan semua permintaan URL yang diterima didorong sebagai acara ke EventBridge.
Blok CIDR: Masukkan satu atau beberapa alamat IP atau blok CIDR dari mana permintaan diizinkan. Hanya permintaan dari alamat IP yang ditentukan atau alamat IP yang termasuk dalam blok CIDR yang ditentukan yang didorong sebagai acara ke EventBridge. Permintaan berbasis URL lainnya disaring.
Nama Domain Aman: Masukkan nama domain aman. Hanya permintaan yang menggunakan nama domain yang ditentukan yang didorong sebagai acara ke EventBridge. Permintaan berbasis URL lainnya disaring.
CIDR Block
Parameter ini hanya diperlukan saat Anda mengatur parameter Security Settings ke Blok CIDR. Untuk informasi lebih lanjut, lihat deskripsi parameter Security Settings.
CatatanAnda dapat menentukan hingga lima alamat IP atau blok CIDR.
Security Domain Name
Parameter ini hanya diperlukan saat Anda mengatur parameter Security Settings ke Nama Domain Aman. Untuk informasi lebih lanjut, lihat deskripsi parameter Security Settings.
CatatanAnda dapat menentukan hingga lima nama domain aman.
Contoh acara
EventBridge mengonversi permintaan HTTP yang memenuhi persyaratan tertentu menjadi acara. Di bidang data, header permintaan bersarang di bawah parameter headers dan body bersarang di bawah parameter body.
{
"datacontenttype": "application/json",
"aliyunaccountid": "175299981560****",
"data": {
"headers": {
"Host": "175299981560****.eventbridge.cn-hangzhou.aliyuncs.com",
"Accept-Encoding": "gzip, deflate, br",
"accept": "*/*",
"Content-Length": "538",
"Content-Type": "application/json"
},
"path": "/webhook/putEvents",
"body": {
"infoId": 1,
"ruleName": "Test",
"state": "alerting",
"message": "EventBridge test info.",
"ruleId": "796014154722826****"
},
"httpMethod": "GET",
"queryString": {}
},
"subject": "acs:eventbridge:cn-hangzhou:175299981560****:eventbus/EventBridgeDemoBus/eventsource/my.httpSource",
"aliyunoriginalaccountid": "175299981560****",
"source": "my.httpSource",
"type": "eventbridge:Events:HTTPEvent",
"aliyunpublishtime": "2022-03-03T03:33:14.097Z",
"specversion": "1.0",
"aliyuneventbusname": "EventBridgeDemoBus",
"id": "ac0d574c-d862-4662-a87b-784e3d77****",
"time": "2022-03-03T11:33:14.093+08:00",
"aliyunregionid": "cn-hangzhou",
"aliyunpublishaddr": "42.120.XX.XX"
}Untuk informasi lebih lanjut tentang parameter yang didefinisikan dalam spesifikasi CloudEvents, lihat Ikhtisar.
Tabel berikut menjelaskan parameter dalam bidang data.
Parameter | Tipe | Contoh | Deskripsi |
headers | Map | | Header dari permintaan HTTP. |
path | String | /webhook/putEvents | Path permintaan HTTP. |
body | String/Map | | Body dari permintaan HTTP. Jika nilai parameter Content-Type adalah application/json, body dari permintaan HTTP diurai sebagai objek JSON. Jika tidak, body diurai sebagai string biasa. |
httpMethod | String | GET | Metode permintaan HTTP. |
queryString | Map | N/A | Nilai parameter query dalam permintaan HTTP, tidak termasuk konten parameter token. |