

サポート終了通知: 2026 年 5 月 20 日、 AWS は のサポートを終了します AWS IoT Events。2026 年 5 月 20 日以降、 AWS IoT Events コンソールまたは AWS IoT Events リソースにアクセスできなくなります。詳細については、[AWS IoT Events 「サポート終了](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html)」を参照してください。

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

# CLI を使用して 2 つの状態の AWS IoT Events ディテクターを作成する
<a name="iotevents-simple-example"></a>

この例では、 AWS CLI コマンドを使用して AWS IoT Events APIs を呼び出し、通常の状態と過圧状態の 2 つのエンジンの状態をモデル化するディテクターを作成します。

エンジン内の測定された圧力が特定のしきい値を超えると、モデルは過圧状態に移行し、Amazon Simple Notification Service (Amazon SNS) メッセージを送信して、技術者にその状態を警告します。圧力が 3 回連続して圧力測定値のしきい値を下回ると、モデルは通常の状態に戻り、状態がクリアされたことを確認するために別の Amazon SNS メッセージを送信します。非線形回復フェーズまたは 1 回限りの異常な回復読み取りの場合に、過圧/正常メッセージの吃音の可能性を排除するために、圧力しきい値を下回る 3 つの連続した読み取りが必要です。

以下は、ディテクターを作成するステップの概要です。

***入力*の作成。**  
デバイスとプロセスをモニタリングするには、テレメトリデータを AWS IoT Eventsに取り込む方法が必要です。これは、*入力*としてメッセージを送信することによって行われます AWS IoT Events。これはいくつかの方法で行うことができます。  
+ [ BatchPutMessage](https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchPutMessage.html)オペレーションを使用します。この方法は簡単ですが、デバイスまたはプロセスが SDK または を介して AWS IoT Events API にアクセスできる必要があります AWS CLI。
+ で AWS IoT Core、メッセージデータを転送するルールエンジンの[AWS IoT Events アクション](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rule-actions.html#iotevents-rule) AWS IoT Core ルールを作成します AWS IoT Events。これは、入力を名前で識別します。デバイスまたはプロセスがメッセージを送信できる場合、または既に送信している場合は、この方法を使用します AWS IoT Core。この方法では、通常、デバイスからの処理能力が少なくて済みます。
+ で AWS IoT Analytics、[CreateDataset](https://docs.aws.amazon.com/iotanalytics/latest/userguide/automate.html#aws-iot-analytics-automate-create-dataset) オペレーションを使用して、データセットの内容が自動的に送信される AWS IoT Events 入力`contentDeliveryRules`を指定するデータセットを で作成します。 AWS IoT Analyticsで集約または分析されたデータに基づいてデバイスまたはプロセスを制御する場合は、この方法を使用します。
デバイスがこの方法でデータを送信する前に、1 つ以上の入力を定義する必要があります。これを行うには、各入力に名前を付け、入力がモニタリングする着信メッセージデータのフィールドを指定します。

**ディテクターモデルを作成する**  
*状態*を使用して*ディテクターモデル* (機器またはプロセスのモデル) を作成します。状態ごとに、重要なイベントを検出するために着信入力を評価する条件付き (ブール) ロジックを定義します。イベントが検出されると、 状態を変更したり、他の AWS サービスを使用してカスタムビルドまたは事前定義されたアクションを開始したりできます。状態に入るときまたは状態を出るとき、およびオプションで条件が満たされたときにアクションを開始する追加のイベントを定義できます。

**複数のデバイスまたはプロセスをモニタリングする**  
複数のデバイスまたはプロセスをモニタリングしていて、それぞれを個別に追跡する場合は、入力元の特定のデバイスまたはプロセスを識別するフィールドを各入力に指定します。`CreateDetectorModel` の `key` フィールドを参照してください。新しいデバイスが識別されると (`key`によって識別される入力フィールドに新しい値が表示されます)、ディテクターインスタンスが作成されます。新しいディテクターインスタンスは、ディテクターモデルが更新または削除されるまで、その特定のデバイスからの入力に応答し続けます。入力 `key` フィールドに一意の値があるのと同じ数の一意のディテクター (インスタンス) があります。

**単一のデバイスまたはプロセスをモニタリングする**  
単一のプロセスをモニタリングしている場合 (複数のデバイスまたはサブプロセスが入力を送信している場合でも)、一意の識別 `key` フィールドを指定しません。この場合、最初の入力が到着したときに単一のディテクター (インスタンス) が作成されます。例えば、家の各部屋に温度センサーがあり、家全体を暖房または冷房するための HVAC 単位は 1 つだけである場合があります。したがって、各部屋の居住者が自分の投票 (入力) を優先することを望んでいる場合でも、これを単一のプロセスとしてのみ制御できます。

**デバイスまたはプロセスからのメッセージをディテクターモデルへの入力として送信します**  
デバイスまたはプロセスから入力内の AWS IoT Events ディテクターへの入力としてメッセージを送信するいくつかの方法について説明しました**。入力を作成してディテクターモデルを構築したら、データの送信をスタートする準備が整います。  
ディテクターモデルを作成する場合、または既存のモデルを更新する場合、新しいディテクターモデルまたは更新されたディテクターモデルがメッセージの受信とディテクター (インスタンス) の作成を開始するまでに数分かかります。ディテクターモデルが更新された場合、この間、以前のバージョンに基づく動作が引き続き表示される可能性があります。

**Topics**
+ [デバイスデータをキャプチャする AWS IoT Events 入力を作成する](iotevents-create-input.md)
+ [でデバイスの状態を表すディテクターモデルを作成する AWS IoT Events](iotevents-create-detector.md)
+ [でディテクターへの入力としてメッセージを送信する AWS IoT Events](iotevents-batch-put-messages.md)