

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

# Mengakses Amazon SNS di AWS CLI
<a name="cli-services-sns"></a>

Anda dapat mengakses fitur Amazon Simple Notification Service (Amazon SNS) menggunakan AWS Command Line Interface ().AWS CLI Untuk membuat daftar AWS CLI perintah untuk Amazon SNS, gunakan perintah berikut.

```
aws sns help
```

Sebelum Anda menjalankan perintah apa pun, atur kredensi default Anda. Untuk informasi selengkapnya, lihat [Mengkonfigurasi pengaturan untuk AWS CLI](cli-chap-configure.md).

Topik ini menunjukkan contoh AWS CLI perintah yang melakukan tugas umum untuk Amazon SNS.

**Topics**
+ [Buat topik](#cli-create-sns-topic)
+ [Berlangganan topik](#cli-subscribe-sns-topic)
+ [Publikasikan ke topik](#cli-publish-sns-topic)
+ [Berhenti berlangganan dari suatu topik](#cli-unsubscribe-sns-topic)
+ [Hapus topik](#cli-delete-sns-topic)

## Buat topik
<a name="cli-create-sns-topic"></a>

Untuk membuat topik, gunakan perintah dan tentukan nama yang akan ditetapkan ke topik.

```
$ aws sns create-topic --name my-topic
{
    "TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic"
}
```

Catat respons`TopicArn`, yang Anda gunakan nanti untuk mempublikasikan pesan.

## Berlangganan topik
<a name="cli-subscribe-sns-topic"></a>

Untuk berlangganan topik, gunakan perintah. 

Contoh berikut menentukan `email` protokol dan alamat email untuk. `notification-endpoint`

```
$ aws sns subscribe --topic-arn arn:aws:sns:us-west-2:123456789012:my-topic --protocol email --notification-endpoint saanvi@example.com
{
    "SubscriptionArn": "pending confirmation"
}
```

AWS segera mengirim pesan konfirmasi melalui email ke alamat yang Anda tentukan dalam `subscribe` perintah. Pesan email memiliki teks berikut.

```
You have chosen to subscribe to the topic:
arn:aws:sns:us-west-2:123456789012:my-topic
To confirm this subscription, click or visit the following link (If this was in error no action is necessary):
Confirm subscription
```

Setelah penerima mengklik tautan **Konfirmasi langganan**, browser penerima menampilkan pesan notifikasi dengan informasi yang mirip dengan yang berikut ini.

```
Subscription confirmed!

You have subscribed saanvi@example.com to the topic:my-topic.

Your subscription's id is:
arn:aws:sns:us-west-2:123456789012:my-topic:1328f057-de93-4c15-512e-8bb22EXAMPLE

If it was not your intention to subscribe, click here to unsubscribe.
```

## Publikasikan ke topik
<a name="cli-publish-sns-topic"></a>

Untuk mengirim pesan ke semua pelanggan suatu topik, gunakan perintah. 

Contoh berikut mengirimkan pesan “Hello World\$1” untuk semua pelanggan dari topik yang ditentukan.

```
$ aws sns publish --topic-arn arn:aws:sns:us-west-2:123456789012:my-topic --message "Hello World!"
{
    "MessageId": "4e41661d-5eec-5ddf-8dab-2c867EXAMPLE"
}
```

Dalam contoh ini, AWS kirim pesan email dengan teks “Hello World\$1” ke`saanvi@example.com`.

## Berhenti berlangganan dari suatu topik
<a name="cli-unsubscribe-sns-topic"></a>

Untuk berhenti berlangganan dari topik dan berhenti menerima pesan yang dipublikasikan ke topik itu, gunakan perintah dan tentukan ARN dari topik yang ingin Anda hentikan berlangganan.

```
$ aws sns unsubscribe --subscription-arn arn:aws:sns:us-west-2:123456789012:my-topic:1328f057-de93-4c15-512e-8bb22EXAMPLE
```

Untuk memverifikasi bahwa Anda berhasil berhenti berlangganan, gunakan perintah untuk mengonfirmasi bahwa ARN tidak lagi muncul dalam daftar.

```
$ aws sns list-subscriptions
```

## Hapus topik
<a name="cli-delete-sns-topic"></a>

Untuk menghapus topik, jalankan perintah.

```
$ aws sns delete-topic --topic-arn arn:aws:sns:us-west-2:123456789012:my-topic
```

Untuk memverifikasi bahwa topik AWS berhasil dihapus, gunakan perintah untuk mengonfirmasi bahwa topik tidak lagi muncul dalam daftar.

```
$ aws sns list-topics
```