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

# Pantau peristiwa AMI menggunakan Amazon EventBridge
<a name="monitor-ami-events"></a>

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

**Peristiwa EC2 AMI State Change**
+ [Detail peristiwa](#ami-events)
+ [Peristiwa available](#ami-event-available)
+ [Peristiwa failed](#ami-event-failed)
+ [Peristiwa deregistered](#ami-event-deregistered)
+ [Peristiwa disabled](#ami-event-disabled)

## Detail peristiwa
<a name="ami-events"></a>

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-0abcdef1234567890", "State": "available", }`  
Menyediakan ID AMI dan status AMI (`available`,`failed`,`deregistered`, atau`disabled`).

Untuk informasi selengkapnya, lihat berikut ini di *Panduan EventBridge Pengguna Amazon*:
+ [ EventBridge Acara Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)
+ [Pola EventBridge acara Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)
+ [ EventBridge Aturan Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)

*Untuk tutorial tentang cara membuat fungsi Lambda dan EventBridge aturan yang menjalankan fungsi Lambda, lihat [Tutorial: Log status EC2 instance Amazon menggunakan EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-log-ec2-instance-state.html) dalam Panduan Pengembang.AWS Lambda *

## Peristiwa available
<a name="ami-event-available"></a>

Berikut ini adalah contoh peristiwa yang EC2 dihasilkan Amazon ketika AMI memasuki `available` status setelah berhasil`CreateImage`,,`CopyImage`, `RegisterImage``CreateRestoreImageTask`, 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-0abcdef1234567890"],
    "detail": {
        "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b",
        "ImageId": "ami-0abcdef1234567890",
        "State": "available",
        "ErrorMessage": ""
    }
}
```

## Peristiwa failed
<a name="ami-event-failed"></a>

Berikut ini adalah contoh peristiwa yang EC2 dihasilkan Amazon saat AMI memasuki `failed` status setelah gagal`CreateImage`, `CopyImage``RegisterImage`, 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-0abcdef1234567890"],
    "detail": {
        "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b",
        "ImageId": "ami-0abcdef1234567890",
        "State": "failed",
        "ErrorMessage": "Description of failure"
    }
}
```

## Peristiwa deregistered
<a name="ami-event-deregistered"></a>

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-0abcdef1234567890"],
    "detail": {
        "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b",
        "ImageId": "ami-0abcdef1234567890",
        "State": "deregistered",
        "ErrorMessage": ""
    }
}
```

## Peristiwa disabled
<a name="ami-event-disabled"></a>

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-0abcdef1234567890"],
    "detail": {
        "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b",
        "ImageId": "ami-0abcdef1234567890",
        "State": "disabled",
        "ErrorMessage": ""
    }
}
```