

Pemberitahuan akhir dukungan: Pada 7 Oktober 2026, AWS akan menghentikan dukungan untuk. AWS IoT Greengrass Version 1 Setelah 7 Oktober 2026, Anda tidak akan lagi dapat mengakses sumber daya. AWS IoT Greengrass V1 Untuk informasi lebih lanjut, silakan kunjungi [Migrasi dari AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).

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

# Dapatkan notifikasi deployment
<a name="deployment-notifications"></a>

Aturan EventBridge acara Amazon memberi Anda pemberitahuan tentang perubahan status untuk penerapan grup Greengrass Anda. EventBridge memberikan aliran peristiwa sistem yang mendekati waktu nyata yang menjelaskan perubahan AWS sumber daya. AWS IoT Greengrass mengirimkan acara ini *setidaknya sekali*. EventBridge Ini berarti bahwa AWS IoT Greengrass mungkin mengirim beberapa salinan dari acara tertentu untuk memastikan pengiriman. Selain itu, pendengar peristiwa Anda mungkin tidak menerima peristiwa dalam urutan peristiwa yang terjadi.

**catatan**  
Amazon EventBridge adalah layanan bus acara yang dapat Anda gunakan untuk menghubungkan aplikasi Anda dengan data dari berbagai sumber, seperti perangkat inti [Greengrass](telemetry.md) dan pemberitahuan penyebaran. Untuk informasi selengkapnya, lihat [Apa itu Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) di *Panduan EventBridge Pengguna Amazon*.

AWS IoT Greengrass memancarkan peristiwa saat penerapan grup mengubah status. Anda dapat membuat EventBridge aturan yang berjalan untuk semua transisi status atau transisi ke status yang Anda tentukan. Saat penerapan memasuki status yang memulai aturan, EventBridge memanggil tindakan target yang ditentukan dalam aturan. Hal ini mengizinkan Anda untuk mengirim pemberitahuan, menangkap informasi peristiwa, mengambil tindakan korektif, atau menginisiasi peristiwa lain untuk merespon perubahan keadaan. Sebagai contoh, Anda dapat membuat aturan untuk kasus penggunaan berikut:
+ Memulai operasi pasca deployment, seperti mengunduh aset dan memberi tahu personil.
+ Kirim pemberitahuan setelah deployment berhasil atau gagal.
+ Terbitkankan metrik kustom tentang peristiwa deployment.

AWS IoT Greengrass memancarkan peristiwa ketika penerapan memasuki status berikut:`Building`,, `InProgress``Success`, dan. `Failure`

**catatan**  
Memantau status [deployment massal](bulk-deploy-cli.md) saat ini tidak didukung. Namun, AWS IoT Greengrass memancarkan peristiwa perubahan status untuk penerapan grup individu yang merupakan bagian dari penyebaran massal.

## Peristiwa perubahan status deployment grup
<a name="events-message-format"></a>

[peristiwa](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html) untuk perubahan keadaan deployment menggunakan format berikut:

```
{
    "version":"0",
    "id":" cd4d811e-ab12-322b-8255-EXAMPLEb1bc8",
    "detail-type":"Greengrass Deployment Status Change",
    "source":"aws.greengrass",
    "account":"123456789012",
    "time":"2018-03-22T00:38:11Z",
    "region":"us-west-2",
    "resources":[],
    "detail":{    
        "group-id": "284dcd4e-24bc-4c8c-a770-EXAMPLEf03b8",
        "deployment-id": "4f38f1a7-3dd0-42a1-af48-EXAMPLE09681",
        "deployment-type": "NewDeployment|Redeployment|ResetDeployment|ForceResetDeployment",
        "status": "Building|InProgress|Success|Failure"
    }
}
```

Anda dapat membuat aturan yang berlaku untuk satu atau lebih grup. Anda dapat memfilter aturan berdasarkan satu atau beberapa jenis deployment berikut dan keadaan deployment:

