AWS IoT Events 他の AWS サービスの使用 - AWS IoT Events
AWS IoT CoreAWS IoT EventsAWS IoT SiteWiseAmazon DynamoDBAmazon DynamoDB (v2)Amazon Data FirehoseAWS LambdaAmazon Simple Notification ServiceAmazon Simple Queue Service

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

AWS IoT Events 他の AWS サービスの使用

AWS IoT Events では、 AWS サービスで作業できる次のアクションがサポートされています。

  • iotTopicPublish MQTTトピックに関するメッセージを公開します。

  • iotEvents は、 AWS IoT Events に対してデータを入力値として送信します。

  • iotSiteWise は、 AWS IoT SiteWise中のアセットプロパティにデータを送信します。

  • dynamoDB は、Amazon DynamoDB テーブルにデータを送信します。

  • dynamoDBv2 は、Amazon DynamoDB テーブルにデータを送信します。

  • firehose Amazon Data Firehose ストリームにデータを送信するには。

  • lambda は、 AWS Lambda 関数を呼び出します。

  • sns は、データをプッシュ通知として送信します。

  • sqs Amazon SQSキューにデータを送信するには。

重要

  • AWS IoT Events と の両方のサービス AWS で同じ AWS リージョンを選択する必要があります。サポートされているリージョンのリストについては、「Amazon Web Services 全般のリファレンス」の「AWS IoT Events の エンドポイントとクォータ」を参照してください。

  • AWS IoT Events アクションに他の AWS リソースを作成するときは、同じ AWS リージョンを使用する必要があります。 AWS リージョンを切り替えると、 AWS リソースへのアクセスに問題がある可能性があります。

デフォルトでは、 は任意のアクションJSONの標準ペイロードを に AWS IoT Events 生成します。このアクションペイロードには、ディテクターモデルインスタンスと、アクションをトリガーしたイベントに関する情報を記述した、属性と値のペアがすべて含まれています。アクションペイロードを設定するには、 コンテント表現を使用します。詳細については、 AWS IoT Events APIリファレンスのイベントデータをフィルタリング、変換、処理する式「」および「ペイロードデータ型」を参照してください。

AWS IoT Core

IoT topic publish action

AWS IoT Core アクションを使用すると、MQTTメッセージブローカーを介して AWS IoT メッセージを公開できます。サポートされているリージョンのリストについては、「Amazon Web Services 全般のリファレンス」の「AWS IoT Core の エンドポイントとクォータ」を参照してください。

AWS IoT メッセージブローカーは、発行 AWS IoT クライアントからサブスクライブクライアントにメッセージを送信することでクライアントを接続します。詳細については、「 デベロッパーガイド」の「デバイス通信プロトコル」を参照してください。 AWS IoT

More information (2)

MQTT メッセージを発行するときは、次のパラメータを指定する必要があります。

mqttTopic

メッセージを受信するMQTTトピック。

ディテクターモデルで作成された変数または入力値を使用して、実行時にMQTTトピック名を動的に定義できます。

payload

(オプション) デフォルトのペイロードには、ディテクターモデルインスタンスとアクションをトリガーしたイベントに関する情報を持つすべての属性と値のペアが含まれます。ペイロードをカスタマイズすることもできます。詳細については、 AWS IoT Events APIリファレンスの「ペイロード」を参照してください。

注記

AWS IoT Events サービスロールにアタッチされたポリシーがアクセスiot:Publish許可を付与していることを確認します。詳細については、「のアイデンティティとアクセスの管理 AWS IoT Events」を参照してください。

詳細については、「 リファレンスIotTopicPublishAction」の「」を参照してください。 AWS IoT Events API

AWS IoT Events

IoT Events action

AWS IoT Events アクションを使用すると、入力 AWS IoT Events として にデータを送信できます。サポートされているリージョンのリストについては、「Amazon Web Services 全般のリファレンス」の「AWS IoT Events の エンドポイントとクォータ」を参照してください。

AWS IoT Events では、機器またはデバイスフリートの障害やオペレーションの変更をモニタリングし、そのようなイベントが発生したときにアクションをトリガーできます。詳細については、「 AWS IoT Events デベロッパーガイド」の「 とは AWS IoT Events」を参照してください。

More information (2)

