AWS SDK untuk JavaScript V2 telah mencapai end-of-support. Kami menyarankan Anda bermigrasi ke [AWS SDK untuk JavaScript v3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/). Untuk detail dan informasi tambahan tentang cara bermigrasi, silakan lihat [pengumuman](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/) ini.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Contoh Layanan Pemberitahuan Sederhana Amazon
Amazon Simple Notification Service (Amazon SNS) adalah layanan web yang mengoordinasikan dan mengelola pengiriman atau pengiriman pesan untuk berlangganan titik akhir atau klien.
Di Amazon SNS, ada dua jenis klien—penerbit dan pelanggan—juga disebut sebagai produsen dan konsumen.
![\[Hubungan antara JavaScript lingkungan, SDK, dan Amazon SNS\]](http://docs.aws.amazon.com/id_id/sdk-for-javascript/v2/developer-guide/images/code-samples-sns.png)
Penerbit berkomunikasi secara asinkron dengan pelanggan dengan memproduksi dan mengirim pesan ke suatu topik, yang merupakan jalur akses logis dan saluran komunikasi. Pelanggan (server web, alamat email, antrian Amazon SQS, fungsi Lambda) mengkonsumsi atau menerima pesan atau pemberitahuan melalui salah satu protokol yang didukung (Amazon SQS, HTTP/S, email, SMS,) ketika mereka berlangganan topik. AWS Lambda
JavaScript API untuk Amazon SNS diekspos melalui file. [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html)
**Topics**
+ [Mengelola Topik di Amazon SNS](sns-examples-managing-topics.md)
+ [Menerbitkan Pesan di Amazon SNS](sns-examples-publishing-messages.md)
+ [Mengelola Langganan di Amazon SNS](sns-examples-subscribing-unubscribing-topics.md)
+ [Mengirim Pesan SMS dengan Amazon SNS](sns-examples-sending-sms.md)
# Mengelola Topik di Amazon SNS
![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/id_id/sdk-for-javascript/v2/developer-guide/images/nodeicon.png)
**Contoh kode Node.js ini menunjukkan:**
+ Cara membuat topik di Amazon SNS tempat Anda dapat mempublikasikan notifikasi.
+ Cara menghapus topik yang dibuat di Amazon SNS.
+ Cara mendapatkan daftar topik yang tersedia.
+ Cara mendapatkan dan mengatur atribut topik.
## Skenario
Dalam contoh ini, Anda menggunakan serangkaian modul Node.js untuk membuat, membuat daftar, dan menghapus topik Amazon SNS, dan untuk menangani atribut topik. Modul Node.js menggunakan SDK JavaScript untuk mengelola topik menggunakan metode kelas `AWS.SNS` klien berikut:
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#createTopic-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#createTopic-property)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#listTopics-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#listTopics-property)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#deleteTopic-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#deleteTopic-property)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#getTopicAttributes-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#getTopicAttributes-property)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#setTopicAttributes-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#setTopicAttributes-property)
## Tugas Prasyarat
Untuk mengatur dan menjalankan contoh ini, Anda harus terlebih dahulu menyelesaikan tugas-tugas ini:
+ Instal Node.js. Untuk informasi selengkapnya tentang menginstal Node.js, lihat [situs web Node.js](http://nodejs.org).
+ Buat file konfigurasi bersama dengan kredensi pengguna Anda. Untuk informasi selengkapnya tentang menyediakan file JSON kredensial, lihat. [Memuat Kredensial di Node.js dari File Kredensial Bersama](loading-node-credentials-shared.md)
## Membuat Topik
Dalam contoh ini, gunakan modul Node.js untuk membuat topik Amazon SNS. Buat modul Node.js dengan nama file`sns_createtopic.js`. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya.
Buat objek untuk meneruskan topik baru ke `createTopic` metode kelas `AWS.SNS` klien. `Name` Untuk memanggil `createTopic` metode ini, buat janji untuk memanggil objek layanan Amazon SNS, melewati objek parameter. Kemudian tangani callback `response` in the promise. Yang `data` dikembalikan oleh janji berisi ARN topik.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });
// Create promise and SNS service object
var createTopicPromise = new AWS.SNS({ apiVersion: "2010-03-31" })
.createTopic({ Name: "TOPIC_NAME" })
.promise();
// Handle promise's fulfilled/rejected states
createTopicPromise
.then(function (data) {
console.log("Topic ARN is " + data.TopicArn);
})
.catch(function (err) {
console.error(err, err.stack);
});
```
Untuk menjalankan contoh, ketik berikut ini di baris perintah.
```
node sns_createtopic.js
```
Kode contoh ini dapat ditemukan [di sini GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_createtopic.js).
## Daftar Topik Anda
Dalam contoh ini, gunakan modul Node.js untuk mencantumkan semua topik Amazon SNS. Buat modul Node.js dengan nama file`sns_listtopics.js`. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya.
Buat objek kosong untuk diteruskan ke `listTopics` metode kelas `AWS.SNS` klien. Untuk memanggil `listTopics` metode ini, buat janji untuk memanggil objek layanan Amazon SNS, melewati objek parameter. Kemudian tangani callback `response` in the promise. Yang `data` dikembalikan oleh janji berisi berbagai topik Anda ARNs.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });
// Create promise and SNS service object
var listTopicsPromise = new AWS.SNS({ apiVersion: "2010-03-31" })
.listTopics({})
.promise();
// Handle promise's fulfilled/rejected states
listTopicsPromise
.then(function (data) {
console.log(data.Topics);
})
.catch(function (err) {
console.error(err, err.stack);
});
```
Untuk menjalankan contoh, ketik berikut ini di baris perintah.
```
node sns_listtopics.js
```
Kode contoh ini dapat ditemukan [di sini GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_listtopics.js).
## Menghapus Topik
Dalam contoh ini, gunakan modul Node.js untuk menghapus topik Amazon SNS. Buat modul Node.js dengan nama file`sns_deletetopic.js`. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya.
Buat objek yang `TopicArn` berisi topik yang akan dihapus untuk diteruskan ke `deleteTopic` metode kelas `AWS.SNS` klien. Untuk memanggil `deleteTopic` metode ini, buat janji untuk memanggil objek layanan Amazon SNS, melewati objek parameter. Kemudian tangani callback `response` in the promise.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });
// Create promise and SNS service object
var deleteTopicPromise = new AWS.SNS({ apiVersion: "2010-03-31" })
.deleteTopic({ TopicArn: "TOPIC_ARN" })
.promise();
// Handle promise's fulfilled/rejected states
deleteTopicPromise
.then(function (data) {
console.log("Topic Deleted");
})
.catch(function (err) {
console.error(err, err.stack);
});
```
Untuk menjalankan contoh, ketik berikut ini di baris perintah.
```
node sns_deletetopic.js
```
Kode contoh ini dapat ditemukan [di sini GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_deletetopic.js).
## Mendapatkan Atribut Topik
Dalam contoh ini, gunakan modul Node.js untuk mengambil atribut topik Amazon SNS. Buat modul Node.js dengan nama file`sns_gettopicattributes.js`. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya.
Buat objek yang `TopicArn` berisi topik yang akan dihapus untuk diteruskan ke `getTopicAttributes` metode kelas `AWS.SNS` klien. Untuk memanggil `getTopicAttributes` metode ini, buat janji untuk memanggil objek layanan Amazon SNS, melewati objek parameter. Kemudian tangani callback `response` in the promise.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });
// Create promise and SNS service object
var getTopicAttribsPromise = new AWS.SNS({ apiVersion: "2010-03-31" })
.getTopicAttributes({ TopicArn: "TOPIC_ARN" })
.promise();
// Handle promise's fulfilled/rejected states
getTopicAttribsPromise
.then(function (data) {
console.log(data);
})
.catch(function (err) {
console.error(err, err.stack);
});
```
Untuk menjalankan contoh, ketik berikut ini di baris perintah.
```
node sns_gettopicattributes.js
```
Kode contoh ini dapat ditemukan [di sini GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_gettopicattributes.js).
## Pengaturan Atribut Topik
Dalam contoh ini, gunakan modul Node.js untuk menyetel atribut yang dapat berubah dari topik Amazon SNS. Buat modul Node.js dengan nama file`sns_settopicattributes.js`. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya.
Buat objek yang berisi parameter untuk pembaruan atribut, termasuk topik yang atributnya ingin Anda tetapkan, nama atribut yang akan ditetapkan, dan nilai baru untuk atribut tersebut. `TopicArn` Anda hanya dapat mengatur`Policy`,`DisplayName`, dan `DeliveryPolicy` atribut. Lewati parameter ke `setTopicAttributes` metode kelas `AWS.SNS` klien. Untuk memanggil `setTopicAttributes` metode ini, buat janji untuk memanggil objek layanan Amazon SNS, melewati objek parameter. Kemudian tangani callback `response` in the promise.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });
// Create setTopicAttributes parameters
var params = {
AttributeName: "ATTRIBUTE_NAME" /* required */,
TopicArn: "TOPIC_ARN" /* required */,
AttributeValue: "NEW_ATTRIBUTE_VALUE",
};
// Create promise and SNS service object
var setTopicAttribsPromise = new AWS.SNS({ apiVersion: "2010-03-31" })
.setTopicAttributes(params)
.promise();
// Handle promise's fulfilled/rejected states
setTopicAttribsPromise
.then(function (data) {
console.log(data);
})
.catch(function (err) {
console.error(err, err.stack);
});
```
Untuk menjalankan contoh, ketik berikut ini di baris perintah.
```
node sns_settopicattributes.js
```
Kode contoh ini dapat ditemukan [di sini GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_settopicattributes.js).
# Menerbitkan Pesan di Amazon SNS
![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/id_id/sdk-for-javascript/v2/developer-guide/images/nodeicon.png)
**Contoh kode Node.js ini menunjukkan:**
+ Cara mempublikasikan pesan ke topik Amazon SNS.
## Skenario
Dalam contoh ini, Anda menggunakan serangkaian modul Node.js untuk mempublikasikan pesan dari Amazon SNS ke titik akhir topik, email, atau nomor telepon. Modul Node.js menggunakan SDK JavaScript untuk mengirim pesan menggunakan metode kelas `AWS.SNS` klien ini:
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#publish-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#publish-property)
## Tugas Prasyarat
Untuk mengatur dan menjalankan contoh ini, Anda harus terlebih dahulu menyelesaikan tugas-tugas ini:
+ Instal Node.js. Untuk informasi selengkapnya tentang menginstal Node.js, lihat [situs web Node.js](http://nodejs.org).
+ Buat file konfigurasi bersama dengan kredensi pengguna Anda. Untuk informasi selengkapnya tentang menyediakan file JSON kredensial, lihat. [Memuat Kredensial di Node.js dari File Kredensial Bersama](loading-node-credentials-shared.md)
## Menerbitkan Pesan ke Topik Amazon SNS
Dalam contoh ini, gunakan modul Node.js untuk mempublikasikan pesan ke topik Amazon SNS. Buat modul Node.js dengan nama file`sns_publishtotopic.js`. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya.
Buat objek yang berisi parameter untuk menerbitkan pesan, termasuk teks pesan dan ARN dari topik Amazon SNS. Untuk detail tentang atribut SMS yang tersedia, lihat [Mengatur SMSAttributes](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#setSMSAttributes-property).
Lewati parameter ke `publish` metode kelas `AWS.SNS` klien. Buat janji untuk memanggil objek layanan Amazon SNS, melewati objek parameter. Kemudian tangani respons dalam panggilan balik janji.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });
// Create publish parameters
var params = {
Message: "MESSAGE_TEXT" /* required */,
TopicArn: "TOPIC_ARN",
};
// Create promise and SNS service object
var publishTextPromise = new AWS.SNS({ apiVersion: "2010-03-31" })
.publish(params)
.promise();
// Handle promise's fulfilled/rejected states
publishTextPromise
.then(function (data) {
console.log(
`Message ${params.Message} sent to the topic ${params.TopicArn}`
);
console.log("MessageID is " + data.MessageId);
})
.catch(function (err) {
console.error(err, err.stack);
});
```
Untuk menjalankan contoh, ketik berikut ini di baris perintah.
```
node sns_publishtotopic.js
```
Kode contoh ini dapat ditemukan [di sini GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_publishtotopic.js).
# Mengelola Langganan di Amazon SNS
![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/id_id/sdk-for-javascript/v2/developer-guide/images/nodeicon.png)
**Contoh kode Node.js ini menunjukkan:**
+ Cara membuat daftar semua langganan ke topik Amazon SNS.
+ Cara berlangganan alamat email, titik akhir aplikasi, atau AWS Lambda fungsi ke topik Amazon SNS.
+ Cara berhenti berlangganan dari topik Amazon SNS.
## Skenario
Dalam contoh ini, Anda menggunakan serangkaian modul Node.js untuk mempublikasikan pesan notifikasi ke topik Amazon SNS. Modul Node.js menggunakan SDK JavaScript untuk mengelola topik menggunakan metode kelas `AWS.SNS` klien berikut:
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#subscribe-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#subscribe-property)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#confirmSubscription-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#confirmSubscription-property)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#listSubscriptionsByTopic-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#listSubscriptionsByTopic-property)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#unsubscribe-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#unsubscribe-property)
## Tugas Prasyarat
Untuk mengatur dan menjalankan contoh ini, Anda harus terlebih dahulu menyelesaikan tugas-tugas ini:
+ Instal Node.js. Untuk informasi selengkapnya tentang menginstal Node.js, lihat [situs web Node.js](http://nodejs.org).
+ Buat file konfigurasi bersama dengan kredensi pengguna Anda. Untuk informasi selengkapnya tentang menyediakan file JSON kredensial, lihat. [Memuat Kredensial di Node.js dari File Kredensial Bersama](loading-node-credentials-shared.md)
## Daftar Langganan ke Topik
Dalam contoh ini, gunakan modul Node.js untuk mencantumkan semua langganan ke topik Amazon SNS. Buat modul Node.js dengan nama file`sns_listsubscriptions.js`. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya.
Buat objek yang berisi `TopicArn` parameter untuk topik yang langganannya ingin Anda daftarkan. Lewati parameter ke `listSubscriptionsByTopic` metode kelas `AWS.SNS` klien. Untuk memanggil `listSubscriptionsByTopic` metode ini, buat janji untuk memanggil objek layanan Amazon SNS, melewati objek parameter. Kemudian tangani callback `response` in the promise.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });
const params = {
TopicArn: "TOPIC_ARN",
};
// Create promise and SNS service object
var subslistPromise = new AWS.SNS({ apiVersion: "2010-03-31" })
.listSubscriptionsByTopic(params)
.promise();
// Handle promise's fulfilled/rejected states
subslistPromise
.then(function (data) {
console.log(data);
})
.catch(function (err) {
console.error(err, err.stack);
});
```
Untuk menjalankan contoh, ketik berikut ini di baris perintah.
```
node sns_listsubscriptions.js
```
Kode contoh ini dapat ditemukan [di sini GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_listsubscriptions.js).
## Berlangganan Alamat Email ke Topik
Dalam contoh ini, gunakan modul Node.js untuk berlangganan alamat email sehingga menerima pesan email SMTP dari topik Amazon SNS. Buat modul Node.js dengan nama file`sns_subscribeemail.js`. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya.
Buat objek yang berisi `Protocol` parameter untuk menentukan `email` protokol, topik `TopicArn` untuk berlangganan, dan alamat email sebagai pesan`Endpoint`. Lewati parameter ke `subscribe` metode kelas `AWS.SNS` klien. Anda dapat menggunakan `subscribe` metode ini untuk berlangganan beberapa titik akhir yang berbeda ke topik Amazon SNS, tergantung pada nilai yang digunakan untuk parameter yang diteruskan, seperti contoh lain dalam topik ini akan ditampilkan.
Untuk memanggil `subscribe` metode ini, buat janji untuk memanggil objek layanan Amazon SNS, melewati objek parameter. Kemudian tangani callback `response` in the promise.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });
// Create subscribe/email parameters
var params = {
Protocol: "EMAIL" /* required */,
TopicArn: "TOPIC_ARN" /* required */,
Endpoint: "EMAIL_ADDRESS",
};
// Create promise and SNS service object
var subscribePromise = new AWS.SNS({ apiVersion: "2010-03-31" })
.subscribe(params)
.promise();
// Handle promise's fulfilled/rejected states
subscribePromise
.then(function (data) {
console.log("Subscription ARN is " + data.SubscriptionArn);
})
.catch(function (err) {
console.error(err, err.stack);
});
```
Untuk menjalankan contoh, ketik berikut ini di baris perintah.
```
node sns_subscribeemail.js
```
Kode contoh ini dapat ditemukan [di sini GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_subscribeemail.js).
## Berlangganan Endpoint Aplikasi ke Topik
Dalam contoh ini, gunakan modul Node.js untuk berlangganan titik akhir aplikasi seluler sehingga menerima pemberitahuan dari topik Amazon SNS. Buat modul Node.js dengan nama file`sns_subscribeapp.js`. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya.
Buat objek yang berisi `Protocol` parameter untuk menentukan `application` protokol, topik `TopicArn` untuk berlangganan, dan ARN dari titik akhir aplikasi seluler untuk parameter tersebut. `Endpoint` Lewati parameter ke `subscribe` metode kelas `AWS.SNS` klien.
Untuk memanggil `subscribe` metode ini, buat janji untuk memanggil objek layanan Amazon SNS, melewati objek parameter. Kemudian tangani callback `response` in the promise.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });
// Create subscribe/email parameters
var params = {
Protocol: "application" /* required */,
TopicArn: "TOPIC_ARN" /* required */,
Endpoint: "MOBILE_ENDPOINT_ARN",
};
// Create promise and SNS service object
var subscribePromise = new AWS.SNS({ apiVersion: "2010-03-31" })
.subscribe(params)
.promise();
// Handle promise's fulfilled/rejected states
subscribePromise
.then(function (data) {
console.log("Subscription ARN is " + data.SubscriptionArn);
})
.catch(function (err) {
console.error(err, err.stack);
});
```
Untuk menjalankan contoh, ketik berikut ini di baris perintah.
```
node sns_subscribeapp.js
```
Kode contoh ini dapat ditemukan [di sini GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_subscribeapp.js).
## Berlangganan Fungsi Lambda ke Topik
Dalam contoh ini, gunakan modul Node.js untuk berlangganan suatu AWS Lambda fungsi sehingga menerima pemberitahuan dari topik Amazon SNS. Buat modul Node.js dengan nama file`sns_subscribelambda.js`. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya.
Buat objek yang berisi `Protocol` parameter, tentukan `lambda` protokol, topik `TopicArn` untuk berlangganan, dan ARN fungsi AWS Lambda sebagai `Endpoint` parameter. Lewati parameter ke `subscribe` metode kelas `AWS.SNS` klien.
Untuk memanggil `subscribe` metode ini, buat janji untuk memanggil objek layanan Amazon SNS, melewati objek parameter. Kemudian tangani callback `response` in the promise.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });
// Create subscribe/email parameters
var params = {
Protocol: "lambda" /* required */,
TopicArn: "TOPIC_ARN" /* required */,
Endpoint: "LAMBDA_FUNCTION_ARN",
};
// Create promise and SNS service object
var subscribePromise = new AWS.SNS({ apiVersion: "2010-03-31" })
.subscribe(params)
.promise();
// Handle promise's fulfilled/rejected states
subscribePromise
.then(function (data) {
console.log("Subscription ARN is " + data.SubscriptionArn);
})
.catch(function (err) {
console.error(err, err.stack);
});
```
Untuk menjalankan contoh, ketik berikut ini di baris perintah.
```
node sns_subscribelambda.js
```
Kode contoh ini dapat ditemukan [di sini GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_subscribelambda.js).
## Berhenti berlangganan dari topik
Dalam contoh ini, gunakan modul Node.js untuk berhenti berlangganan langganan topik Amazon SNS. Buat modul Node.js dengan nama file`sns_unsubscribe.js`. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya.
Buat objek yang berisi `SubscriptionArn` parameter, tentukan ARN langganan untuk berhenti berlangganan. Lewati parameter ke `unsubscribe` metode kelas `AWS.SNS` klien.
Untuk memanggil `unsubscribe` metode ini, buat janji untuk memanggil objek layanan Amazon SNS, melewati objek parameter. Kemudian tangani callback `response` in the promise.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });
// Create promise and SNS service object
var subscribePromise = new AWS.SNS({ apiVersion: "2010-03-31" })
.unsubscribe({ SubscriptionArn: TOPIC_SUBSCRIPTION_ARN })
.promise();
// Handle promise's fulfilled/rejected states
subscribePromise
.then(function (data) {
console.log(data);
})
.catch(function (err) {
console.error(err, err.stack);
});
```
Untuk menjalankan contoh, ketik berikut ini di baris perintah.
```
node sns_unsubscribe.js
```
Kode contoh ini dapat ditemukan [di sini GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_unsubscribe.js).
# Mengirim Pesan SMS dengan Amazon SNS
![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/id_id/sdk-for-javascript/v2/developer-guide/images/nodeicon.png)
**Contoh kode Node.js ini menunjukkan:**
+ Cara mendapatkan dan mengatur preferensi pesan SMS untuk Amazon SNS.
+ Cara memeriksa nomor telepon untuk melihat apakah telah memilih untuk tidak menerima pesan SMS.
+ Cara mendapatkan daftar nomor telepon yang telah memilih untuk tidak menerima pesan SMS.
+ Cara mengirim pesan SMS.
## Skenario
Anda dapat menggunakan Amazon SNS untuk mengirim pesan teks, atau pesan SMS, ke perangkat yang mendukung SMS. Anda dapat mengirim pesan langsung ke sebuah nomor telepon, atau Anda dapat mengirim pesan ke beberapa nomor telepon sekaligus dengan berlangganan topik untuk nomor telepon tersebut dan mengirim pesan Anda ke topik tersebut.
Dalam contoh ini, Anda menggunakan serangkaian modul Node.js untuk mempublikasikan pesan teks SMS dari Amazon SNS ke perangkat berkemampuan SMS. Modul Node.js menggunakan SDK JavaScript untuk mempublikasikan pesan SMS menggunakan metode kelas `AWS.SNS` klien berikut:
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#getSMSAttributes-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#getSMSAttributes-property)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#setSMSAttributes-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#setSMSAttributes-property)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#checkIfPhoneNumberIsOptedOut-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#checkIfPhoneNumberIsOptedOut-property)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#listPhoneNumbersOptedOut-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#listPhoneNumbersOptedOut-property)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#publish-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html#publish-property)
## Tugas Prasyarat
Untuk mengatur dan menjalankan contoh ini, Anda harus terlebih dahulu menyelesaikan tugas-tugas ini:
+ Instal Node.js. Untuk informasi selengkapnya tentang menginstal Node.js, lihat [situs web Node.js](http://nodejs.org).
+ Buat file konfigurasi bersama dengan kredensi pengguna Anda. Untuk informasi selengkapnya tentang menyediakan file JSON kredensial, lihat. [Memuat Kredensial di Node.js dari File Kredensial Bersama](loading-node-credentials-shared.md)
## Mendapatkan Atribut SMS
Gunakan Amazon SNS untuk menentukan preferensi untuk pesan SMS, seperti bagaimana pengiriman Anda dioptimalkan (untuk biaya atau untuk pengiriman yang andal), batas pengeluaran bulanan Anda, cara pengiriman pesan dicatat, dan apakah akan berlangganan laporan penggunaan SMS harian. Preferensi ini diambil dan ditetapkan sebagai atribut SMS untuk Amazon SNS.
Dalam contoh ini, gunakan modul Node.js untuk mendapatkan atribut SMS saat ini di Amazon SNS. Buat modul Node.js dengan nama file`sns_getsmstype.js`. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya. Buat objek yang berisi parameter untuk mendapatkan atribut SMS, termasuk nama-nama atribut individual yang akan didapat. Untuk detail tentang atribut SMS yang tersedia, lihat [Mengatur SMSAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetSMSAttributes.html) Referensi API Layanan Pemberitahuan Sederhana Amazon.
Contoh ini mendapatkan `DefaultSMSType` atribut, yang mengontrol apakah pesan SMS dikirim sebagai`Promotional`, yang mengoptimalkan pengiriman pesan untuk menimbulkan biaya terendah, atau as`Transactional`, yang mengoptimalkan pengiriman pesan untuk mencapai keandalan tertinggi. Lewati parameter ke `setTopicAttributes` metode kelas `AWS.SNS` klien. Untuk memanggil `getSMSAttributes` metode ini, buat janji untuk memanggil objek layanan Amazon SNS, melewati objek parameter. Kemudian tangani callback `response` in the promise.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });
// Create SMS Attribute parameter you want to get
var params = {
attributes: [
"DefaultSMSType",
"ATTRIBUTE_NAME",
/* more items */
],
};
// Create promise and SNS service object
var getSMSTypePromise = new AWS.SNS({ apiVersion: "2010-03-31" })
.getSMSAttributes(params)
.promise();
// Handle promise's fulfilled/rejected states
getSMSTypePromise
.then(function (data) {
console.log(data);
})
.catch(function (err) {
console.error(err, err.stack);
});
```
Untuk menjalankan contoh, ketik berikut ini di baris perintah.
```
node sns_getsmstype.js
```
Kode contoh ini dapat ditemukan [di sini GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_getsmstype.js).
## Mengatur Atribut SMS
Dalam contoh ini, gunakan modul Node.js untuk mendapatkan atribut SMS saat ini di Amazon SNS. Buat modul Node.js dengan nama file`sns_setsmstype.js`. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya. Buat objek yang berisi parameter untuk mengatur atribut SMS, termasuk nama atribut individual yang akan ditetapkan dan nilai yang akan ditetapkan untuk masing-masing. Untuk detail tentang atribut SMS yang tersedia, lihat [Mengatur SMSAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetSMSAttributes.html) Referensi API Layanan Pemberitahuan Sederhana Amazon.
Contoh ini menetapkan `DefaultSMSType` atribut ke`Transactional`, yang mengoptimalkan pengiriman pesan untuk mencapai keandalan tertinggi. Lewati parameter ke `setTopicAttributes` metode kelas `AWS.SNS` klien. Untuk memanggil `getSMSAttributes` metode ini, buat janji untuk memanggil objek layanan Amazon SNS, melewati objek parameter. Kemudian tangani callback `response` in the promise.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });
// Create SMS Attribute parameters
var params = {
attributes: {
/* required */
DefaultSMSType: "Transactional" /* highest reliability */,
//'DefaultSMSType': 'Promotional' /* lowest cost */
},
};
// Create promise and SNS service object
var setSMSTypePromise = new AWS.SNS({ apiVersion: "2010-03-31" })
.setSMSAttributes(params)
.promise();
// Handle promise's fulfilled/rejected states
setSMSTypePromise
.then(function (data) {
console.log(data);
})
.catch(function (err) {
console.error(err, err.stack);
});
```
Untuk menjalankan contoh, ketik berikut ini di baris perintah.
```
node sns_setsmstype.js
```
Kode contoh ini dapat ditemukan [di sini GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_setsmstype.js).
## Memeriksa Apakah Nomor Telepon Telah Memilih Keluar
Dalam contoh ini, gunakan modul Node.js untuk memeriksa nomor telepon untuk melihat apakah telah memilih keluar dari menerima pesan SMS. Buat modul Node.js dengan nama file`sns_checkphoneoptout.js`. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya. Buat objek yang berisi nomor telepon untuk diperiksa sebagai parameter.
Contoh ini menetapkan `PhoneNumber` parameter untuk menentukan nomor telepon yang akan diperiksa. Lewati objek ke `checkIfPhoneNumberIsOptedOut` metode kelas `AWS.SNS` klien. Untuk memanggil `checkIfPhoneNumberIsOptedOut` metode ini, buat janji untuk memanggil objek layanan Amazon SNS, melewati objek parameter. Kemudian tangani callback `response` in the promise.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });
// Create promise and SNS service object
var phonenumPromise = new AWS.SNS({ apiVersion: "2010-03-31" })
.checkIfPhoneNumberIsOptedOut({ phoneNumber: "PHONE_NUMBER" })
.promise();
// Handle promise's fulfilled/rejected states
phonenumPromise
.then(function (data) {
console.log("Phone Opt Out is " + data.isOptedOut);
})
.catch(function (err) {
console.error(err, err.stack);
});
```
Untuk menjalankan contoh, ketik berikut ini di baris perintah.
```
node sns_checkphoneoptout.js
```
Kode contoh ini dapat ditemukan [di sini GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_checkphoneoptout.js).
## Daftar Nomor Telepon yang Dipilih Keluar
Dalam contoh ini, gunakan modul Node.js untuk mendapatkan daftar nomor telepon yang telah memilih keluar dari menerima pesan SMS. Buat modul Node.js dengan nama file`sns_listnumbersoptedout.js`. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya. Buat objek kosong sebagai parameter.
Lewati objek ke `listPhoneNumbersOptedOut` metode kelas `AWS.SNS` klien. Untuk memanggil `listPhoneNumbersOptedOut` metode ini, buat janji untuk memanggil objek layanan Amazon SNS, melewati objek parameter. Kemudian tangani callback `response` in the promise.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });
// Create promise and SNS service object
var phonelistPromise = new AWS.SNS({ apiVersion: "2010-03-31" })
.listPhoneNumbersOptedOut({})
.promise();
// Handle promise's fulfilled/rejected states
phonelistPromise
.then(function (data) {
console.log(data);
})
.catch(function (err) {
console.error(err, err.stack);
});
```
Untuk menjalankan contoh, ketik berikut ini di baris perintah.
```
node sns_listnumbersoptedout.js
```
Kode contoh ini dapat ditemukan [di sini GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_listnumbersoptedout.js).
## Menerbitkan Pesan SMS
Dalam contoh ini, gunakan modul Node.js untuk mengirim pesan SMS ke nomor telepon. Buat modul Node.js dengan nama file`sns_publishsms.js`. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya. Buat objek yang berisi `PhoneNumber` parameter `Message` dan.
Saat Anda mengirim pesan SMS, tentukan nomor telepon menggunakan format E.164. E.164 adalah standar untuk struktur nomor telepon yang digunakan untuk telekomunikasi internasional. Nomor telepon yang mengikuti format ini dapat memiliki maksimum 15 digit, dan diawali dengan karakter plus (\$1) dan kode negara. Misalnya, nomor telepon AS dalam format E.164 akan muncul sebagai \$11001. XXX5550100
Contoh ini menetapkan `PhoneNumber` parameter untuk menentukan nomor telepon untuk mengirim pesan. Lewati objek ke `publish` metode kelas `AWS.SNS` klien. Untuk memanggil `publish` metode ini, buat janji untuk memanggil objek layanan Amazon SNS, melewati objek parameter. Kemudian tangani callback `response` in the promise.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });
// Create publish parameters
var params = {
Message: "TEXT_MESSAGE" /* required */,
PhoneNumber: "E.164_PHONE_NUMBER",
};
// Create promise and SNS service object
var publishTextPromise = new AWS.SNS({ apiVersion: "2010-03-31" })
.publish(params)
.promise();
// Handle promise's fulfilled/rejected states
publishTextPromise
.then(function (data) {
console.log("MessageID is " + data.MessageId);
})
.catch(function (err) {
console.error(err, err.stack);
});
```
Untuk menjalankan contoh, ketik berikut ini di baris perintah.
```
node sns_publishsms.js
```
Kode contoh ini dapat ditemukan [di sini GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/sns/sns_publishsms.js).