

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

# Menggunakan peristiwa AWS AppConfig penerapan ke ekstensi Amazon SQS
<a name="working-with-appconfig-extensions-about-predefined-notification-sqs"></a>

`AWS AppConfig deployment events to Amazon SQS`Ekstensi adalah ekstensi yang AWS ditulis yang membantu Anda memantau dan bertindak pada alur kerja penerapan AWS AppConfig konfigurasi. Ekstensi mengantrekan pesan ke antrean Amazon Simple Queue Service (Amazon SQS) Anda setiap kali konfigurasi diterapkan. Setelah Anda mengaitkan ekstensi ke salah satu AWS AppConfig aplikasi, lingkungan, atau profil konfigurasi, masukkan pesan ke dalam AWS AppConfig antrian setelah setiap penerapan konfigurasi dimulai, diakhiri, dan rollback.

Jika ingin lebih mengontrol titik tindakan mana yang mengirim notifikasi Amazon SQS, Anda dapat membuat ekstensi khusus dan memasukkan antrean Amazon SQS Nama Sumber Daya Amazon (ARN) untuk bidang URI. Untuk informasi tentang membuat ekstensi, lihat[Walkthrough: Membuat ekstensi khusus AWS AppConfig](working-with-appconfig-extensions-creating-custom.md).

## Menggunakan ekstensi
<a name="working-with-appconfig-extensions-about-predefined-notification-sqs-using"></a>

Bagian ini menjelaskan cara menggunakan `AWS AppConfig deployment events to Amazon SQS` ekstensi.

**Langkah 1: Konfigurasikan AWS AppConfig untuk mengantrekan pesan**  
Tambahkan kebijakan Amazon SQS ke antrean Amazon SQS Anda yang memberikan () AWS AppConfig izin kirim pesan `appconfig.amazonaws.com` (). `sqs:SendMessage` Untuk informasi selengkapnya, lihat [Contoh dasar kebijakan Amazon SQS.](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-basic-examples-of-sqs-policies.html)

**Langkah 2: Buat asosiasi ekstensi**  
Lampirkan ekstensi ke salah satu AWS AppConfig sumber daya Anda dengan membuat asosiasi ekstensi. Anda membuat asosiasi menggunakan AWS AppConfig konsol atau aksi [CreateExtensionAssociation](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateExtensionAssociation.html)API. Saat Anda membuat asosiasi, Anda menentukan ARN AWS AppConfig aplikasi, lingkungan, atau profil konfigurasi. Jika Anda mengaitkan ekstensi ke aplikasi atau lingkungan, pemberitahuan dikirim untuk profil konfigurasi apa pun yang terdapat dalam aplikasi atau lingkungan yang ditentukan. Saat membuat asosiasi, Anda harus memasukkan `Here` parameter yang berisi ARN antrian Amazon SQS yang ingin Anda gunakan.

Setelah Anda membuat asosiasi, ketika konfigurasi untuk AWS AppConfig sumber daya tertentu dibuat atau diterapkan, AWS AppConfig memanggil ekstensi dan mengirimkan pemberitahuan sesuai dengan titik tindakan yang ditentukan dalam ekstensi.

**catatan**  
Ekstensi ini dipanggil oleh poin tindakan berikut:  
`ON_DEPLOYMENT_START`
`ON_DEPLOYMENT_COMPLETE`
`ON_DEPLOYMENT_ROLLED_BACK`
Anda tidak dapat menyesuaikan titik tindakan untuk ekstensi ini. Untuk memanggil titik tindakan yang berbeda, Anda dapat membuat ekstensi Anda sendiri. Untuk informasi selengkapnya, lihat [Walkthrough: Membuat ekstensi khusus AWS AppConfig](working-with-appconfig-extensions-creating-custom.md).

Gunakan prosedur berikut untuk membuat asosiasi AWS AppConfig ekstensi dengan menggunakan AWS Systems Manager konsol atau AWS CLI.

**Untuk membuat asosiasi ekstensi (konsol)**

1. Buka AWS Systems Manager konsol di [https://console.aws.amazon.com/systems-manager/appconfig/](https://console.aws.amazon.com/systems-manager/appconfig/).

1. Di panel navigasi, pilih **AWS AppConfig**.

1. Pada tab **Ekstensi**, pilih **Tambahkan ke sumber daya**.

1. Di bagian **Detail sumber daya ekstensi**, untuk **jenis sumber daya**, pilih jenis AWS AppConfig sumber daya. Bergantung pada sumber daya yang Anda pilih, AWS AppConfig meminta Anda untuk memilih sumber daya lain.

1. Pilih **Buat asosiasi ke sumber daya**.

Berikut adalah contoh pesan yang dikirim ke antrean Amazon SQS saat ekstensi dipanggil.

```
{
   "InvocationId":"7itcaxp",
   "Parameters":{
      "queueArn":"arn:aws:sqs:us-east-1:111122223333:MySQSQueue"
   },
   "Application":{
      "Id":"1a2b3c4d",
      "Name":MyApp
   },
   "Environment":{
      "Id":"1a2b3c4d",
      "Name":MyEnv
   },
   "ConfigurationProfile":{
      "Id":"1a2b3c4d",
      "Name":"MyConfigProfile"
   },
   "Description":null,
   "DeploymentNumber":"3",
   "ConfigurationVersion":"1",
   "Type":"OnDeploymentComplete"
}
```