にデータを送信するときは AWS IoT Events、次のパラメータを指定する必要があります。

inputName

データを受信する AWS IoT Events 入力の名前。

payload

(オプション) デフォルトのペイロードには、ディテクターモデルインスタンスとアクションをトリガーしたイベントに関する情報を持つすべての属性と値のペアが含まれます。ペイロードをカスタマイズすることもできます。詳細については、 AWS IoT Events APIリファレンスの「ペイロード」を参照してください。

注記

AWS IoT Events サービスロールにアタッチされたポリシーがアクセスiotevents:BatchPutMessage許可を付与していることを確認します。詳細については、「のアイデンティティとアクセスの管理 AWS IoT Events」を参照してください。

詳細については、「 リファレンスIotEventsAction」の「」を参照してください。 AWS IoT Events API

AWS IoT SiteWise

IoT SiteWise action

AWS IoT SiteWise アクションを使用すると、 のアセットプロパティにデータを送信できます AWS IoT SiteWise。サポートされているリージョンのリストについては、「Amazon Web Services 全般のリファレンス」の「AWS IoT SiteWise の エンドポイントとクォータ」を参照してください。

AWS IoT SiteWise は、産業機器から大規模にデータを収集、整理、分析できるマネージドサービスです。詳細については、「AWS IoT SiteWise ユーザーガイド」の「AWS IoT SiteWiseとは」を参照してください。

More information (11)

のアセットプロパティにデータを送信するときは AWS IoT SiteWise、次のパラメータを指定する必要があります。

重要

データを受信するには、 AWS IoT SiteWiseの既存のアセットプロパティを使用する必要があります。

  • AWS IoT Events コンソールを使用する場合は、 propertyAliasを指定してターゲットアセットプロパティを識別する必要があります。

  • を使用する場合は AWS CLI、ターゲットアセットプロパティを識別するpropertyIdにはassetId、 propertyAliasまたは の両方を指定する必要があります。

詳細については、「AWS IoT SiteWise ユーザーガイド」の「産業用データストリームのアセットプロパティへのマッピング」を参照してください。

propertyAlias

(オプション) アセットプロパティのエイリアス。表現を指定することもできます。

assetId

(オプション) 指定されたプロパティを持つアセットの ID。表現を指定することもできます。

propertyId

(オプション) アセットプロパティの ID。表現を指定することもできます。

entryId

(オプション) このエントリの一意な識別子。エントリ ID を使用すると、障害が発生した場合にエラーの原因となっているデータエントリを追跡できます。デフォルトは、新しい一意の識別子です。表現を指定することもできます。

propertyValue

プロパティ値の詳細を含む構造体。

quality

(オプション) アセットプロパティ値の品質。値は GOOD、BAD、または UNCERTAIN である必要があります。表現を指定することもできます。

timestamp

(オプション) タイムスタンプ情報を含む構造体。この値を指定しない場合、デフォルトはイベント時刻です。

timeInSeconds

Unix エポック形式のタイムスタンプ (秒単位)。有効な範囲は 1～31556889864403199 です。表現を指定することもできます。

offsetInNanos

(オプション) timeInSeconds から変換されたナノ秒オフセット。有効な範囲は 0～999999999 です。表現を指定することもできます。

value

アセットプロパティ値を含む構造体。

重要

指定されたアセットプロパティの dataType に応じ、値の型として次のいずれかを指定する必要があります。詳細については、「 リファレンスAssetProperty」の「」を参照してください。 AWS IoT SiteWise API

booleanValue

(オプション) アセットプロパティ値は、ブール値で、TRUE または FALSE である必要があります。表現を指定することもできます。表現を使用する場合、評価結果はブール値である必要があります。

doubleValue

(オプション) アセットプロパティ値はダブルです。表現を指定することもできます。表現を使用する場合、評価結果はダブルになります。

integerValue

(オプション) アセットプロパティ値は整数です。表現を指定することもできます。表現を使用する場合、評価結果は整数である必要があります。

stringValue

(オプション) アセットプロパティ値は文字列です。表現を指定することもできます。表現を使用する場合は、評価結果が文字列になる必要があります。

注記

AWS IoT Events サービスロールにアタッチされたポリシーがアクセスiotsitewise:BatchPutAssetPropertyValue許可を付与していることを確認します。詳細については、「のアイデンティティとアクセスの管理 AWS IoT Events」を参照してください。

