

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

# Membuat aturan notifikasi
<a name="notification-rule-create"></a>

Anda dapat menggunakan aturan notifikasi untuk memberitahu pengguna perubahan penting, seperti ketika permintaan tarik dibuat dalam sebuah repositori. Aturan notifikasi menentukan peristiwa dan topik Amazon SNS yang digunakan untuk mengirim notifikasi. Untuk informasi selengkapnya, lihat [Apa itu notifikasi?](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/welcome.html)



**catatan**  
Fitur ini tidak tersedia di Wilayah Eropa (Milan). Untuk mempelajari cara mengonfigurasi notifikasi dalam pengalaman yang tersedia di Wilayah tersebut, lihat [Mengkonfigurasi Notifikasi Repository](https://github.com/awsdocs/aws-codecommit-user-guide/blob/master/doc_source/how-to-repository-email-create.2.md).

Anda dapat menggunakan konsol atau AWS CLI untuk membuat aturan notifikasi untuk AWS CodeCommit. <a name="notification-rule-create-console"></a>

# Untuk membuat aturan notifikasi (konsol)
<a name="notification-rule-create-console"></a>

1. Masuk ke Konsol Manajemen AWS dan buka CodeCommit konsol di [https://console.aws.amazon.com/codecommit/](https://console.aws.amazon.com/codecommit/).

1. Pilih **Repositori**, dan kemudian pilih repositori tempat Anda ingin menambahkan aturan notifikasi.

1. Pada halaman repositori, pilih **Beritahu**, lalu pilih **Buat aturan notifikasi**. Anda juga dapat pergi ke **Pengaturan** untuk repositori tersebut dan pilih **Buat aturan notifikasi**.

1. Di **Nama notifikasi**, masukkan nama untuk aturan.

1. Di **Jenis detail**, pilih **Dasar** jika Anda hanya menginginkan informasi yang diberikan ke Amazon yang EventBridge disertakan dalam notifikasi. Pilih **Lengkap** jika Anda ingin menyertakan informasi yang diberikan ke Amazon EventBridge dan informasi yang mungkin diberikan oleh CodeCommit atau pengelola notifikasi.

   Untuk informasi selengkapnya, lihat [Memahami Konten Notifikasi dan Keamanan](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/security.html#security-notifications).

1.  Di **Peristiwa yang memicu notifikasi**, pilih peristiwa yang ingin Anda kirimkan notifikasi. Untuk informasi selengkapnya, lihat [ Peristiwa untuk Aturan Notifikasi di Repositori](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/concepts.html#events-ref-repositories).

1. Di **Target**, lakukan salah satu langkah berikut:
   + Jika Anda telah mengonfigurasi sumber daya untuk digunakan dengan notifikasi, di **Pilih jenis target**, pilih **Pengembang Amazon Q di aplikasi obrolan (Slack) atau topik** **SNS**. Di **Pilih target**, pilih nama klien (untuk klien Slack yang dikonfigurasi di Amazon Q Developer dalam aplikasi obrolan) atau Nama Sumber Daya Amazon (ARN) dari topik Amazon SNS (untuk topik Amazon SNS yang sudah dikonfigurasi dengan kebijakan yang diperlukan untuk pemberitahuan).
   + Jika Anda belum mengonfigurasi sumber daya untuk digunakan dengan notifikasi, pilih **Buat target**, lalu pilih **Topik SNS**. Berikan nama untuk topik setelah **codestar-notifications-**, lalu pilih **Buat**.
**catatan**  
Jika Anda membuat topik Amazon SNS sebagai bagian dari membuat aturan notifikasi, kebijakan yang memungkinkan fitur notifikasi untuk mempublikasikan peristiwa untuk topik diterapkan untuk Anda. Menggunakan topik yang dibuat untuk aturan notifikasi membantu memastikan bahwa Anda hanya berlangganan pengguna yang ingin Anda terima notifikasinya tentang sumber daya ini.
Anda tidak dapat membuat Pengembang Amazon Q di klien aplikasi obrolan sebagai bagian dari pembuatan aturan notifikasi. Jika Anda memilih Pengembang Amazon Q dalam aplikasi obrolan (Slack), Anda akan melihat tombol yang mengarahkan Anda untuk mengonfigurasi klien di Amazon Q Developer dalam aplikasi obrolan. Memilih opsi itu membuka Pengembang Amazon Q di konsol aplikasi obrolan. Untuk informasi selengkapnya, lihat [Mengonfigurasi Integrasi Antara Pemberitahuan dan Pengembang Amazon Q di aplikasi obrolan](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notifications-chatbot.html).
Jika ingin menggunakan topik Amazon SNS yang ada sebagai target, Anda harus menambahkan kebijakan yang diperlukan untuk AWS CodeStar Pemberitahuan selain kebijakan lain yang mungkin ada untuk topik tersebut. Untuk informasi selengkapnya, lihat [Konfigurasi Topik Amazon SNS untuk Notifikasi ](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/set-up-sns.html) dan [Memahami Konten Notifikasi dan Keamanan](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/security.html#security-notifications). 

1. Untuk menyelesaikan pembuatan aturan, pilih **Kirim**.

1. Anda harus membuat pengguna berlangganan ke topik Amazon SNS untuk aturan tersebut sebelum mereka dapat menerima notifikasi. Untuk informasi selengkapnya, lihat [Buat Pengguna Berlangganan ke Topik Amazon SNS yang Merupakan Target](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/subscribe-users-sns.html). Anda juga dapat mengatur integrasi antara notifikasi dan Pengembang Amazon Q di aplikasi obrolan untuk mengirim pemberitahuan ke ruang obrolan Amazon Chime. Untuk informasi selengkapnya, lihat [Mengkonfigurasi Integrasi Antara Pemberitahuan dan Pengembang Amazon Q di aplikasi obrolan](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notifications-chatbot.html).<a name="notification-rule-create-cli"></a>

# Membuat aturan notifikasi (AWS CLI)
<a name="notification-rule-create-cli"></a>

1. Di terminal atau prompt perintah, jalankan perintah **create-notification rule** untuk menghasilkan kerangka JSON:

   ```
   aws codestar-notifications create-notification-rule --generate-cli-skeleton > rule.json
   ```

   Anda dapat memberi nama file apa pun yang Anda inginkan. Dalam contoh ini, file dinamai *rule.json*.

1. Buka file JSON dalam editor plaintext dan edit untuk memasukkan sumber daya, jenis peristiwa, dan target yang Anda inginkan untuk aturan tersebut. Contoh berikut menunjukkan aturan notifikasi bernama **MyNotificationRule** untuk repositori bernama *MyDemoRepo* dalam AWS acccount dengan ID. *123456789012* Pemberitahuan dengan tipe detail lengkap dikirim ke topik Amazon SNS yang diberi nama *MyNotificationTopic* saat cabang dan tag dibuat:

   ```
   {
       "Name": "MyNotificationRule",
       "EventTypeIds": [
           "codecommit-repository-branches-and-tags-created"
       ],
       "Resource": "arn:aws:codecommit:us-east-1:123456789012:MyDemoRepo",
       "Targets": [
           {
               "TargetType": "SNS",
               "TargetAddress": "arn:aws:sns:us-east-1:123456789012:MyNotificationTopic"
           }
       ],
       "Status": "ENABLED",
       "DetailType": "FULL"
   }
   ```

   Simpan file tersebut.

1. Menggunakan file yang baru saja Anda edit, di terminal atau baris perintah, jalankan **create-notification-rule** perintah lagi untuk membuat aturan notifikasi:

   ```
   aws codestar-notifications create-notification-rule --cli-input-json  file://rule.json
   ```

1. Jika berhasil, perintah tersebut mengembalikan ARN aturan notifikasi, yang serupa dengan berikut ini:

   ```
   {
       "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
   }
   ```