Pantau peristiwa AMI menggunakan Amazon EventBridge

Ketika status Amazon Machine Image (AMI) berubah, Amazon EC2 menghasilkan peristiwa yang dikirim ke Amazon EventBridge (sebelumnya dikenal sebagai Amazon CloudWatch Events). Acara dikirim ke bus EventBridge acara default dalam format JSON. Anda dapat menggunakan Amazon EventBridge untuk mendeteksi dan bereaksi terhadap peristiwa ini. Anda melakukan ini dengan membuat aturan EventBridge yang memicu tindakan sebagai respons terhadap suatu peristiwa. Misalnya, Anda dapat membuat EventBridge aturan yang mendeteksi kapan proses pembuatan AMI telah selesai dan kemudian memanggil topik Amazon SNS untuk mengirim pemberitahuan email kepada Anda.

Amazon EC2 menghasilkan EC2 AMI State Change peristiwa ketika AMI memasuki salah satu status berikut:

• available

• failed

• deregistered

• disabled

Peristiwa dihasilkan atas dasar upaya terbaik.

Tabel berikut ini mencantumkan operasi dan status AMI yang dapat dimasuki oleh AMI. Dalam tabel, Ya menunjukkan status yang dapat dimasuki AMI ketika operasi yang sesuai berjalan.

Operasi AMI	available	failed	deregistered	disabled
CopyImage	Ya	Ya
CreateImage	Ya	Ya
CreateRestoreImageTask	Ya	Ya
DeregisterImage			Ya
DisableImage				Ya
EnableImage	Ya
RegisterImage	Ya	Ya

Detail peristiwa

Anda dapat menggunakan bidang berikut dalam acara untuk membuat aturan yang memicu tindakan:

"source": "aws.ec2"

Mengidentifikasi bahwa acara tersebut berasal dari Amazon EC2.

"detail-type": "EC2 AMI State Change"

Mengidentifikasi nama peristiwa.

"detail": { "ImageId": "ami-0123456789example", "State": "available", }

Menyediakan ID AMI dan status AMI (available,failed,deregistered, ataudisabled).

Untuk informasi selengkapnya, lihat berikut ini di Panduan EventBridge Pengguna Amazon:

• EventBridge Acara Amazon

• Pola EventBridge acara Amazon

• EventBridge Aturan Amazon

Untuk tutorial tentang cara membuat fungsi Lambda dan EventBridge aturan yang menjalankan fungsi Lambda, lihat Tutorial: Log status EC2 instance Amazon menggunakan EventBridge dalam Panduan Pengembang.AWS Lambda

available peristiwa

Berikut ini adalah contoh peristiwa yang EC2 dihasilkan Amazon ketika AMI memasuki available status setelah berhasilCreateImage,,CopyImage, RegisterImageCreateRestoreImageTask, atau EnableImage operasi.

"State": "available" menunjukkan bahwa operasi berhasil.

{
    "version": "0",
    "id": "example-9f07-51db-246b-d8b8441bcdf0",
    "detail-type": "EC2 AMI State Change",
    "source": "aws.ec2",
    "account": "012345678901",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "region": "us-east-1",
    "resources": ["arn:aws:ec2:us-east-1::image/ami-0123456789example"],
    "detail": {
        "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b",
        "ImageId": "ami-0123456789example",
        "State": "available",
        "ErrorMessage": ""
    }
}

failed peristiwa

Berikut ini adalah contoh peristiwa yang EC2 dihasilkan Amazon saat AMI memasuki failed status setelah gagalCreateImage, CopyImageRegisterImage, atau CreateRestoreImageTask operasi.

Bidang berikut memberikan informasi terkait:

• "State": "failed" – Menunjukkan bahwa operasi gagal.

• "ErrorMessage": "" – Memberikan alasan kegagalan operasi.

{
    "version": "0",
    "id": "example-9f07-51db-246b-d8b8441bcdf0",
    "detail-type": "EC2 AMI State Change",
    "source": "aws.ec2",
    "account": "012345678901",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "region": "us-east-1",
    "resources": ["arn:aws:ec2:us-east-1::image/ami-0123456789example"],
    "detail": {
        "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b",
        "ImageId": "ami-0123456789example",
        "State": "failed",
        "ErrorMessage": "Description of failure"
    }
}

deregistered peristiwa

Berikut ini adalah contoh peristiwa yang EC2 dihasilkan Amazon ketika AMI memasuki deregistered status setelah DeregisterImage operasi berhasil. Jika operasi gagal, tidak ada peristiwa yang dihasilkan. Kegagalan diketahui segera karena DeregisterImage merupakan operasi tersinkron.

"State": "deregistered" menunjukkan bahwa operasi DeregisterImage berhasil.

{
    "version": "0",
    "id": "example-9f07-51db-246b-d8b8441bcdf0",
    "detail-type": "EC2 AMI State Change",
    "source": "aws.ec2",
    "account": "012345678901",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "region": "us-east-1",
    "resources": ["arn:aws:ec2:us-east-1::image/ami-0123456789example"],
    "detail": {
        "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b",
        "ImageId": "ami-0123456789example",
        "State": "deregistered",
        "ErrorMessage": ""
    }
}

disabled peristiwa

Berikut ini adalah contoh peristiwa yang EC2 dihasilkan Amazon ketika AMI memasuki disabled status setelah DisableImage operasi berhasil. Jika operasi gagal, tidak ada peristiwa yang dihasilkan. Kegagalan diketahui segera karena DisableImage merupakan operasi tersinkron.

"State": "disabled" menunjukkan bahwa operasi DisableImage berhasil.

{
    "version": "0",
    "id": "example-9f07-51db-246b-d8b8441bcdf0",
    "detail-type": "EC2 AMI State Change",
    "source": "aws.ec2",
    "account": "012345678901",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "region": "us-east-1",
    "resources": ["arn:aws:ec2:us-east-1::image/ami-0123456789example"],
    "detail": {
        "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b",
        "ImageId": "ami-0123456789example",
        "State": "disabled",
        "ErrorMessage": ""
    }
}