詳細については、「 リファレンスIotSiteWiseAction」の「」を参照してください。 AWS IoT Events API

Amazon DynamoDB

DynamoDB action

Amazon DynamoDB アクションを使用して、DynamoDB テーブルにデータを送信することができます。DynamoDB テーブルの 1 つの列は、指定したアクションペイロード内のすべての属性と値のペアを受け取ります。サポートされているリージョンのリストについては、「Amazon Web Services 全般のリファレンス」の「Amazon DynamoDB のエンドポイントとクォータ」を参照してください。

Amazon DynamoDB は、シームレスなスケーラビリティで高速で予測可能なパフォーマンスを提供するフルマネージドの NoSQL データベースサービスです。詳細については、「Amazon DynamoDB デベロッパーガイド」の「DynamoDBとは」を参照してください。

More information (10)

DynamoDB テーブルの 1 つの列にデータを送信する場合は、次のパラメータを指定する必要があります。

tableName

データを受信する DynamoDB テーブルの名前。tableName 値は、DynamoDB テーブルのテーブル名と一致する必要があります。表現を指定することもできます。

hashKeyField

ハッシュキー (パーティションキーとも呼ばれます) の名前。hashKeyField 値は、DynamoDB テーブルのパーティションキーと一致する必要があります。表現を指定することもできます。

hashKeyType

(オプション) ハッシュキーのデータ型。ハッシュキータイプの値は STRING または NUMBER である必要があります。デフォルト: STRING。表現を指定することもできます。

hashKeyValue

ハッシュキーの値。hashKeyValue は、置換テンプレートを使用します。これらのテンプレートは、ランタイム時にデータが提供されます。表現を指定することもできます。

rangeKeyField

(オプション) 範囲キー (ソートキーとも呼ばれます) の名前。rangeKeyField 値は、DynamoDB テーブルのソートキーと一致する必要があります。表現を指定することもできます。

rangeKeyType

(オプション) 範囲キーのデータ型。ハッシュキータイプの値は STRING または NUMBER である必要があります。デフォルト: STRING。表現を指定することもできます。

rangeKeyValue

(オプション) 範囲キーの値。rangeKeyValue は、置換テンプレートを使用します。これらのテンプレートは、ランタイム時にデータが提供されます。表現を指定することもできます。

オペレーション

(オプション) 実行するオペレーションの種類。表現を指定することもできます。オペレーション値は、以下のいずれかの値である必要があります。

  • INSERT - データを新しい項目として DynamoDB テーブルに挿入します。これは、デフォルト値です。

  • UPDATE - DynamoDB テーブルの既存の項目を新しいデータで更新します。

  • DELETE - DynamoDB テーブルから既存の項目を削除します。

payloadField

(オプション) アクションペイロードを受信する DynamoDB の列の名前。デフォルト名は payload です。表現を指定することもできます。

payload

(オプション) デフォルトのペイロードには、ディテクターモデルインスタンスとアクションをトリガーしたイベントに関する情報を持つすべての属性と値のペアが含まれます。ペイロードをカスタマイズすることもできます。詳細については、 AWS IoT Events APIリファレンスの「ペイロード」を参照してください。

指定されたペイロードタイプが文字列の場合、 は非JSONデータをバイナリデータとして DynamoDB テーブルDynamoDBActionに送信します。DynamoDB コンソールは、データを Base64-encoded テキストとして表示します。payloadField 値は payload-field_raw です。表現を指定することもできます。

注記

AWS IoT Events サービスロールにアタッチされたポリシーがアクセスdynamodb:PutItem許可を付与していることを確認します。詳細については、「のアイデンティティとアクセスの管理 AWS IoT Events」を参照してください。

詳細については、 AWS IoT Events APIリファレンスの「DynamoDBAction」を参照してください。

Amazon DynamoDB (v2)

DynamoDBv2 action

Amazon DynamoDB (v2) アクションを使用して、DynamoDB テーブルにデータを書き込むことができます。DynamoDB　テーブルの別の列は、指定したアクションペイロードで 1 つの属性と値のペアを受け取ります。サポートされているリージョンのリストについては、「Amazon Web Services 全般のリファレンス」の「Amazon DynamoDB のエンドポイントとクォータ」を参照してください。