**Jenis penyebaran**  
+ `NewDeployment`. Deployment pertama dari versi grup.
+ `ReDeployment`. Sebuah deployment ulang versi grup.
+ `ResetDeployment`. Menghapus informasi penyebaran yang disimpan di dalam AWS Cloud dan di inti. AWS IoT Greengrass Untuk informasi selengkapnya, lihat [Atur ulang deployment](reset-deployments-scenario.md).
+ `ForceResetDeployment`. Menghapus informasi deployment yang disimpan di AWS Cloud dan melaporkan keberhasilan tanpa menunggu core untuk merespon. Juga menghapus informasi deployment yang disimpan pada core jika core terhubung atau ketika terhubung selanjutnya.

**Status penyebaran**  
+ `Building`. AWS IoT Greengrass memvalidasi konfigurasi grup dan membangun artefak penerapan.
+ `InProgress`. Penyebaran sedang berlangsung pada AWS IoT Greengrass intinya.
+ `Success`. Deployment berhasil.
+ `Failure`. Deployment gagal.

Ada kemungkinan bahwa peristiwa dapat diduplikasi atau rusak. Untuk menentukan urutan peristiwa, gunakan properti `time` ini.

**catatan**  
AWS IoT Greengrass tidak menggunakan `resources` properti, jadi selalu kosong.

## Prasyarat untuk membuat aturan EventBridge
<a name="create-events-rule-prereqs"></a>

Sebelum Anda membuat EventBridge aturan untuk AWS IoT Greengrass, lakukan hal berikut:
+ Biasakan diri Anda dengan acara, aturan, dan target di EventBridge.
+ Buat dan konfigurasikan target yang dipanggil oleh EventBridge aturan Anda. Aturan dapat menginvokasi berbagai jenis target, termasuk:
  + Amazon Simple Notification Service (Amazon SNS)
  + AWS Lambda fungsi
  + Amazon Kinesis Video Streams
  + Antrean Amazon Simple Queue Service (Amazon SQS)

Untuk informasi selengkapnya, lihat [Apa itu Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) dan [Memulai dengan Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-getting-set-up.html) di *Panduan EventBridge Pengguna Amazon*.

## Konfigurasikan pemberitahuan deployment (konsol)
<a name="create-events-rule-console"></a>

