Pemberitahuan akhir dukungan: Pada 7 Oktober 2026, AWS akan menghentikan dukungan untuk. AWS IoT Greengrass Version 1 Setelah 7 Oktober 2026, Anda tidak akan lagi dapat mengakses sumber daya. AWS IoT Greengrass V1 Untuk informasi lebih lanjut, silakan kunjungi [Migrasi dari AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Konektor SNS
Sebuah [konektor](connectors.md) SNS menerbitkan pesan ke topik Amazon SNS. Hal ini memungkinkan server web, alamat email, dan pelanggan pesan lainnya untuk menanggapi peristiwa dalam grup Greengrass.
Konektor ini menerima informasi pesan SNS pada topik MQTT, dan kemudian mengirim pesan ke topik SNS tertentu. Anda dapat menggunakan fungsi Lambda kustom untuk implementasi penyaringan atau format logika pada pesan sebelum mereka diterbitkan untuk konektor ini.
Konektor ini memiliki versi berikut.
| Versi | ARN |
| --- | --- |
| 4 | `arn:aws:greengrass:{{region}}::/connectors/SNS/versions/4` |
| 3 | `arn:aws:greengrass:{{region}}::/connectors/SNS/versions/3` |
| 2 | `arn:aws:greengrass:{{region}}::/connectors/SNS/versions/2` |
| 1 | `arn:aws:greengrass:{{region}}::/connectors/SNS/versions/1` |
Untuk informasi tentang perubahan versi, lihat [Changelog](#sns-connector-changelog).
## Persyaratan
Konektor ini memiliki persyaratan sebagai berikut:
------
#### [ Version 3 - 4 ]
+ AWS IoT Greengrass Perangkat lunak inti v1.9.3 atau yang lebih baru.
+ [Python](https://www.python.org/) versi 3.7 atau 3.8 diinstal pada perangkat core dan ditambahkan ke variabel lingkungan PATH.
**catatan**
Untuk menggunakan Python 3.8, jalankan perintah berikut untuk membuat link simbolik dari folder instalasi default Python 3.7 ke binari Python 3.8 yang diinstal.
```
sudo ln -s {{path-to-python-3.8}}/python3.8 /usr/bin/python3.7
```
Ini mengonfigurasi perangkat Anda untuk memenuhi persyaratan Python untuk AWS IoT Greengrass.
+ Sebuah topik SNS yang dikonfigurasi. Untuk informasi lebih lanjut, lihat [Membuat topik Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-tutorial-create-topic.html) dalam *Panduan Developer Amazon Simple Notification Service*.
+ Pada [Peran grup Greengrass](group-role.md) dikonfigurasi untuk mengizinkan `sns:Publish` tindakan pada target Amazon SNSstopic, seperti yang ditunjukkan contoh kebijakan IAM berikut.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Stmt1528133056761",
"Action": [
"sns:Publish"
],
"Effect": "Allow",
"Resource": [
"arn:aws:sns:{{us-east-1}}:{{123456789012}}:{{topic-name}}"
]
}
]
}
```
------
Konektor ini mengizinkan Anda untuk secara dinamis menimpa topik default dalam muatan pesan input. Jika implementasi Anda menggunakan fitur ini, kebijakan IAM harus mengizinkan `sns:Publish` izin pada semua topik target. Anda dapat memberikan akses terperinci atau bersyarat ke sumber daya (sebagai contoh, dengan menggunakan skema penamaan wildcard \*).
Untuk persyaratan peran grup, Anda harus mengonfigurasi peran untuk memberikan izin yang diperlukan dan memastikan peran telah ditambahkan ke grup. Untuk informasi lebih lanjut, lihat [Mengelola peran grup Greengrass (konsol)](group-role.md#manage-group-role-console) atau [Mengelola peran grup Greengrass (CLI)](group-role.md#manage-group-role-cli).
------
#### [ Versions 1 - 2 ]
+ AWS IoT Greengrass Perangkat lunak inti v1.7 atau yang lebih baru.
+ [Python](https://www.python.org/) versi 2.7 diinstal pada perangkat core dan ditambahkan ke variabel lingkungan PATH.
+ Sebuah topik SNS yang dikonfigurasi. Untuk informasi lebih lanjut, lihat [Membuat topik Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-tutorial-create-topic.html) dalam *Panduan Developer Amazon Simple Notification Service*.
+ Pada [Peran grup Greengrass](group-role.md) dikonfigurasi untuk mengizinkan `sns:Publish` tindakan pada target Amazon SNSstopic, seperti yang ditunjukkan contoh kebijakan IAM berikut.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Stmt1528133056761",
"Action": [
"sns:Publish"
],
"Effect": "Allow",
"Resource": [
"arn:aws:sns:{{us-east-1}}:{{123456789012}}:{{topic-name}}"
]
}
]
}
```
------
Konektor ini mengizinkan Anda untuk secara dinamis menimpa topik default dalam muatan pesan input. Jika implementasi Anda menggunakan fitur ini, kebijakan IAM harus mengizinkan `sns:Publish` izin pada semua topik target. Anda dapat memberikan akses terperinci atau bersyarat ke sumber daya (sebagai contoh, dengan menggunakan skema penamaan wildcard \*).
Untuk persyaratan peran grup, Anda harus mengonfigurasi peran untuk memberikan izin yang diperlukan dan memastikan peran telah ditambahkan ke grup. Untuk informasi lebih lanjut, lihat [Mengelola peran grup Greengrass (konsol)](group-role.md#manage-group-role-console) atau [Mengelola peran grup Greengrass (CLI)](group-role.md#manage-group-role-cli).
------
## Parameter Konektor
Konektor ini menyediakan parameter berikut:
------
#### [ Version 4 ]
`DefaultSNSArn`
ARN topik SNS default untuk menerbitkan pesan ke. Topik tujuan dapat ditimpa oleh properti `sns_topic_arn` dalam muatan pesan input.
Peran grup harus memberikan izin `sns:Publish` untuk semua topik target. Untuk informasi selengkapnya, lihat [Persyaratan](#sns-connector-req).
Nama tampilan di AWS IoT konsol: **ARN topik SNS default**
Wajib: `true`
Jenis: `string`
Pola yang valid: `arn:aws:sns:([a-z]{2}-[a-z]+-\d{1}):(\d{12}):([a-zA-Z0-9-_]+)$`
`IsolationMode`
Mode [kontainerisasi](connectors.md#connector-containerization) untuk konektor ini. Defaultnya adalah`GreengrassContainer`, yang berarti konektor berjalan di lingkungan runtime yang terisolasi di dalam AWS IoT Greengrass container.
Pengaturan kontainerisasi default untuk grup tidak berlaku untuk konektor.
Nama tampilan di AWS IoT konsol: **Mode isolasi kontainer**
Wajib: `false`
Jenis: `string`
Nilai yang valid: `GreengrassContainer` or `NoContainer`
Pola yang valid: `^NoContainer$|^GreengrassContainer$`
------
#### [ Versions 1 - 3 ]
`DefaultSNSArn`
ARN topik SNS default untuk menerbitkan pesan ke. Topik tujuan dapat ditimpa oleh properti `sns_topic_arn` dalam muatan pesan input.
Peran grup harus memberikan izin `sns:Publish` untuk semua topik target. Untuk informasi selengkapnya, lihat [Persyaratan](#sns-connector-req).
Nama tampilan di AWS IoT konsol: **ARN topik SNS default**
Wajib: `true`
Jenis: `string`
Pola yang valid: `arn:aws:sns:([a-z]{2}-[a-z]+-\d{1}):(\d{12}):([a-zA-Z0-9-_]+)$`
------
### Buat Contoh Konektor (AWS CLI)
Perintah CLI berikut membuat `ConnectorDefinition` dengan versi awal yang berisi konektor SNS.
```
aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{
"Connectors": [
{
"Id": "MySNSConnector",
"ConnectorArn": "arn:aws:greengrass:{{region}}::/connectors/SNS/versions/4",
"Parameters": {
"DefaultSNSArn": "arn:aws:sns:{{region}}:{{account-id}}:topic-name",
"IsolationMode" : "GreengrassContainer"
}
}
]
}'
```
Di AWS IoT Greengrass konsol, Anda dapat menambahkan konektor dari halaman **Konektor** grup. Untuk informasi selengkapnya, lihat [Memulai dengan konektor Greengrass (konsol)](connectors-console.md).
## Data input
Konektor ini menerima informasi pesan SNS pada topik MQTT, dan kemudian menerbitkan pesan ke topik target SNS. Pesan input harus dalam format JSON.
**Filter topik dalam langganan**
`sns/message`
**Properti pesan**
`request`
Informasi tentang pesan yang akan dikirim ke topik SNS.
Wajib: `true`
Jenis: `object` yang mencakup properti berikut:
`message`
Isi pesan sebagai string atau dalam format JSON. Sebagai contoh, lihat [Contoh input](#sns-connector-data-input-example).
Untuk mengirim JSON, `message_structure` properti harus diatur ke `json` dan pesan harus berupa objek JSON string-encoded yang berisi `default` kunci.
Wajib: `true`
Jenis: `string`
Pola yang valid: `.*`
`subject`
Subjek pesan.
Wajib: `false`
Jenis: teks ASCII, hingga 100 karakter. Ini harus dimulai dengan tanda huruf, angka, atau tanda baca. Ini tidak harus mencakup jeda baris atau karakter kontrol.
Pola yang valid: `.*`
`sns_topic_arn`
ARN topik SNS untuk menerbitkan pesan ke. Jika ditentukan, konektor menerbitkan topik ini menggantikan topik default.
Peran grup harus memberikan izin `sns:Publish` untuk setiap topik target. Untuk informasi selengkapnya, lihat [Persyaratan](#sns-connector-req).
Wajib: `false`
Jenis: `string`
Pola yang valid: `arn:aws:sns:([a-z]{2}-[a-z]+-\d{1}):(\d{12}):([a-zA-Z0-9-_]+)$`
`message_structure`
Struktur pesan.
Diperlukan:`false`. Ini harus ditentukan untuk mengirim pesan JSON.
Tipe: `string`
Nilai yang valid: `json`
`id`
ID arbitrer untuk permintaan. Properti ini digunakan untuk memetakan permintaan input untuk respons output. Ketika ditentukan, `id` properti dalam objek respon diatur ke nilai ini. Jika Anda tidak menggunakan fitur ini, Anda dapat menghilangkan properti ini atau menentukan string kosong.
Wajib: `false`
Jenis: `string`
Pola yang valid: `.*`
**Batas**
Ukuran pesan dibatasi oleh ukuran maksimum pesan SNS 256 KB.
**Contoh masukan: Pesan string**
Contoh ini mengirimkan pesan string. Ini menentukan properti `sns_topic_arn` opsional, yang menimpa topik tujuan default.
```
{
"request": {
"subject": "Message subject",
"message": "Message data",
"sns_topic_arn": "arn:aws:sns:{{region}}:{{account-id}}:topic2-name"
},
"id": "request123"
}
```
**Contoh masukan: pesan JSON**
Contoh ini mengirimkan pesan sebagai string dikodekan objek JSON yang mencakup `default` kunci.
```
{
"request": {
"subject": "Message subject",
"message": "{ \"default\": \"Message data\" }",
"message_structure": "json"
},
"id": "request123"
}
```
## Data output
Konektor ini menerbitkan informasi status sebagai data output pada topik MQTT.
**Filter topik dalam langganan**
`sns/message/status`
**Contoh keluaran: Sukses**
```
{
"response": {
"sns_message_id": "f80a81bc-f44c-56f2-a0f0-d5af6a727c8a",
"status": "success"
},
"id": "request123"
}
```
**Contoh keluaran: Kegagalan**
```
{
"response" : {
"error": "InvalidInputException",
"error_message": "SNS Topic Arn is invalid",
"status": "fail"
},
"id": "request123"
}
```
## Contoh Penggunaan
Gunakan langkah-langkah tingkat tinggi berikut untuk mengatur contoh fungsi Lambda Python 3.7 yang dapat Anda gunakan untuk mencoba konektor.
**catatan**
Jika Anda menggunakan runtime Python lainnya, Anda dapat membuat symlink dari ke Python3.x Python 3.7.
Topik [Memulai dengan konektor (konsol)](connectors-console.md) dan [Memulai dengan konektor (CLI)](connectors-cli.md) berisi langkah-langkah terperinci yang menunjukkan cara mengonfigurasi dan men-deploy contoh konektor Notifikasi Twilio.
1. Pastikan Anda memenuhi [persyaratan](#sns-connector-req) untuk konektor.
Untuk persyaratan peran grup, Anda harus mengonfigurasi peran untuk memberikan izin yang diperlukan dan memastikan peran telah ditambahkan ke grup. Untuk informasi lebih lanjut, lihat [Mengelola peran grup Greengrass (konsol)](group-role.md#manage-group-role-console) atau [Mengelola peran grup Greengrass (CLI)](group-role.md#manage-group-role-cli).
1. Buat dan terbitkan fungsi Lambda yang mengirimkan data input ke konektor.
Simpan [kode contoh](#sns-connector-usage-example) sebagai file PY. Unduh dan unzip [AWS IoT Greengrass Core SDK for Python](lambda-functions.md#lambda-sdks-core). Kemudian, buat paket zip yang berisi file PY dan folder `greengrasssdk` dalam tingkat root. Paket zip ini adalah paket deployment yang Anda unggah ke AWS Lambda.
Setelah Anda membuat fungsi Lambda Python 3.7, terbitkankan versi fungsi dan buat alias.
1. Konfigurasikan grup Greengrass Anda.
1. Tambahkan fungsi Lambda dengan aliasnya (direkomendasikan). Konfigurasikan siklus hidup Lambda sebagai berumur panjang (atau `"Pinned": true` dalam CLI).
1. Tambahkan konektor dan konfigurasikan [parameter](#sns-connector-param).
1. Tambahkan langganan yang mengizinkan konektor untuk menerima [data input](#sns-connector-data-input) dan mengirim [data output](#sns-connector-data-output) pada filter topik yang didukung.
+ Atur fungsi Lambda sebagai sumber, konektor sebagai target, dan gunakan filter topik input yang mendukung.
+ Atur konektor sebagai sumber, AWS IoT Core sebagai target, dan gunakan filter topik input yang mendukung. Anda menggunakan langganan ini untuk melihat pesan status di AWS IoT konsol.
1. Men-deploy grup.
1. Di AWS IoT konsol, pada halaman **Uji**, berlangganan topik data keluaran untuk melihat pesan status dari konektor. Contoh fungsi Lambda yang berumur panjang dan mulai mengirim pesan segera setelah grup dalam-deploy.
Setelah selesai pengujian, Anda dapat mengatur siklus hidup Lambda ke sesuai permintaan (atau `"Pinned": false` dalam CLI) dan men-deploy grup. Ini menghentikan fungsi dari mengirim pesan.
### Contoh
Contoh fungsi Lambda berikut mengirimkan pesan input ke konektor.
```
import greengrasssdk
import time
import json
iot_client = greengrasssdk.client('iot-data')
send_topic = 'sns/message'
def create_request_with_all_fields():
return {
"request": {
"message": "Message from SNS Connector Test"
},
"id" : "req_123"
}
def publish_basic_message():
messageToPublish = create_request_with_all_fields()
print("Message To Publish: ", messageToPublish)
iot_client.publish(topic=send_topic,
payload=json.dumps(messageToPublish))
publish_basic_message()
def lambda_handler(event, context):
return
```
## Lisensi
Konektor SNS mencakup pihak ketiga software/licensing berikut:
+ [AWS SDK untuk Python (Boto3)](https://pypi.org/project/boto3/)/Apache License 2.0
+ [botocore](https://pypi.org/project/botocore/)/Apache License 2.0
+ [dateutil](https://pypi.org/project/python-dateutil/1.4/)/PSF License
+ [docutils](https://pypi.org/project/docutils/)/BSD License, Lisensi Publik Umum (GPL) GNU, Lisensi Dasar Perangkat Lunak Python, Domain Publik
+ [jmespath](https://pypi.org/project/jmespath/)/MIT License
+ [s3transfer](https://pypi.org/project/s3transfer/)/Apache License 2.0
+ [urllib3](https://pypi.org/project/urllib3/)/Lisensi MIT
Konektor ini dirilis di bawah [Perjanjian Lisensi Perangkat lunak core Greengrass](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).
## Changelog
Tabel berikut menjelaskan perubahan dalam setiap versi konektor.
| Versi | Perubahan |
| --- | --- |
| 4 | Ditambahkan parameter `IsolationMode` untuk mengonfigurasi mode kontainerisasi untuk konektor. |
| 3 | Memperbarui waktu aktif Lambda untuk Python 3.7, yang mengubah persyaratan waktu aktif. |
| 2 | Perbaiki untuk mengurangi pencatatan berlebihan. |
| 1 | Pelepasan awal. |
Sebuah grup Greengrass dapat berisi hanya satu versi konektor pada suatu waktu. Untuk informasi lebih lanjut tentang pembaruan versi konektor, lihat [Versi upgrade konektor](connectors.md#upgrade-connector-versions).
## Lihat juga
+ [Integrasikan dengan layanan dan protokol menggunakan konektor Greengrass](connectors.md)
+ [Memulai dengan konektor Greengrass (konsol)](connectors-console.md)
+ [Memulai dengan konektor Greengrass (CLI)](connectors-cli.md)
+ [ Terbitkan tindakan](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sns.html#SNS.Client.publish) dalam dokumentasi Boto 3
+ [Apakah Amazon Simple Notification Service?](https://docs.aws.amazon.com/sns/latest/dg/welcome.html) dalam *Panduan Developer Amazon Simple Notification Service*