Amazon DynamoDB は、シームレスなスケーラビリティで高速で予測可能なパフォーマンスを提供するフルマネージドの NoSQL データベースサービスです。詳細については、「Amazon DynamoDB デベロッパーガイド」の「DynamoDBとは」を参照してください。

More information (2)

DynamoDB テーブルの複数の列にデータを送信する場合は、次のパラメータを指定する必要があります。

tableName

データを受信する DynamoDB テーブルの名前。表現を指定することもできます。

payload

(オプション) デフォルトのペイロードには、ディテクターモデルインスタンスとアクションをトリガーしたイベントに関する情報を持つすべての属性と値のペアが含まれます。ペイロードをカスタマイズすることもできます。詳細については、 AWS IoT Events APIリファレンスの「ペイロード」を参照してください。

重要

ペイロードタイプは である必要がありますJSON。表現を指定することもできます。

注記

AWS IoT Events サービスロールにアタッチされたポリシーがアクセスdynamodb:PutItem許可を付与していることを確認します。詳細については、「のアイデンティティとアクセスの管理 AWS IoT Events」を参照してください。

詳細については、 AWS IoT Events APIリファレンスの「DynamoDBv2Action」を参照してください。

Amazon Data Firehose

Firehose action

Amazon Data Firehose アクションを使用すると、Firehose 配信ストリームにデータを送信できます。サポートされているリージョンのリストについては、「」の「Amazon Data Firehose エンドポイントとクォータ」を参照してくださいAmazon Web Services 全般のリファレンス。

Amazon Data Firehose は、Amazon Simple Storage Service (Amazon Simple Storage Service)、Amazon Redshift、Amazon OpenSearch Service (OpenSearch Service)、Splunk などの宛先にリアルタイムのストリーミングデータを配信するためのフルマネージドサービスです。詳細については、「Amazon Data Firehose デベロッパーガイド」の「Amazon Data Firehose とは」を参照してください。

More information (3)

Firehose 配信ストリームにデータを送信するときは、次のパラメータを指定する必要があります。

deliveryStreamName

データを受信する Firehose 配信ストリームの名前。

separator

（オプション) 文字区切り記号を使用して、Firehose 配信ストリームに送信される連続データを分離できます。区切り文字の値は、'\n' (改行)、'\t' (タブ)、'\r\n' (Windows の改行)、または ',' (コンマ) である必要があります。

payload

(オプション) デフォルトのペイロードには、ディテクターモデルインスタンスとアクションをトリガーしたイベントに関する情報を持つすべての属性と値のペアが含まれます。ペイロードをカスタマイズすることもできます。詳細については、 AWS IoT Events APIリファレンスの「ペイロード」を参照してください。

注記

AWS IoT Events サービスロールにアタッチされたポリシーがアクセスfirehose:PutRecord許可を付与していることを確認します。詳細については、「のアイデンティティとアクセスの管理 AWS IoT Events」を参照してください。

詳細については、「 リファレンスFirehoseAction」の「」を参照してください。 AWS IoT Events API

AWS Lambda

Lambda action

AWS Lambda アクションを使用すると、Lambda 関数を呼び出すことができます。サポートされているリージョンのリストについては、「Amazon Web Services 全般のリファレンス」の「AWS Lambda の エンドポイントとクォータ」を参照してください。

AWS Lambda は、サーバーのプロビジョニングや管理を行わずにコードを実行できるようにするコンピューティングサービスです。詳細については、「 AWS Lambda デベロッパーガイド」の「 とは AWS Lambda」を参照してください。

More information (2)

Lambda 関数を呼び出す際に、以下のパラメータを指定する必要があります。

functionArn

呼び出す Lambda 関数ARNの 。

payload

(オプション) デフォルトのペイロードには、ディテクターモデルインスタンスとアクションをトリガーしたイベントに関する情報を持つすべての属性と値のペアが含まれます。ペイロードをカスタマイズすることもできます。詳細については、 AWS IoT Events APIリファレンスの「ペイロード」を参照してください。

注記

AWS IoT Events サービスロールにアタッチされたポリシーがアクセスlambda:InvokeFunction許可を付与していることを確認します。詳細については、「のアイデンティティとアクセスの管理 AWS IoT Events」を参照してください。

