AWS IoT Greengrass Version 1 は 2023 年 6 月 30 日に延長ライフフェーズに参加しました。詳細については、「AWS IoT Greengrass V1 メンテナンスポリシー」を参照してください。この日以降、 AWS IoT Greengrass V1 は機能、機能強化、バグ修正、またはセキュリティパッチを提供する更新をリリースしません。で実行されるデバイスは中断 AWS IoT Greengrass V1 されず、引き続き動作し、クラウドに接続します。に移行することを強くお勧めします。 AWS IoT Greengrass Version 2これにより、重要な新機能が追加され、プラットフォーム のサポートが追加されます。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

SNS コネクタ

SNS コネクタは、Amazon SNS トピックにメッセージを発行します。これにより、ウェブサーバー、E メールアドレス、および他のメッセージサブスクライバーは Greengrass グループのイベントに応答できます。

このコネクタは、MQTT トピックに関する SNS メッセージ情報を受信し、指定された SNS トピックに送信します。オプションでカスタム Lambda 関数を使用して、メッセージをこのコネクタに発行する前にフィルタリング処理および書式設定するロジックを実装できます。

このコネクタには、次のバージョンがあります。

バージョンの変更については、「Changelog」を参照してください。

要件

このコネクタには以下の要件があります。

Version 3 - 4

• AWS IoT Greengrass Core ソフトウェア v1.9.3 以降。

• Python バージョン 3.7 または 3.8 が Core デバイスにインストールされ、PATH 環境変数に追加されている。

  注記

  Python 3.8 を使用するには、次のコマンドを実行して、Python 3.7 のデフォルトのインストールフォルダからインストール済みの Python 3.8 バイナリへのシンボリックリンクを作成します。

  sudo ln -s path-to-python-3.8/python3.8 /usr/bin/python3.7

  これにより、AWS IoT Greengrass の Python 要件を満たすようにデバイスが設定されます。

• 設定済みの SNS トピック。詳細については、Amazon Simple 通知サービス デベロッパーガイドの「Amazon SNS トピックの作成」を参照してください。

• 以下の IAM ポリシーの例に示すように、ターゲットの Amazon SNS トピックでの sns:Publish アクションを許可するように設定された Greengrass グループロール。

  {
      "Version":"2012-10-17",
      "Statement":[
          {
              "Sid":"Stmt1528133056761",
              "Action":[
                  "sns:Publish"
              ],
              "Effect":"Allow",
              "Resource":[
                  "arn:aws:sns:region:account-id:topic-name"
              ]
          }
      ]
   }

  このコネクタでは、入力メッセージペイロードのデフォルトトピックを動的に上書きできます。実装でこの機能を使用している場合、IAM ポリシーはすべてのターゲットトピックに対する sns:Publish アクセス許可を付与する必要があります。リソースにきめ細かいアクセス権限または条件付きアクセス権限を付与できます (例えば、ワイルドカード * 命名スキームを使用)。

  グループロール要件では、必要なアクセス許可を付与するようにロールを設定し、ロールがグループに追加されていることを確認する必要があります。詳細については、Greengrass グループロールの管理 (コンソール)またはGreengrass グループロールの管理 (CLI)を参照してください。

Versions 1 - 2

• AWS IoT Greengrass Core ソフトウェア v1.7 以降。

• Python バージョン 2.7 が Core デバイスにインストールされ、PATH 環境変数に追加されている。

• 設定済みの SNS トピック。詳細については、Amazon Simple 通知サービス デベロッパーガイドの「Amazon SNS トピックの作成」を参照してください。

