Pantau AMI acara 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 JSON format. 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 saat proses AMI pembuatan selesai dan kemudian memanggil SNS topik Amazon untuk mengirim pemberitahuan email kepada Anda.

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

• available

• failed

• deregistered

• disabled

Peristiwa dihasilkan atas dasar upaya terbaik.

Tabel berikut mencantumkan AMI operasi dan status yang AMI dapat dimasukkan. Dalam tabel, Ya menunjukkan status bahwa AMI dapat masuk ketika operasi yang sesuai berjalan.

AMIoperasi	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 AmazonEC2.

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

Mengidentifikasi nama peristiwa.

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

Memberikan AMI ID dan status AMI (available,, failedderegistered, 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

Peristiwa available

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": ""
    }
}

Peristiwa failed

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"
    }
}

Peristiwa deregistered

Berikut ini adalah contoh peristiwa yang EC2 dihasilkan Amazon ketika AMI memasuki deregistered status setelah DeregisterImage operasi yang 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": ""
    }
}

Peristiwa disabled

Berikut ini adalah contoh peristiwa yang EC2 dihasilkan Amazon ketika AMI memasuki disabled status setelah DisableImage operasi yang 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": ""
    }
}