翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
他の 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
-
(オプション) デフォルトのペイロードには、ディテクターモデルインスタンスとアクションをトリガーしたイベントに関する情報を持つすべての属性と値のペアが含まれます。ペイロードをカスタマイズすることもできます。詳細については、「 AWS IoT Events APIリファレンス」の「ペイロード」を参照してください。
指定されたペイロードタイプが文字列の場合、 は非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 のエンドポイントとクォータ」を参照してください。
Amazon DynamoDB はフルマネージド型の NoSQL データベースサービスで、高速で予測可能なパフォーマンスとシームレスなスケーラビリティを提供します。詳細については、「Amazon DynamoDB デベロッパーガイド」の「DynamoDBとは」を参照してください。
- More information (2)
-
DynamoDB テーブルの複数の列にデータを送信する場合は、次のパラメータを指定する必要があります。
tableName
-
データを受信する DynamoDB テーブルの名前。表現を指定することもできます。
payload
-
(オプション) デフォルトのペイロードには、ディテクターモデルインスタンスとアクションをトリガーしたイベントに関する情報を持つすべての属性と値のペアが含まれます。ペイロードをカスタマイズすることもできます。詳細については、「 AWS IoT Events APIリファレンス」の「ペイロード」を参照してください。
重要
ペイロードタイプは である必要がありますJSON。表現を指定することもできます。
注記
AWS IoT Events サービスロールにアタッチされたポリシーが アクセス
dynamodb:PutItem
許可を付与していることを確認します。詳細については、「の Identity and Access Management 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 (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 として に送信できます。