Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Membuat aturan notifikasi
Anda dapat menggunakan konsol Alat Pengembang atau AWS CLI untuk membuat aturan pemberitahuan. Anda dapat membuat untuk membuat topik Amazon SNS untuk digunakan sebagai target sebagai bagian dari pembuatan aturan. Jika Anda ingin menggunakan klien AWS Chatbot sebagai target, Anda harus membuat klien itu sebelum Anda dapat membuat aturan. Untuk informasi selengkapnya, lihat [Konfigurasikan klien AWS Chatbot untuk saluran Slack](notifications-chatbot.md#notifications-chatbot-configure-client).
# Untuk membuat aturan notifikasi (konsol)
1. Buka konsol Alat AWS Pengembang di [https://console.aws.amazon.com/codesuite/pengaturan/pemberitahuan](https://console.aws.amazon.com/codesuite/settings/notifications/).
1. Gunakan bilah navigasi untuk menavigasi ke sumber daya.
+ Untuk CodeBuild, pilih **Build**, pilih **Build projects**, dan pilih build project.
+ Untuk CodeCommit, pilih **Sumber**, pilih **Repositori, dan pilih repositori**.
+ Untuk CodeDeploy, pilih **Aplikasi**, dan pilih aplikasi.
+ Untuk CodePipeline, pilih **Pipeline**, pilih **Pipelines**, dan pilih pipeline.
1. Pada halaman sumber daya, pilih **Beri tahu**, lalu pilih **Buat aturan notifikasi**. Anda juga dapat masuk ke halaman **Pengaturan** untuk sumber daya, masuk ke **Notifikasi** atau **Aturan notifikasi**, lalu pilih **Membuat 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 disediakan oleh layanan sumber daya atau pengelola notifikasi.
Untuk informasi selengkapnya, lihat [Memahami konten dan keamanan notifikasi](security.md#security-notifications).
1. Di **Peristiwa yang memicu notifikasi**, pilih peristiwa yang ingin Anda kirimkan notifikasi. Untuk jenis peristiwa untuk sumber daya, lihat berikut ini:
+ CodeBuild: [Acara untuk aturan notifikasi tentang proyek build](concepts.md#events-ref-buildproject)
+ CodeCommit: [Peristiwa untuk aturan notifikasi pada repositori](concepts.md#events-ref-repositories)
+ CodeDeploy: [Peristiwa untuk aturan notifikasi pada aplikasi deployment](concepts.md#events-ref-deployapplication)
+ CodePipeline: [Acara untuk aturan notifikasi pada alur](concepts.md#events-ref-pipeline)
1. Di **Target**, lakukan salah satu langkah berikut:
+ **Jika Anda telah mengonfigurasi sumber daya untuk digunakan dengan notifikasi, di **Pilih jenis target**, pilih **AWS Chatbot (Slack), Chatbot AWS (****Microsoft Teams)**, atau topik SNS.** Di **Pilih target**, pilih nama klien (untuk klien Slack atau Microsoft Teams yang dikonfigurasi di AWS Chatbot) 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 klien AWS Chatbot sebagai bagian dari pembuatan aturan notifikasi. Jika Anda memilih AWS Chatbot (Slack) atau Chatbot AWS (Microsoft Teams), Anda akan melihat tombol yang mengarahkan Anda untuk mengonfigurasi klien di Chatbot. AWS Memilih opsi itu membuka konsol AWS Chatbot. Untuk informasi selengkapnya, lihat [Konfigurasikan klien AWS Chatbot untuk saluran Slack](notifications-chatbot.md#notifications-chatbot-configure-client).
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 [Mengonfigurasi topik Amazon SNS untuk notifikasi](set-up-sns.md) dan [Memahami konten dan keamanan notifikasi](security.md#security-notifications).
1. Pilih **Kirim**, dan kemudian tinjau aturan notifikasi.
**catatan**
Pengguna harus berlangganan dan mengonfirmasi langganan ke topik Amazon SNS yang Anda tentukan sebagai target aturan sebelum mereka akan menerima notifikasi. Untuk informasi lebih lanjut, lihat [Untuk berlangganan pengguna ke topik Amazon SNS yang digunakan untuk notifikasi](subscribe-users-sns.md#set-up-sns-subscribe).
# Membuat aturan notifikasi (AWS CLI)
1. Di terminal atau permintaan 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 Amazon SNS yang Anda inginkan untuk aturan.
Contoh berikut menunjukkan aturan notifikasi bernama **MyNotificationRule** untuk repositori bernama *MyDemoRepo* dalam AWS akun 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 perintah **create-notification-rule** kembali untuk membuat aturan notifikasi.
```
aws codestar-notifications create-notification-rule --cli-input-json file://rule.json
```
1. Jika berhasil, perintah mengembalikan ARN aturan notifikasi, mirip dengan berikut ini.
```
{
"Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
}
```
# Untuk mencantumkan jenis peristiwa untuk aturan notifikasi (AWS CLI)
1. Di terminal atau permintaan perintah, jalankan perintah **list-event-types**. Anda dapat menggunakan pilihan `--filters` untuk membatasi respons ke jenis sumber daya tertentu atau atribut lainnya. Misalnya, berikut ini mengembalikan daftar jenis acara untuk CodeDeploy aplikasi.
```
aws codestar-notifications list-event-types --filters Name=SERVICE_NAME,Value=CodeDeploy
```
1. Perintah ini menghasilkan output seperti berikut.
```
{
"EventTypes": [
{
"EventTypeId": "codedeploy-application-deployment-succeeded",
"ServiceName": "CodeDeploy",
"EventTypeName": "Deployment: Succeeded",
"ResourceType": "Application"
},
{
"EventTypeId": "codedeploy-application-deployment-failed",
"ServiceName": "CodeDeploy",
"EventTypeName": "Deployment: Failed",
"ResourceType": "Application"
},
{
"EventTypeId": "codedeploy-application-deployment-started",
"ServiceName": "CodeDeploy",
"EventTypeName": "Deployment: Started",
"ResourceType": "Application"
}
]
}
```
# Untuk menambahkan tanda ke aturan notifikasi (AWS CLI)
1. Di terminal atau permintaan perintah, jalankan perintah **tag-resource**. Misalnya, gunakan perintah berikut untuk menambahkan pasangan nilai kunci tag yang memiliki nama *Team* dan nilainya. *Li\$1Juan*
```
aws codestar-notifications tag-resource --arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/fe1efd35-EXAMPLE --tags Team=Li_Juan
```
1. Perintah ini menghasilkan output seperti berikut.
```
{
"Tags": {
"Team": "Li_Juan"
}
}
```