AWS IoT Core AWS IoT Events AWS IoT SiteWise Amazon DynamoDB Amazon DynamoDB (v2)Amazon Data Firehose AWS Lambda Amazon Simple Notification Service Amazon Simple Queue Service

他の 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 サービスの両方 AWS IoT Events が連携するには、同じ 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許可を付与していることを確認します。詳細については、「の Identity and Access Management AWS IoT Events」を参照してください。

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

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許可を付与していることを確認します。詳細については、「の Identity and Access Management AWS IoT Events」を参照してください。

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

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 に応じ、値の型として次のいずれかを指定する必要があります。詳細については、「 AWS IoT SiteWise APIリファレンスAssetProperty」の「」を参照してください。

booleanValue: (オプション) アセットプロパティ値は、ブール値で、TRUE または FALSE である必要があります。表現を指定することもできます。表現を使用する場合、評価結果はブール値である必要があります。
doubleValue: (オプション) アセットプロパティ値はダブルです。表現を指定することもできます。表現を使用する場合、評価結果はダブルになります。
integerValue: (オプション) アセットプロパティ値は整数です。表現を指定することもできます。表現を使用する場合、評価結果は整数である必要があります。
stringValue: (オプション) アセットプロパティ値は文字列です。表現を指定することもできます。表現を使用する場合は、評価結果が文字列になる必要があります。

注記

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

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

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

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

注記

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

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

Amazon DynamoDB (v2)

DynamoDBv2 action

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

More information (2)

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

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

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

注記

詳細については、「 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 (Service)、Splunk などの宛先にリアルタイムのストリーミングデータを配信するためのフルマネージドOpenSearch サービスです。詳細については、「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許可を付与していることを確認します。詳細については、「の Identity and Access Management AWS IoT Events」を参照してください。

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

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許可を付与していることを確認します。詳細については、「の Identity and Access Management AWS IoT Events」を参照してください。

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

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許可を付与していることを確認します。詳細については、「の Identity and Access Management AWS IoT Events」を参照してください。

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

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許可を付与していることを確認します。詳細については、「の Identity and Access Management AWS IoT Events」を参照してください。

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

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

注記

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

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

組み込みアクションを使用する

表現