Gunakan langkah-langkah berikut untuk membuat EventBridge aturan yang menerbitkan topik Amazon SNS saat status penerapan berubah untuk grup. Hal ini memungkinkan server web, alamat email, dan pelanggan topik lainnya untuk menanggapi peristiwa tersebut. Untuk informasi selengkapnya, lihat [Membuat EventBridge aturan yang memicu peristiwa dari AWS sumber daya](https://docs.aws.amazon.com/eventbridge/latest/userguide/create-eventbridge-rule.html) di *Panduan EventBridge Pengguna Amazon*.

1. Buka [ EventBridgekonsol Amazon](https://console.aws.amazon.com/events/).

1. Di panel navigasi, pilih **Aturan**.

1. Pilih **Buat aturan**.

1. Masukkan nama dan deskripsi untuk aturan.

   Aturan tidak boleh memiliki nama yang sama dengan aturan lain di Wilayah yang sama dan di bus kejadian yang sama.

1. Untuk **bus acara**, pilih bus acara yang ingin Anda kaitkan dengan aturan ini. Jika Anda ingin aturan ini cocok dengan acara yang berasal dari akun Anda, pilih **bus acara AWS default**. Ketika AWS layanan di akun Anda memancarkan suatu acara, itu selalu masuk ke bus acara default akun Anda.

1. Untuk **Tipe aturan**, pilih **Aturan dengan pola peristiwa**.

1. Pilih **Selanjutnya**.

1. Untuk **Sumber peristiwa**, pilih **Layanan AWS **.

1. Untuk **pola Acara**, pilih **AWS layanan**.

1. Untuk **AWS layanan**, pilih Greengrass.

1. Untuk **Tipe peristiwa**, pilih **Perubahan Status Deployment Greengrass**.
**catatan**  
**AWS API Call via** tipe CloudTrail event didasarkan pada AWS IoT Greengrass integrasi dengan AWS CloudTrail. Anda dapat menggunakan opsi ini untuk membuat aturan yang diprakarsai oleh panggilan baca atau tulis ke AWS IoT Greengrass API. Untuk informasi selengkapnya, lihat [Pencatatan panggilan AWS IoT Greengrass API dengan AWS CloudTrail](logging-using-cloudtrail.md).

1. Pilih keadaan deployment yang menginisiasi pemberitahuan.
   + Untuk menerima pemberitahuan untuk semua peristiwa perubahan keadaan, pilih **Keadaan apa pun**.
   + Untuk menerima notifikasi untuk beberapa peristiwa perubahan keadaan saja, pilih **Keadaan tertentu**, lalu pilih keadaan target.

1. Pilih tipe deployment yang menginisiasi pemberitahuan.
   + Untuk menerima pemberitahuan untuk semua tipe deployment, pilih **Keadaan apa pun**.
   + Untuk menerima notifikasi untuk beberapa tipe deployment saja, pilih **Keadaan tertentu**, lalu pilih tipe deployment target.

1. Pilih **Berikutnya**.

1. Untuk **Jenis target**, pilih **Layanan AWS **.

1. Untuk **Pilih target**, konfigurasikan target Anda. Contoh ini menggunakan topik Amazon SNS, tetapi Anda dapat mengonfigurasi tipe target lain untuk mengirim pemberitahuan.

   1. Untuk **Target**, pilih **topik SNS**.

   1. Untuk **Topik**, pilih topik target Anda.

   1. Pilih **Berikutnya**.

1. Di bawah **Tag**, tentukan tag untuk aturan atau biarkan bidang kosong.

1. Pilih **Berikutnya**.

1. Tinjau detail aturan dan pilih **Buat aturan**.

## Konfigurasikan pemberitahuan deployment (CLI)
<a name="create-events-rule-cli"></a>

Gunakan langkah-langkah berikut untuk membuat EventBridge aturan yang menerbitkan topik Amazon SNS saat status penerapan berubah untuk grup. Hal ini memungkinkan server web, alamat email, dan pelanggan topik lainnya untuk menanggapi peristiwa tersebut.

1. Buat aturan.
   + Ganti *group-id* dengan ID AWS IoT Greengrass grup Anda.

   ```
   aws events put-rule \
     --name TestRule \
     --event-pattern "{\"source\": [\"aws.greengrass\"], \"detail\": {\"group-id\": [\"group-id\"]}}"
   ```

   Properti yang dihilangkan dari tersebut pola akan diabaikan.

1. Tambahkan topik sebagai target aturan.
   + Ganti *topic-arn* dengan ARN topik Amazon SNS Anda.

   ```
   aws events put-targets \
     --rule TestRule \
     --targets "Id"="1","Arn"="topic-arn"
   ```
**catatan**  
Untuk mengizinkan Amazon EventBridge memanggil topik target Anda, Anda harus menambahkan kebijakan berbasis sumber daya ke topik Anda. Untuk informasi selengkapnya, lihat [izin Amazon SNS di Panduan](https://docs.aws.amazon.com/eventbridge/latest/userguide/resource-based-policies-eventbridge.html#sns-permissions) Pengguna *Amazon EventBridge *.

Untuk informasi selengkapnya, lihat [Peristiwa dan pola acara EventBridge di](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html) *Panduan EventBridge Pengguna Amazon*.

## Konfigurasikan pemberitahuan deployment (CloudFormation)
<a name="create-events-rule-cloudformation"></a>

Gunakan CloudFormation templat untuk membuat EventBridge aturan yang mengirim pemberitahuan tentang perubahan status untuk penerapan grup Greengrass Anda. Untuk informasi selengkapnya, lihat [referensi jenis EventBridge sumber daya Amazon](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_Events.html) di *Panduan AWS CloudFormation Pengguna*.

## Lihat juga
<a name="deployment-notifications-see-also"></a>
+ [Menyebarkan AWS IoT Greengrass grup ke inti AWS IoT Greengrass](deployments.md)
+ [Apa itu Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) di *Panduan EventBridge Pengguna Amazon*