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 SNS
<a name="working-with-appconfig-extensions-about-predefined-notification-sns"></a>

`AWS AppConfig deployment events to Amazon SNS`Ekstensi adalah ekstensi yang AWS ditulis yang membantu Anda memantau dan bertindak pada alur kerja penerapan AWS AppConfig konfigurasi. Ekstensi menerbitkan pesan ke topik Amazon SNS setiap kali konfigurasi diterapkan. Setelah Anda mengaitkan ekstensi ke salah satu AWS AppConfig aplikasi, lingkungan, atau profil konfigurasi, AWS AppConfig memublikasikan pesan ke topik setelah setiap penerapan konfigurasi dimulai, diakhiri, dan rollback.

Jika ingin lebih mengontrol titik tindakan mana yang mengirim notifikasi Amazon SNS, Anda dapat membuat ekstensi khusus dan memasukkan topik Amazon SNS 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-sns-using"></a>

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

**Langkah 1: Konfigurasikan AWS AppConfig untuk mempublikasikan pesan ke topik**  
Tambahkan kebijakan kontrol akses ke topik Amazon SNS Anda yang memberikan () izin publikasi AWS AppConfig (`appconfig.amazonaws.com`). `sns:Publish` Untuk informasi selengkapnya, lihat [Contoh kasus untuk kontrol akses Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-access-policy-use-cases.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 Anda membuat asosiasi, Anda harus memasukkan nilai untuk `topicArn` parameter yang berisi ARN topik Amazon SNS yang ingin Anda gunakan.

Setelah Anda membuat asosiasi, ketika konfigurasi untuk AWS AppConfig sumber daya yang ditentukan diterapkan, AWS AppConfig memanggil ekstensi dan mengirim 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 topik Amazon SNS saat ekstensi dipanggil.

```
{
    "Type": "Notification",
    "MessageId": "ae9d702f-9a66-51b3-8586-2b17932a9f28",
    "TopicArn": "arn:aws:sns:us-east-1:111122223333:MySNSTopic",
    "Message": {
        "InvocationId": "7itcaxp",
        "Parameters": {
            "topicArn": "arn:aws:sns:us-east-1:111122223333:MySNSTopic"
        },
        "Application": {
            "Id": "1a2b3c4d",
            "Name": MyApp
        },
        "Environment": {
            "Id": "1a2b3c4d",
            "Name": MyEnv
        },
        "ConfigurationProfile": {
            "Id": "1a2b3c4d",
            "Name": "MyConfigProfile"
        },
        "Description": null,
        "DeploymentNumber": "3",
        "ConfigurationVersion": "1",
        "Type": "OnDeploymentComplete"
    },
    "Timestamp": "2022-06-30T20:26:52.067Z",
    "SignatureVersion": "1",
    "Signature": "<...>",
    "SigningCertURL": "<...>",
    "UnsubscribeURL": "<...>",
    "MessageAttributes": {
        "MessageType": {
            "Type": "String",
            "Value": "OnDeploymentStart"
        }
    }
}
```