詳細については、「 リファレンスLambdaAction」の「」を参照してください。 AWS IoT Events API

Amazon Simple Notification Service

SNS action

Amazon SNSトピックの公開アクションを使用すると、Amazon SNS メッセージを公開できます。サポートされているリージョンのリストについては、「Amazon Web Services 全般のリファレンス」の「Amazon Simple Notification Service のエンドポイントとクォータ」を参照してください。

Amazon Simple Notification Service (Amazon Simple Notification Service) は、サブスクライブしているエンドポイントまたはクライアントへのメッセージの配信または送信を調整および管理するウェブサービスです。詳細については、「Amazon Simple Notification Service デベロッパーガイド」の「Amazon SNSとは」を参照してください。

注記

Amazon SNSトピック公開アクションは、Amazon SNS FIFO (先入れ先出し) トピックをサポートしていません。ルールエンジンは完全に分散されたサービスであるため、Amazon SNSアクションが開始されると、メッセージは指定された順序で表示されない場合があります。

More information (2)

Amazon SNS メッセージを公開するときは、次のパラメータを指定する必要があります。

targetArn

メッセージを受信する Amazon SNSターゲットARNの 。

payload

(オプション) デフォルトのペイロードには、ディテクターモデルインスタンスとアクションをトリガーしたイベントに関する情報を持つすべての属性と値のペアが含まれます。ペイロードをカスタマイズすることもできます。詳細については、 AWS IoT Events APIリファレンスの「ペイロード」を参照してください。

注記

AWS IoT Events サービスロールにアタッチされたポリシーがアクセスsns:Publish許可を付与していることを確認します。詳細については、「のアイデンティティとアクセスの管理 AWS IoT Events」を参照してください。

詳細については、「 リファレンスSNSTopicPublishAction」の「」を参照してください。 AWS IoT Events API

Amazon Simple Queue Service

SQS action

Amazon SQSアクションを使用すると、Amazon SQSキューにデータを送信できます。サポートされているリージョンのリストについては、「Amazon Web Services 全般のリファレンス」の「Amazon Simple Queue Service のエンドポイントとクォータ」を参照してください。

Amazon Simple Queue Service (Amazon SQS) は、安全で耐久性があり、利用可能なホストキューを提供し、分散ソフトウェアシステムとコンポーネントを統合および分離できます。詳細については、「Amazon Simple Queue Service デベロッパーガイド」の「Amazon Simple Queue Service とは」を参照してください。

注記

Amazon SQSアクションは >Amazon SQS FIFO (先入れ先出し) トピックをサポートしていません。ルールエンジンは完全に分散されたサービスであるため、Amazon SQSアクションが開始されると、メッセージは指定された順序で表示されない場合があります。

More information (3)

Amazon SQSキューにデータを送信するときは、次のパラメータを指定する必要があります。

queueUrl

データを受信する Amazon SQSキューURLの 。

useBase64

（オプション) を指定すると、データは Base64 テキストに AWS IoT Events エンコードされますTRUE。デフォルト: FALSE。

payload

(オプション) デフォルトのペイロードには、ディテクターモデルインスタンスとアクションをトリガーしたイベントに関する情報を持つすべての属性と値のペアが含まれます。ペイロードをカスタマイズすることもできます。詳細については、 AWS IoT Events APIリファレンスの「ペイロード」を参照してください。

注記

AWS IoT Events サービスロールにアタッチされたポリシーがアクセスsqs:SendMessage許可を付与していることを確認します。詳細については、「のアイデンティティとアクセスの管理 AWS IoT Events」を参照してください。

詳細については、「 リファレンスSNSTopicPublishAction」の「」を参照してください。 AWS IoT Events API

Amazon SNSと AWS IoT Core ルールエンジンを使用して関数を AWS Lambda トリガーすることもできます。これにより、Amazon Connect などの他の サービスや、企業のエンタープライズリソースプランニング (ERP) アプリケーションを使用してアクションを実行できます。

注記

データレコードの大規模なストリームをリアルタイムで収集および処理するには、Amazon Kinesisなどの他の AWS サービスを使用できます。そこから、最初の分析を完了し、結果をディテクターへの入力 AWS IoT Events として に送信できます。