• 以下の IAM ポリシーの例に示すように、ターゲットの Amazon SNS トピックでの sns:Publish アクションを許可するように設定された Greengrass グループロール。

  {
      "Version":"2012-10-17",
      "Statement":[
          {
              "Sid":"Stmt1528133056761",
              "Action":[
                  "sns:Publish"
              ],
              "Effect":"Allow",
              "Resource":[
                  "arn:aws:sns:region:account-id:topic-name"
              ]
          }
      ]
   }

  このコネクタでは、入力メッセージペイロードのデフォルトトピックを動的に上書きできます。実装でこの機能を使用している場合、IAM ポリシーはすべてのターゲットトピックに対する sns:Publish アクセス許可を付与する必要があります。リソースにきめ細かいアクセス権限または条件付きアクセス権限を付与できます (例えば、ワイルドカード * 命名スキームを使用)。

  グループロール要件では、必要なアクセス許可を付与するようにロールを設定し、ロールがグループに追加されていることを確認する必要があります。詳細については、Greengrass グループロールの管理 (コンソール)またはGreengrass グループロールの管理 (CLI)を参照してください。

コネクタパラメータ

このコネクタには、以下のパラメータが用意されています。

Version 4

DefaultSNSArn

メッセージを発行するデフォルト SNS トピックの ARN。ターゲットトピックは入力メッセージペイロードの sns_topic_arn プロパティによって上書きできます。

注記

グループロールは、すべてのターゲットトピックに対する sns:Publish アクセス許可を付与する必要があります。詳細については、「要件」を参照してください。

AWS IoT コンソールでの表示名: [Default SNS topic ARN] (デフォルト SNS トピック ARN)

必須: true

タイプ: string

有効なパターン: arn:aws:sns:([a-z]{2}-[a-z]+-\d{1}):(\d{12}):([a-zA-Z0-9-_]+)$

IsolationMode

このコネクタのコンテナ化モード。デフォルトは GreengrassContainer です。つまり、コネクタは AWS IoT Greengrass コンテナ内の分離されたランタイム環境で実行されます。

注記

グループの既定のコンテナ化設定は、コネクタには適用されません。

AWS IoT コンソールでの表示名: [Container isolation mode] (コンテナ分離モード)　

必須: false

タイプ: string

有効な値: GreengrassContainer または NoContainer

有効なパターン: ^NoContainer$|^GreengrassContainer$

Versions 1 - 3

DefaultSNSArn

メッセージを発行するデフォルト SNS トピックの ARN。ターゲットトピックは入力メッセージペイロードの sns_topic_arn プロパティによって上書きできます。

注記

グループロールは、すべてのターゲットトピックに対する sns:Publish アクセス許可を付与する必要があります。詳細については、「要件」を参照してください。

AWS IoT コンソールでの表示名: [Default SNS topic ARN] (デフォルト SNS トピック ARN)

必須: true

タイプ: string

有効なパターン: arn:aws:sns:([a-z]{2}-[a-z]+-\d{1}):(\d{12}):([a-zA-Z0-9-_]+)$

サンプルコネクタを作成する (AWS CLI)

以下の CLI コマンドは、SNS コネクタを含む初期バージョンで ConnectorDefinition を作成します。

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"
            }
        }
    ]
}'

AWS IoT Greengrass コンソールでは、グループの [Connectors] (コネクタ) ページからコネクタを追加できます。詳細については、「Greengrass コネクタの開始方法 (コンソール)」を参照してください。

入力データ

このコネクタは、MQTT トピックに関する SNS メッセージ情報を受け取り、その情報をそのままターゲット SNS トピックに発行します。入力メッセージは JSON 形式である必要があります。

出力データ

このコネクターは、MQTT トピックで出力データとしてステータス情報を発行します。

使用例

コネクタの試用に利用できる Python 3.7 Lambda 関数の例を設定するには、次のステップ (概要) を使用します。

例

次の例では、Lambda 関数で入力メッセージをコネクタに送信します。

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

ライセンス

SNS コネクタには、以下のサードパーティーのソフトウェアおよびライセンスが含まれています。

このコネクタは、Greengrass Core ソフトウェアライセンス契約に従ってリリースされます。

変更ログ

次の表に、コネクタの各バージョンにおける変更点を示します。

Greengrass グループには、一度に 1 つのバージョンのコネクタしか含めることができません。コネクタのバージョンのアップグレードについては、「コネクタのバージョンのアップグレード」を参照してください。

以下も参照してください。