AWS IoT Greengrass Version 1 memasuki fase umur panjang pada 30 Juni 2023. Untuk informasi selengkapnya, lihat kebijakan AWS IoT Greengrass V1 pemeliharaan. Setelah tanggal ini, tidak AWS IoT Greengrass V1 akan merilis pembaruan yang menyediakan fitur, penyempurnaan, perbaikan bug, atau patch keamanan. Perangkat yang berjalan AWS IoT Greengrass V1 tidak akan terganggu dan akan terus beroperasi dan terhubung ke cloud. Kami sangat menyarankan Anda bermigrasi ke AWS IoT Greengrass Version 2, yang menambahkan fitur baru yang signifikan dan dukungan untuk platform tambahan.

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

Konektor SNS

Sebuah konektor 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.

Untuk informasi tentang perubahan versi, lihat Changelog.

Persyaratan

Konektor ini memiliki persyaratan sebagai berikut:

Version 3 - 4

• AWS IoT Greengrass perangkat lunak Core v1.9.3 atau yang lebih baru.

• Python 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 dalam Panduan Developer Amazon Simple Notification Service.

• Pada Peran grup Greengrass dikonfigurasi untuk mengizinkan sns:Publish tindakan pada target Amazon SNSstopic, seperti yang ditunjukkan contoh kebijakan IAM berikut.

  {
      "Version":"2012-10-17",
      "Statement":[
          {
              "Sid":"Stmt1528133056761",
              "Action":[
                  "sns:Publish"
              ],
              "Effect":"Allow",
              "Resource":[
                  "arn:aws:sns:region:account-id: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) atau Mengelola peran grup Greengrass (CLI).

Versions 1 - 2

• AWS IoT Greengrass perangkat lunak Core v1.7 atau yang lebih baru.

• Python 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 dalam Panduan Developer Amazon Simple Notification Service.

• Pada Peran grup Greengrass dikonfigurasi untuk mengizinkan sns:Publish tindakan pada target Amazon SNSstopic, seperti yang ditunjukkan contoh kebijakan IAM berikut.

  {
      "Version":"2012-10-17",
      "Statement":[
          {
              "Sid":"Stmt1528133056761",
              "Action":[
                  "sns:Publish"
              ],
              "Effect":"Allow",
              "Resource":[
                  "arn:aws:sns:region:account-id: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) atau Mengelola peran grup Greengrass (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.

catatan

Peran grup harus memberikan izin sns:Publish untuk semua topik target. Untuk informasi selengkapnya, lihat Persyaratan.

Nama tampilan pada konsol AWS IoT tersebut: SNS Default ARN topik

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 untuk konektor ini. Default-nya adalah GreengrassContainer, yang berarti bahwa konektor berjalan dalam lingkungan waktu aktif terisolasi dalam kontainer AWS IoT Greengrass ini.

catatan

Pengaturan kontainerisasi default untuk grup tidak berlaku untuk konektor.

Nama tampilan pada konsol AWS IoT tersebut: 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.

catatan

Peran grup harus memberikan izin sns:Publish untuk semua topik target. Untuk informasi selengkapnya, lihat Persyaratan.

Nama tampilan pada konsol AWS IoT tersebut: SNS Default ARN topik

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 konsol AWS IoT Greengrass tersebut, Anda dapat menambahkan konektor dari halaman grup Konektor ini. Untuk informasi lebih lanjut, lihat Memulai dengan konektor Greengrass (konsol).

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.

Data output

Konektor ini menerbitkan informasi status sebagai data output pada topik MQTT.

Contoh Penggunaan

Gunakan langkah-langkah tingkat tinggi berikut untuk mengatur contoh fungsi Lambda Python 3.7 yang dapat Anda gunakan untuk mencoba konektor.

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 termasuk perangkat lunak/lisensi pihak ketiga berikut:

Konektor ini dirilis di bawah Perjanjian Lisensi Perangkat lunak core Greengrass.

Changelog

Tabel berikut menjelaskan perubahan dalam setiap versi konektor.

Sebuah grup Greengrass dapat berisi hanya satu versi konektor pada suatu waktu. Untuk informasi lebih lanjut tentang pembaruan versi konektor, lihat Versi upgrade konektor.

Lihat juga