Referensi struktur acara - Amazon EventBridge

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

Referensi struktur acara

Bidang berikut ini muncul dalam peristiwa:

{ "version": "0", "id": "UUID", "detail-type": "event name", "source": "event source", "account": "ARN", "time": "timestamp", "region": "region", "resources": [ "ARN" ], "detail": { JSON object } }
versi

Secara default, ini diatur ke 0 (nol) di semua peristiwa.

id

Versi 4 UUID yang dihasilkan untuk setiap peristiwa. Anda dapat menggunakan id untuk melacak peristiwa saat mereka bergerak melalui aturan ke target.

jenis-detail:

Mengidentifikasi, dalam kombinasi dengan bidang sumber, bidang dan nilai yang muncul di bidang detail.

Acara yang disampaikan oleh CloudTrail memiliki AWS API Call via CloudTrail nilai untukdetail-type.

sumber

Mengidentifikasi layanan yang menghasilkan peristiwa. Semua peristiwa yang datang dari layanan AWS dimulai dengan “aws.” Peristiwa yang dihasilkan pelanggan dapat memiliki nilai berapa pun di sini, selama tidak dimulai dengan “aws.” Kami merekomendasikan penggunaan string nama domain terbalik gaya nama paket Java.

Untuk menemukan nilai yang benar source untuk AWS layanan, lihat tabel tombol kondisi, pilih layanan dari daftar, dan cari awalan layanan. Misalnya, source nilai untuk Amazon CloudFront adalahaws.cloudfront.

akun

Angka 12 digit yang mengidentifikasi akun AWS.

waktu

Peristiwa timestamp, yang dapat ditentukan oleh layanan yang berasal dari peristiwa. Jika peristiwa mencakup interval waktu, layanan dapat melaporkan waktu mulai, sehingga nilai ini mungkin sebelum waktu peristiwa diterima.

wilayah

Mengidentifikasi Wilayah AWS di mana peristiwa berasal.

sumber daya

Array JSON yang berisi ARN yang mengidentifikasi sumber daya yang terlibat dalam peristiwa tersebut. Layanan yang menghasilkan peristiwa menentukan apakah akan memasukkan ARN tersebut. Sebagai contoh, perubahan keadaan instans Amazon EC2 termasuk ARN instans Amazon EC2, peristiwa Auto Scaling termasuk ARN untuk kedua instans dan kelompok Auto Scaling, tapi panggilan API dengan AWS CloudTrail tidak mencakup ARN sumber daya.

detail

Objek JSON yang berisi informasi tentang peristiwa. Layanan yang menghasilkan acara menentukan konten bidang ini. Konten detail bisa sesederhana dua bidang. AWS Peristiwa panggilan API memiliki objek detail dengan sekitar 50 bidang persarangan beberapa kedalaman tingkat.

contoh Contoh: Pemberitahuan perubahan status instans Amazon EC2

Peristiwa berikut di Amazon EventBridge menunjukkan instans Amazon EC2 dihentikan.

{ "version": "0", "id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718", "detail-type": "EC2 Instance State-change Notification", "source": "aws.ec2", "account": "111122223333", "time": "2017-12-22T18:43:48Z", "region": "us-west-1", "resources": [ "arn:aws:ec2:us-west-1:123456789012:instance/i-1234567890abcdef0" ], "detail": { "instance-id": " i-1234567890abcdef0", "state": "terminated" } }

Informasi minimum yang diperlukan untuk acara kustom yang valid

Saat Anda membuat acara khusus, mereka harus menyertakan bidang berikut:

{ "detail-type": "event name", "source": "event source", "detail": { } }
  • detail— Objek JSON yang berisi informasi tentang acara tersebut. Itu bisa"{}".

    catatan

    PutEventsmenerima data dalam format JSON. Untuk tipe data nomor JSON (integer), kendala adalah: nilai minimum -9.223.372.036.854.775.808 dan nilai maksimum 9.223.372.036.854.775.807.

  • detail-type— String yang mengidentifikasi jenis acara.

  • source— String yang mengidentifikasi sumber acara. Peristiwa yang dihasilkan pelanggan dapat memiliki nilai berapa pun di sini, selama tidak dimulai dengan “aws.” Kami merekomendasikan penggunaan string nama domain terbalik gaya nama paket Java.