Referensi struktur acara

Bidang berikut muncul di semua acara yang dikirim ke bus acara, dan terdiri dari metadata acara:

{
  "versi": "0",
  "id": "UUID",
  "jenis-detail: ": "event name",
  "sumber": "event source",
  "akun": "ARN",
  "Waktu": "timestamp",
  "region": "region",
  "sumber daya": [
    "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

Nomor 12 digit yang mengidentifikasi AWS akun.

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.

region

Mengidentifikasi AWS Wilayah tempat acara tersebut 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. Itu bisa"{}".

AWS Peristiwa panggilan API memiliki objek detail dengan sekitar 50 bidang bersarang beberapa level.

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.

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

• detail-type

• source

{
  "detail-type": "event name",
  "source": "event source",
  "detail": {
  }
}